跳转到主要内容
使用 model 字段来指定由哪个模型处理请求。YouRouter 在一个 OpenAI 兼容 API 背后接入了多种模型家族，因此切换模型通常只需要修改 model 的值。
如需查看你当前账号可用的最新模型 ID，请前往 YouRouter Dashboard。

​
基础模型调用

所有 Chat Completions 请求都使用同一种 API 结构： 
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 文生视频

​
支持的模型家族

YouRouter 的目标是提供广泛的模型访问能力。你可以通过一次集成，调用多家主流提供商和多种模型家族。
家族示例模型 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)

​
路由到指定 Provider

默认情况下，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 KeyYOUROUTER_API_KEY
默认模型gpt-4o
回退模型gemini-2.5-flash
可选 Providerauto
这样在新增、移除或切换模型时，不需要修改应用代码。

​
相关指南

API 快速开始

发起第一条模型请求。

Chat Completions

使用对话、流式、工具调用和多模态输入。

多模态

发送图片输入并调用原生多模态 API。

路由指南

选择自动路由或固定 provider。

API 参考

查看接口细节和请求格式。