Saltar al contenido principal
POST
/
chat
/
completions
curl --request POST \
  --url https://api.orcarouter.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "Say hi in one word."
    }
  ],
  "max_tokens": 10
}
'
{
  "id": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "content": "<string>",
        "name": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}

Autorizaciones

​
Authorization
string
header
requerido

Las claves API de OrcaRouter se ven como sk-orca-.... Pásalas en la cabecera Authorization: Bearer sk-orca-....

Cuerpo

application/json
​
model
string
requerido

ID del modelo. Soporta tres formas:

  • Con prefijo de proveedor (por defecto): openai/gpt-4o-mini, anthropic/claude-sonnet-4.6, google/gemini-2.5-flash
  • Alias plano: gpt-4o-mini (cuando un alias de nombre desnudo está disponible)
  • Enrutador nombrado: orcarouter/{name} (se resuelve a un modelo en el momento de la solicitud; orcarouter/auto se siembra al registrarse para cada cuenta y elige el modelo chat en vivo más barato)
Ejemplos:

"gpt-4o"

"openai/gpt-4o"

"orcarouter/auto"

​
messages
object[]
requerido
​
stream
boolean

Cuando es verdadero, la respuesta se transmite como server-sent events.

​
stream_options
object

Solo se aplica cuando stream: true.

​
tools
object[]
​
tool_choice
Opciones disponibles:
auto,
none,
required
​
parallel_tool_calls
boolean
predeterminado:true
​
response_format
Text (default) · object
​
temperature
number
Rango requerido: 0 <= x <= 2
​
top_p
number
Rango requerido: 0 <= x <= 1
​
max_tokens
integer
Rango requerido: x >= 1
​
max_completion_tokens
integer

Preferido sobre max_tokens para modelos de razonamiento.

​
n
integer
predeterminado:1
Rango requerido: x >= 1
​
stop
​
seed
integer

Para muestreo determinista.

​
logprobs
boolean
​
top_logprobs
integer
Rango requerido: 0 <= x <= 20
​
presence_penalty
number
Rango requerido: -2 <= x <= 2
​
frequency_penalty
number
Rango requerido: -2 <= x <= 2
​
logit_bias
object
​
user
string
​
reasoning_effort
enum<string>

Para modelos de razonamiento OpenAI (o1, o3*, o4*, gpt-5*-pro, etc.). Anthropic Claude usa el campo thinking en su lugar; Gemini usa configuración específica del proveedor.

Opciones disponibles:
low,
medium,
high
​
web_search_options
object

Habilita la búsqueda web en una solicitud Chat Completions. La API Responses usa tools: [{"type": "web_search"}] en su lugar. Honrado por modelos search-preview de OpenAI, modelos OpenAI que aceptan la herramienta moderna web_search y modelos Anthropic (traducidos a la herramienta de servidor nativa web_search de Anthropic).

​
web_search
any

Carga útil cruda de forma libre reenviada a la herramienta de búsqueda web del upstream cuando web_search_options no es lo suficientemente expresivo. La mayoría de los usuarios deberían preferir web_search_options.

​
extra_body
object

Extensiones de solicitud específicas de OrcaRouter. Colócalas bajo la clave extra_body de nivel superior de tu solicitud chat completion.

Respuesta

Completion exitosa. Las respuestas streaming usan SSE (text/event-stream).

​
id
string
​
object
enum<string>
Opciones disponibles:
chat.completion
​
created
integer
​
model
string
​
choices
object[]
​
usage
object