Router One
Router One

Create Response

Create an OpenAI Responses API compatible request. Use this for OpenAI-compatible clients that call the Responses API shape; text input, instructions, and streaming are supported.

POST
/v1/responses

Authorization

AuthorizationBearer <token>

Authenticate with your API Key. Get your API Key in the Router One console; the format is sk-xxx.

In: header

Request Body

modelstring

Model ID. Set to auto for Router One routing.

inputstring|
instructions?string

Optional system instructions.

stream?boolean

Whether to enable streaming response.

Defaultfalse
temperature?number

Sampling temperature, range 0-2.

Default1
Range0 <= value <= 2
max_output_tokens?integer

Maximum number of output tokens.

Range1 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.router.one/v1/responses" \  -H "Content-Type: application/json" \  -d '{    "model": "auto",    "input": "Introduce Router One in one sentence"  }'
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1700000000,
  "status": "completed",
  "model": "gpt-4o",
  "output_text": "Router One is a unified LLM API gateway.",
  "output": [
    {
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Router One is a unified LLM API gateway."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 10,
    "total_tokens": 22
  }
}
{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
{
  "error": {
    "message": "Insufficient balance",
    "type": "billing_error",
    "code": "insufficient_balance"
  }
}
{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}
{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string"
  }
}