Перейти к основному содержанию
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
  }
}

Авторизации

​
Authorization
string
header
обязательно

API-ключи OrcaRouter выглядят как sk-orca-.... Передавайте их в заголовке Authorization: Bearer sk-orca-....

Тело

application/json
​
model
string
обязательно

ID модели. Поддерживает три формы:

  • С префиксом провайдера (по умолчанию): openai/gpt-4o-mini, anthropic/claude-sonnet-4.6, google/gemini-2.5-flash
  • Простой алиас: gpt-4o-mini (когда доступен алиас без префикса)
  • Именованный маршрутизатор: orcarouter/{name} (разрешается в модель во время запроса; orcarouter/auto подключается при регистрации для каждого аккаунта и выбирает самую дешёвую активную чат-модель)
Примеры:

"gpt-4o"

"openai/gpt-4o"

"orcarouter/auto"

​
messages
object[]
обязательно
​
stream
boolean

Когда true, ответ передаётся потоком как server-sent events.

​
stream_options
object

Применяется только при stream: true.

​
tools
object[]
​
tool_choice
Доступные опции:
auto,
none,
required
​
parallel_tool_calls
boolean
по умолчанию:true
​
response_format
Text (default) · object
​
temperature
number
Требуемый диапазон: 0 <= x <= 2
​
top_p
number
Требуемый диапазон: 0 <= x <= 1
​
max_tokens
integer
Требуемый диапазон: x >= 1
​
max_completion_tokens
integer

Предпочтительнее, чем max_tokens, для моделей рассуждений.

​
n
integer
по умолчанию:1
Требуемый диапазон: x >= 1
​
stop
​
seed
integer

Для детерминированной выборки.

​
logprobs
boolean
​
top_logprobs
integer
Требуемый диапазон: 0 <= x <= 20
​
presence_penalty
number
Требуемый диапазон: -2 <= x <= 2
​
frequency_penalty
number
Требуемый диапазон: -2 <= x <= 2
​
logit_bias
object
​
user
string
​
reasoning_effort
enum<string>

Для моделей рассуждений OpenAI (o1, o3*, o4*, gpt-5*-pro и т.д.). Anthropic Claude использует вместо этого поле thinking; Gemini использует конфигурацию, специфичную для провайдера.

Доступные опции:
low,
medium,
high
​
web_search_options
object

Включает веб-поиск в запросе Chat Completions. Responses API использует вместо этого tools: [{"type": "web_search"}]. Поддерживается моделями OpenAI search-preview, моделями OpenAI, принимающими современный инструмент web_search, и моделями Anthropic (транслируется в нативный серверный инструмент web_search от Anthropic).

​
web_search
any

Свободная сырая полезная нагрузка, пересылаемая в инструмент веб-поиска провайдера, когда web_search_options недостаточно выразителен. Большинству пользователей следует предпочитать web_search_options.

​
extra_body
object

Специфичные для OrcaRouter расширения запроса. Размещайте их под верхнеуровневым ключом extra_body вашего запроса завершения чата.

Ответ

Успешное завершение. Потоковые ответы используют SSE (text/event-stream).

​
id
string
​
object
enum<string>
Доступные опции:
chat.completion
​
created
integer
​
model
string
​
choices
object[]
​
usage
object