模型 - YouRouter Developer Platform

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

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

上游提供商	`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 Key	`YOUROUTER_API_KEY`
默认模型	`gpt-4o`
回退模型	`gemini-2.5-flash`
可选上游提供商	`auto`

API 快速开始

发起第一条模型请求。

Chat Completions

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

多模态

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

路由指南

选择自动路由或固定上游提供商。

API 参考

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

快速开始

模型 API

路由与稳定性

API 参考

功能

法律

模型

基础模型调用

`model` 字段

模型 API 能力

支持的模型家族

在代码中切换模型

路由到指定上游提供商

推荐的集成方式

相关指南

API 快速开始

Chat Completions

多模态

路由指南

API 参考

​基础模型调用

​model 字段

​模型 API 能力

​支持的模型家族

​在代码中切换模型

​路由到指定上游提供商

​推荐的集成方式

​相关指南

API 快速开始

Chat Completions

多模态

路由指南

API 参考

基础模型调用

`model` 字段

模型 API 能力

支持的模型家族

在代码中切换模型

路由到指定上游提供商

推荐的集成方式

相关指南