#选择模型

每个请求都需要模型 ID。请从实时模型页面复制准确 ID，不要凭记忆输入展示名称。

{
  "model": "MODEL_ID"
}

#模型 ID 与展示名称

模型卡片可能同时显示易读名称和 API 使用的标识。请求和工具配置中必须填写模型 ID。

除非客户端明确会标准化模型名称，否则请保留模型 ID 的大小写、前缀、标点和版本后缀。

#让模型与接口匹配

请根据需要选择支持对应能力的模型：

• 对话或文本生成
• 基于 Responses 的 Agent 工作流
• Embeddings
• 图片生成或编辑
• 语音生成或转录
• 视频生成
• Rerank 重排序
• Claude 兼容 Messages
• Gemini 兼容 generateContent

模型在一个接口上可用，并不代表它支持其他接口。

#通过 API 获取模型

curl https://getrouter.ai/v1/models \
  -H "x-goog-api-key: YOUR_API_KEY"

响应采用 OpenAI 兼容的模型列表格式。Gemini 兼容客户端可以使用：

curl https://getrouter.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"

#工具没有模型下拉列表

很多工具允许手动输入模型。请粘贴模型页面中的完整模型 ID。如果工具会缓存模型列表，请刷新 Provider、重新获取模型列表，或在修改 Base URL 和 API Key 后重启工具。

#使用前查看价格

不同模型可能采用不同计费单位和价格。运行长上下文、Agent 循环、大型媒体任务或自动化任务前，请查看价格页面。

#下一步

• 发送第一个 API 请求
• 连接 AI 工具
• 阅读 API 使用指南