メインコンテンツへスキップ
Endpoint: POST /chat/completions 多くの統合はこのエンドポイントから始めます。model と messages を送ると、OpenAI 互換の completion が返ります。ビジョン対応モデルでは messages[].content に画像入力も渡せます。

​
リクエスト例

curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'

​
OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YOUROUTER_API_KEY"],
    base_url="https://api.yourouter.ai/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)

print(completion.choices[0].message.content)

​
ヘッダー

Header必須説明
AuthorizationはいBearer <YOUROUTER_API_KEY>
Content-Typeはいapplication/json
vendorいいえ自動ルーティングには auto を指定するか省略します。openai、anthropic、google などの値でプロバイダーを固定できます。

​
ボディパラメータ

​
model
string
必須
呼び出すモデル ID（例: gpt-4o, claude-sonnet-4-20250514, gemini-2.5-flash）。
​
messages
array
必須
順序付きの会話メッセージ配列です。各メッセージには role と content を含めます。
​
stream
boolean
デフォルト:"false"
true の場合、Server-Sent Events の増分 chunk としてレスポンスを返します。
​
temperature
number
モデルが対応する場合のサンプリング温度。
​
max_tokens
integer
モデルが対応する場合の出力上限。
​
tools
array
関数呼び出しまたは tool use に対応するモデルへ渡すツール定義です。

​
マルチモーダル（画像入力）

ビジョン対応モデルでは、content をブロック配列として送ります。指示には text ブロックを使い、画像には image_url ブロックを使います。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Describe this image in one sentence."
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'
非公開画像は base64 data URL: 
{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,<BASE64_IMAGE>"
  }
}

​
PDF ファイル入力

対象モデルと上流プロバイダーが OpenAI 互換のファイルコンテンツブロックに対応している場合、messages[].content に PDF を渡せます。file_data には PDF の生バイト列を base64 エンコードした値を入れます。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "file",
            "file": {
              "filename": "document.pdf",
              "file_data": "<BASE64_PDF>"
            }
          },
          {
            "type": "text",
            "text": "Extract a summary and key conclusions from this PDF."
          }
        ]
      }
    ]
  }'
PDF 入力はすべてのモデルで使えるわけではありません。Gemini 原生または Claude 原生の PDF 動作が必要な場合は、マルチモーダルガイド の provider-native 例を参照してください。
Gemini ネイティブ形式や Claude ネイティブ形式を含む追加例は、マルチモーダルガイド を参照してください。

​
レスポンス

成功時は OpenAI Chat Completions 形式です。 
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "connected"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 1,
    "total_tokens": 13
  }
}
生成テキストは通常、次のフィールドに入ります。 
choices[0].message.content

​
ルーティング

デフォルトでは自動ルーティングです。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
vendor を送るとプロバイダーを固定できます。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: openai" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'

​
ストリーミング

stream を true にすると、Server-Sent Events の増分 chunk としてレスポンスを受け取れます。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "Explain model routing in two sentences."
      }
    ]
  }'

​
よくあるエラー

ステータス原因確認
400リクエストボディが不正、または未対応パラメータmodel、messages、JSON 形式を確認してください。
401API キーが未指定、または無効Authorization ヘッダーを確認してください。
429プロバイダーのレート制限、または同時実行制限バックオフして再試行するか、自動ルーティングを使用してください。
500ゲートウェイまたは上流プロバイダーのエラー安全に再試行し、サポート用にリクエスト ID を保存してください。
モデル ID と固定例は モデル と ルーティング を参照してください。