モデル

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/completions`	Chat Completions
画像入力 / ビジョン	`/v1/chat/completions`	マルチモーダル
テキスト埋め込み	`/v1/embeddings`	Embeddings
Gemini ネイティブマルチモーダル	`/v1/projects/...:generateContent`	Google Generate Content
Claude ネイティブ Messages	`/v1/messages`	Anthropic Messages
動画生成タスク	`/api/v3/contents/generations/tasks`	Ark テキストから動画生成

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

YouRouter は幅広いモデルアクセスを前提に設計されています。1 つの統合 API で、主要プロバイダーやモデルファミリーを横断できます。

ファミリー	例となるモデル ID
OpenAI GPT	`gpt-4o`, `gpt-4o-mini-2024-07-18`, `gpt-4.1-2025-04-14`
OpenAI reasoning	`o3-2025-04-16`, `o4-mini-2025-04-16`, `o1-2024-12-17`
Anthropic Claude	`claude-sonnet-4-20250514`, `claude-opus-4-20250514`, `claude-3-7-sonnet-20250219`
Google Gemini	`gemini-2.5-pro`, `gemini-2.5-flash`
DeepSeek	`deepseek-r1-250528`, `deepseek-v3-250324`
xAI Grok	`grok-3`, `grok-3-mini`, `grok-3-fast`
Volcengine Doubao	`doubao-seed-1-6-250615`, `doubao-seed-1-6-thinking-250615`, `doubao-1-5-pro-32k-250115`
Moonshot Kimi	`kimi-k2-250711`

モデルの可用性はアカウント、上流の状態、ルーティング設定で変わります。モデル ID はコードに直書きせず、設定値として持つと運用が楽です。

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

クライアントは同じで、model だけ変えます。

Python
Node.js

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)

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.YOUROUTER_API_KEY,
  baseURL: 'https://api.yourouter.ai/v1',
});

const modelId = 'gemini-2.5-flash';

const completion = await openai.chat.completions.create({
  model: modelId,
  messages: [{ role: 'user', content: 'Reply with exactly: connected' }],
});

console.log(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 の例:

Provider	`vendor` 値
自動ルーティング	`auto`
OpenAI	`openai`
Azure OpenAI	`azure`
Anthropic	`anthropic`
Google	`google`
AWS Bedrock	`aws`
DeepSeek	`deepseek`
Mistral AI	`mistral`
Volcengine	`volcengine`
xAI	`x`

詳細はルーティングを参照してください。

推奨される設定の持ち方

次の値は設定として外に出しておくと、モデル追加や切替が容易です。

設定	例
API Base URL	`https://api.yourouter.ai/v1`
API キー	`YOUROUTER_API_KEY`
既定モデル	`gpt-4o`
フォールバック	`gemini-2.5-flash`
ルーティング	`auto`

これにより、アプリケーションコードを変更せずにモデルの追加、削除、切り替えがしやすくなります。

API クイックスタート

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

Chat Completions

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

マルチモーダル

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

ルーティング

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

API リファレンス

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

はじめに

モデル API

ルーティングと信頼性

API リファレンス

機能

法務

基本的なモデル呼び出し

`model` フィールド

モデル API の能力マップ

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

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

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

推奨される設定の持ち方

関連ガイド

API クイックスタート

Chat Completions

マルチモーダル

ルーティング

API リファレンス

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

​model フィールド

​モデル API の能力マップ

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

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

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

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

​関連ガイド

API クイックスタート

Chat Completions

マルチモーダル

ルーティング

API リファレンス

基本的なモデル呼び出し

`model` フィールド

モデル API の能力マップ

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

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

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

推奨される設定の持ち方

関連ガイド