ModelRouterModelRouter
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。

快速开始

三项信息、一段给 AI 助手的话,几分钟接入ModelRouter。

ModelRouter 提供 OpenAI 兼容和 Anthropic 兼容的接口。用本站的一个 API 密钥,就能在 Claude Code、Codex、OpenCode、WorkBuddy 等工具里调用 DeepSeek、GLM、Kimi 系列模型,不需要各家的官方密钥。

三项必填信息

接入任何工具,都只需要这三项:

信息填写内容从哪里拿
接口地址按下表选择,不同工具要的形式不一样控制台 API 密钥 页的"接入信息"可以一键复制
API 密钥以 sk- 开头的密钥创建 API 密钥
模型 ID例如 deepseek-v4-pro,必须和模型广场里的 ID 完全一致模型广场,点模型名旁的复制按钮

接口地址怎么填

工具要你填的是填写适用工具
OpenAI Base URL / API 地址https://modelrouter.club/v1OpenAI SDK、OpenCode、Codex、DeepSeek Harness 等大多数工具
完整接口地址(以 /chat/completions 结尾)https://modelrouter.club/v1/chat/completionsWorkBuddy / CodeBuddy、直接发 HTTP 请求
根地址https://modelrouter.clubClaude Code(它会自己补 /v1/messages)、Cherry Studio、Chatbox
提示
不确定时先填 https://modelrouter.club/v1。地址填错会返回 404,报错信息会说明是漏写了 /v1、重复写了 /v1,还是把 Base URL 当成了完整接口地址。
注意
模型 ID 不是模型的显示名。DeepSeek V4 Pro、deep-seek-4-Pro 这类写法都会报"模型不存在",请直接复制模型广场里的 ID。

最快的方式:让 AI 助手帮你配置

如果你已经在用 Claude Code、WorkBuddy、Codex 这类 AI 编程助手,可以把配置工作直接交给它:

  1. 打开控制台的 API 密钥 页面,点密钥右侧的 接入配置。
  2. 选择要配置的工具和模型,点 复制给 Agent。
  3. 把复制的内容发给你的 AI 助手。它会写好配置文件,再运行验证命令或告诉你下一步(例如 WorkBuddy 需要重启后选择模型)。
注意
复制的内容包含你的完整密钥,接收它的 AI 服务会看到,请只发给你信任的 AI 助手。不想让 AI 助手接触密钥,就按对应工具的教程手动配置。

复制的内容已经填好了你的密钥、正确的地址和模型 ID。也可以用下面这段通用版,把 YOUR_API_KEY 换成你的密钥,工具名和模型 ID 换成你要的:

请帮我把 OpenCode 接入ModelRouter(OpenAI 兼容的 API 服务)。
- 接口地址:https://modelrouter.club/v1
- API 密钥:YOUR_API_KEY
- 模型 ID:deepseek-v4-pro
接入方法参考 /zh/docs/integrations/opencode 。
写好配置后运行验证命令,告诉我结果。这段话里有我的 API 密钥:只把它写进本地配置文件,回复时不要完整复述,也不要提交到代码仓库。

手动接入:发送第一个请求

不想用 AI 助手,也可以自己来。下面用一条命令验证密钥和模型都能用。

登录 API 密钥 页面,点 创建 API 密钥,填个名称后保存。再到 钱包 确认有余额。

注意
密钥等同于调用凭证,不要写进公开仓库、网页代码或截图。

在 模型广场 选一个模型,点模型名旁的复制按钮,复制它的模型 ID。

把 YOUR_API_KEY 和 YOUR_MODEL_ID 换成你的密钥和模型 ID,在终端运行:

curl https://modelrouter.club/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "YOUR_MODEL_ID", "messages": [{"role": "user", "content": "你好"}]}'

返回内容里 choices[0].message.content 就是模型的回答。每次调用都可以在 使用日志 里看到用量和费用。

报错时对照 错误排查,报错信息会说明原因。

按工具接入