Authorization

NRouterApiKey

AuthorizationBearer <token>

Your nRouter virtual key (sk-nrouter-…). Sent as Authorization: Bearer sk-nrouter-….

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Model id (see GET /v1/models).

messages*array<>

temperature?number

Range0 <= value <= 2

Default1

max_tokens?integer

Range1 <= value

n?integer

Range1 <= value

Default1

stream?boolean

Defaultfalse

nrouter_cache?boolean

Use nRouter's tenant-isolated response cache for buffered text requests. Set false to force provider egress; streams are never cached.

Defaulttrue

nrouter_prompt_template_id?string

Tenant-scoped managed prompt template. The gateway selects its production-pinned version, or the active version when no pin exists.

Formatuuid

nrouter_prompt_variables?

Scalar variables rendered into the managed prompt. Authenticated system variables override conflicting caller values.

response_format?

e.g. { "type": "json_object" } for JSON mode.

tools?array<>

Function/tool definitions for tool calling.

tool_choice?unknown

auto | none | required, or a specific tool.

Response Body

`application/json`

curl -X POST "https://example.com/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "messages": [      {        "role": "system",        "content": "string"      }    ]  }'

{  "id": "chatcmpl-abc123",  "object": "chat.completion",  "model": "gpt-4o",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "Hello!"      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 9,    "completion_tokens": 2,    "total_tokens": 11  }}

Create a chat completion (streaming or not).

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

405application/json

413application/json

415application/json

429application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`