> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# モデル

> YouRouter のモデル API で複数のモデルファミリーを呼び出します。

`model` フィールドで、どのモデルが応答するかを指定します。YouRouter は 1 つの OpenAI 互換 API の背後に複数のモデルファミリーを接続しているため、モデルを切り替える場合は **`model` の値を変えるだけ** で済むことが多いです。

<Note>
  アカウントで有効な最新のモデル ID は [YouRouter Dashboard](https://platform.yourouter.ai/dashboard) で確認してください。
</Note>

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

すべての Chat Completions リクエストは同じ形です。

```bash theme={null}
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` を変更します。

```json theme={null}
{
  "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](/ja/guides/chat-completions)                      |
| 画像入力 / ビジョン           | `/v1/chat/completions`               | [マルチモーダル](/ja/guides/multimodal)                                     |
| テキスト埋め込み              | `/v1/embeddings`                     | [Embeddings](/ja/guides/embeddings)                                  |
| Gemini ネイティブマルチモーダル   | `/v1/projects/...:generateContent`   | [Google Generate Content](/ja/api-reference/google/generate-content) |
| Claude ネイティブ Messages | `/v1/messages`                       | [Anthropic Messages](/ja/api-reference/messages/create)              |
| 動画生成タスク               | `/api/v3/contents/generations/tasks` | [Ark テキストから動画生成](/ja/guides/ark-video)                               |

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

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`                                                                         |

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

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

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

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    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)
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    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);
    ```
  </Tab>
</Tabs>

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

デフォルトでは YouRouter が自動ルーティングします。特定の上流が必要な場合は `vendor` ヘッダーを付けます。

```bash theme={null}
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`          |

詳細は [ルーティング](/ja/guides/router) を参照してください。

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

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

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

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

## 関連ガイド

<CardGroup cols={2}>
  <Card title="API クイックスタート" icon="rocket" href="/ja/quickstart">
    最初のモデル API リクエストを送ります。
  </Card>

  <Card title="Chat Completions" icon="message" href="/ja/guides/chat-completions">
    チャット、ストリーミング、ツール、マルチモーダル入力を扱います。
  </Card>

  <Card title="マルチモーダル" icon="image" href="/ja/guides/multimodal">
    画像入力とプロバイダー固有のマルチモーダル API を扱います。
  </Card>

  <Card title="ルーティング" icon="route" href="/ja/guides/router">
    自動ルーティングとプロバイダー固定を選びます。
  </Card>

  <Card title="API リファレンス" icon="code" href="/ja/api-reference/introduction">
    エンドポイント詳細とリクエスト形式を確認します。
  </Card>
</CardGroup>