Chuyển đến nội dung chính
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
  }
}

Ủy quyền

​
Authorization
string
header
bắt buộc

Khóa API của OrcaRouter có dạng sk-orca-.... Truyền chúng trong header Authorization: Bearer sk-orca-....

Nội dung

application/json
​
model
string
bắt buộc

ID mô hình. Hỗ trợ ba dạng:

  • Có tiền tố nhà cung cấp (mặc định): openai/gpt-4o-mini, anthropic/claude-sonnet-4.6, google/gemini-2.5-flash
  • Bí danh trần: gpt-4o-mini (khi có bí danh tên trần)
  • Router có tên: orcarouter/{name} (giải thành một mô hình tại thời điểm yêu cầu; orcarouter/auto được seed sẵn khi đăng ký cho mọi tài khoản và chọn mô hình chat đang hoạt động rẻ nhất)
Ví dụ:

"gpt-4o"

"openai/gpt-4o"

"orcarouter/auto"

​
messages
object[]
bắt buộc
​
stream
boolean

Khi true, phản hồi được stream dưới dạng server-sent events.

​
stream_options
object

Chỉ áp dụng khi stream: true.

​
tools
object[]
​
tool_choice
Tùy chọn có sẵn:
auto,
none,
required
​
parallel_tool_calls
boolean
mặc định:true
​
response_format
Text (mặc định) · object
​
temperature
number
Phạm vi bắt buộc: 0 <= x <= 2
​
top_p
number
Phạm vi bắt buộc: 0 <= x <= 1
​
max_tokens
integer
Phạm vi bắt buộc: x >= 1
​
max_completion_tokens
integer

Được ưu tiên hơn max_tokens cho các mô hình suy luận.

​
n
integer
mặc định:1
Phạm vi bắt buộc: x >= 1
​
stop
​
seed
integer

Cho lấy mẫu xác định.

​
logprobs
boolean
​
top_logprobs
integer
Phạm vi bắt buộc: 0 <= x <= 20
​
presence_penalty
number
Phạm vi bắt buộc: -2 <= x <= 2
​
frequency_penalty
number
Phạm vi bắt buộc: -2 <= x <= 2
​
logit_bias
object
​
user
string
​
reasoning_effort
enum<string>

Cho các mô hình suy luận của OpenAI (o1, o3*, o4*, gpt-5*-pro, v.v.). Anthropic Claude dùng trường thinking thay thế; Gemini dùng cấu hình riêng của nhà cung cấp.

Tùy chọn có sẵn:
low,
medium,
high
​
web_search_options
object

Bật tìm kiếm web trên một yêu cầu Chat Completions. Responses API thay vào đó dùng tools: [{"type": "web_search"}]. Được tôn trọng bởi các mô hình search-preview của OpenAI, các mô hình OpenAI chấp nhận công cụ web_search hiện đại, và các mô hình Anthropic (được dịch thành server-tool web_search bản địa của Anthropic).

​
web_search
any

Payload thô tự do được chuyển tiếp đến công cụ web-search của upstream khi web_search_options không đủ biểu đạt. Hầu hết người dùng nên ưu tiên web_search_options.

​
extra_body
object

Các tiện ích mở rộng yêu cầu riêng của OrcaRouter. Đặt chúng dưới khóa cấp cao nhất extra_body của yêu cầu chat completion.

Phản hồi

Hoàn thành thành công. Phản hồi streaming dùng SSE (text/event-stream).

​
id
string
​
object
enum<string>
Tùy chọn có sẵn:
chat.completion
​
created
integer
​
model
string
​
choices
object[]
​
usage
object