> ## 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 在一个 OpenAI 兼容 API 背后接入了多种模型家族，因此切换模型通常只需要修改 `model` 的值。

<Note>
  如需查看你当前账号可用的最新模型 ID，请前往 [YouRouter Dashboard](https://platform.yourouter.ai/dashboard)。
</Note>

## 基础模型调用

所有 Chat Completions 请求都使用同一种 API 结构：

```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](/zh/guides/chat-completions)                      |
| 图片输入 / 视觉理解        | `/v1/chat/completions`               | [多模态](/zh/guides/multimodal)                                         |
| 文本向量               | `/v1/embeddings`                     | [Embeddings](/zh/guides/embeddings)                                  |
| Gemini 原生多模态       | `/v1/projects/...:generateContent`   | [Google Generate Content](/zh/api-reference/google/generate-content) |
| Claude 原生 messages | `/v1/messages`                       | [Anthropic Messages](/zh/api-reference/messages/create)              |
| 视频生成任务             | `/api/v3/contents/generations/tasks` | [Ark 文生视频](/zh/guides/ark-video)                                     |

## 支持的模型家族

YouRouter 的目标是提供广泛的模型访问能力。你可以通过一次集成，调用多家主流提供商和多种模型家族。

| 家族                | 示例模型 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` 取值包括：

| 上游提供商        | `vendor` 值   |
| ------------ | ------------ |
| 自动路由         | `auto`       |
| OpenAI       | `openai`     |
| Azure OpenAI | `azure`      |
| Anthropic    | `anthropic`  |
| Google       | `google`     |
| AWS Bedrock  | `aws`        |
| DeepSeek     | `deepseek`   |
| Mistral AI   | `mistral`    |
| Volcengine   | `volcengine` |
| xAI          | `x`          |

更多自动路由和固定上游的说明，见 [路由指南](/zh/guides/router)。

## 推荐的集成方式

建议将以下值都做成可配置项：

| 配置项          | 示例                            |
| ------------ | ----------------------------- |
| API Base URL | `https://api.yourouter.ai/v1` |
| API Key      | `YOUROUTER_API_KEY`           |
| 默认模型         | `gpt-4o`                      |
| 回退模型         | `gemini-2.5-flash`            |
| 可选上游提供商      | `auto`                        |

这样在新增、移除或切换模型时，不需要修改应用代码。

## 相关指南

<CardGroup cols={2}>
  <Card title="API 快速开始" icon="rocket" href="/zh/quickstart">
    发起第一条模型请求。
  </Card>

  <Card title="Chat Completions" icon="message" href="/zh/guides/chat-completions">
    使用对话、流式、工具调用和多模态输入。
  </Card>

  <Card title="多模态" icon="image" href="/zh/guides/multimodal">
    发送图片输入并调用原生多模态 API。
  </Card>

  <Card title="路由指南" icon="route" href="/zh/guides/router">
    选择自动路由或固定上游提供商。
  </Card>

  <Card title="API 参考" icon="code" href="/zh/api-reference/introduction">
    查看接口细节和请求格式。
  </Card>
</CardGroup>