设置模型
OpenRouter
通过 OpenRouter 官方 API 接入主流模型,支持 OpenAI 协议或 Anthropic 协议。
OpenRouter 是一个聚合多家模型供应商的统一网关。如果你想用一个 Key 同时访问 GPT、Claude、Gemini、开源模型等,OpenRouter 是常见选择。
准备 API Key
- 在 openrouter.ai 注册账号,进入 Keys 页面创建 API Key。
- 在 OpenRouter 余额中预充值,或绑定支付方式。
- 在 Models 列表中确认目标模型 ID(OpenRouter 的 Model ID 形如
openai/gpt-5.5、anthropic/claude-opus-4-7)。
通过 OpenAI 协议接入(推荐)
OpenRouter 提供与 OpenAI 完全兼容的 Chat Completions / Responses API 端点,是最稳妥的接入方式。
| 字段 | 值 |
|---|---|
| API Type | OpenAI Chat Completions(或 OpenAI Responses API,仅部分模型支持) |
| Model | 如 openai/gpt-5.5、anthropic/claude-opus-4-7、google/gemini-2.5-pro |
| Base URL | https://openrouter.ai/api/v1 |
| API Key | OpenRouter Key(sk-or-...) |
注意:
- 必须使用 OpenRouter 风格的复合 Model ID(
<vendor>/<model>),直接写gpt-5.5会失败。 - OpenRouter 的 Responses API 仅对部分原生支持的 OpenAI 模型有效;其他模型请使用 Chat Completions。
通过 Anthropic 协议接入
如果你想让 OpenRouter 表现得像 Anthropic 官方 API(例如希望使用 Anthropic 风格的 Thinking 字段),可以选择其 Anthropic 兼容端点:
| 字段 | 值 |
|---|---|
| API Type | Anthropic |
| Model | 如 anthropic/claude-opus-4-7、anthropic/claude-sonnet-4-6 |
| Base URL | https://openrouter.ai/api/v1 |
| API Key | OpenRouter Key(sk-or-...) |
| Thinking | Adaptive |
仅推荐用于 Claude 系列模型;调用 OpenAI 系列时还是优先走 OpenAI 协议。
注意事项
- Base URL 必须带
/api/v1,与 OpenAI 官方 (/v1) 的路径结构不同,常见错误是漏写api路径。 - OpenRouter 计费独立于上游供应商,建议在 OpenRouter 控制台设置月度/单次预算上限。
- 不同 Model ID 的可用 Effort、Thinking、Vision 取值由上游模型决定。如果 OpenRouter 反馈
parameter not supported,请改成 Not set 或换协议。 - 大陆访问 OpenRouter 通常比 OpenAI / Anthropic 官方稳定,但仍建议测试网络后再用于长任务。