North Coder
设置模型

OpenRouter

通过 OpenRouter 官方 API 接入主流模型,支持 OpenAI 协议或 Anthropic 协议。

OpenRouter 是一个聚合多家模型供应商的统一网关。如果你想用一个 Key 同时访问 GPT、Claude、Gemini、开源模型等,OpenRouter 是常见选择。

准备 API Key

  1. openrouter.ai 注册账号,进入 Keys 页面创建 API Key。
  2. 在 OpenRouter 余额中预充值,或绑定支付方式。
  3. Models 列表中确认目标模型 ID(OpenRouter 的 Model ID 形如 openai/gpt-5.5anthropic/claude-opus-4-7)。

通过 OpenAI 协议接入(推荐)

OpenRouter 提供与 OpenAI 完全兼容的 Chat Completions / Responses API 端点,是最稳妥的接入方式。

字段
API TypeOpenAI Chat Completions(或 OpenAI Responses API,仅部分模型支持)
Modelopenai/gpt-5.5anthropic/claude-opus-4-7google/gemini-2.5-pro
Base URLhttps://openrouter.ai/api/v1
API KeyOpenRouter 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 TypeAnthropic
Modelanthropic/claude-opus-4-7anthropic/claude-sonnet-4-6
Base URLhttps://openrouter.ai/api/v1
API KeyOpenRouter Key(sk-or-...
ThinkingAdaptive

仅推荐用于 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 官方稳定,但仍建议测试网络后再用于长任务。

本页内容