メインコンテンツへスキップ
model フィールドで、どのモデルが応答するかを指定します。YouRouter は 1 つの OpenAI 互換 API の背後に複数のモデルファミリーを接続しているため、モデルを切り替える場合は model の値を変えるだけ で済むことが多いです。
アカウントで有効な最新のモデル ID は YouRouter Dashboard で確認してください。

​
基本的なモデル呼び出し

すべての Chat Completions リクエストは同じ形です。 
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"
      }
    ]
  }'
別のモデルを呼び出す場合は model を変更します。 
{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this request in one sentence."
    }
  ]
}

​
model フィールド

フィールド必須説明
modelはい呼び出すモデル ID（例: gpt-4o, claude-sonnet-4-20250514, gemini-2.5-flash）
messagesはいチャットモデル向けの会話メッセージ配列
streamいいえtrue にすると増分チャンクで返却

​
モデル API の能力マップ

能力API パスまず読む場所
テキストチャット/v1/chat/completionsChat Completions
画像入力 / ビジョン/v1/chat/completionsマルチモーダル
テキスト埋め込み/v1/embeddingsEmbeddings
Gemini ネイティブ多モーダル/v1/projects/...:generateContentGoogle Generate Content
Claude ネイティブ Messages/v1/messagesAnthropic Messages
動画生成タスク/api/v3/contents/generations/tasksArk テキスト to ビデオ

​
代表的なモデルファミリー

YouRouter は幅広いモデルアクセスを前提に設計されています。1 つの統合 API で、主要プロバイダーやモデルファミリーを横断できます。
ファミリー例となるモデル ID
OpenAI GPTgpt-4o, gpt-4o-mini-2024-07-18, gpt-4.1-2025-04-14
OpenAI reasoningo3-2025-04-16, o4-mini-2025-04-16, o1-2024-12-17
Anthropic Claudeclaude-sonnet-4-20250514, claude-opus-4-20250514, claude-3-7-sonnet-20250219
Google Geminigemini-2.5-pro, gemini-2.5-flash
DeepSeekdeepseek-r1-250528, deepseek-v3-250324
xAI Grokgrok-3, grok-3-mini, grok-3-fast
Volcengine Doubaodoubao-seed-1-6-250615, doubao-seed-1-6-thinking-250615, doubao-1-5-pro-32k-250115
Moonshot Kimikimi-k2-250711
モデルの可用性はアカウント、上流の状態、ルーティング設定で変わります。モデル ID はコードに直書きせず、設定値として持つと運用が楽です。

​
コードでモデルを切り替える

クライアントは同じで、model だけ変えます。 
import os
from openai import OpenAI

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

model_id = "gemini-2.5-flash"

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

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

​
上流プロバイダーへルーティングする

デフォルトでは YouRouter が自動ルーティングします。特定の上流が必要な場合は vendor ヘッダーを付けます。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: anthropic" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'
よく使う vendor の例:
Providervendor 値
自動ルーティングauto
OpenAIopenai
Azure OpenAIazure
Anthropicanthropic
Googlegoogle
AWS Bedrockaws
DeepSeekdeepseek
Mistral AImistral
Volcenginevolcengine
xAIx
詳細は ルーティング を参照してください。

​
推奨される設定の持ち方

次の値は設定として外に出しておくと、モデル追加や切替が容易です。
設定例
API Base URLhttps://api.yourouter.ai/v1
API キーYOUROUTER_API_KEY
既定モデルgpt-4o
フォールバックgemini-2.5-flash
ルーティングauto

​
関連ガイド

API クイックスタート

最初のモデル API リクエストを送ります。

Chat Completions

チャット、ストリーミング、ツール、マルチモーダル入力を扱います。

マルチモーダル

画像入力とプロバイダー固有の多モーダル API を扱います。

ルーティング

自動ルーティングとプロバイダー固定を選びます。

API リファレンス

エンドポイント詳細とリクエスト形式を確認します。