メインコンテンツへスキップ
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
必須

OrcaRouter API キーは sk-orca-... のような形式です。 Authorization: Bearer sk-orca-... ヘッダで渡してください。

ボディ

application/json
​
model
string
必須

モデル ID。3 つの形式をサポート:

  • プロバイダプレフィックス付き (既定): 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 検索プレビューモデル、現代の web_search ツールを 受け付ける OpenAI モデル、Anthropic モデル (Anthropic ネイティブの web_search サーバツールに変換) が認識する。

​
web_search
any

web_search_options が十分に表現的でないときに、上流の web-search ツールに転送される自由形式の生ペイロード。 ほとんどのユーザーは 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