快速开始
三项信息、一段给 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/v1 | OpenAI SDK、OpenCode、Codex、DeepSeek Harness 等大多数工具 |
完整接口地址(以 /chat/completions 结尾) | https://modelrouter.club/v1/chat/completions | WorkBuddy / CodeBuddy、直接发 HTTP 请求 |
| 根地址 | https://modelrouter.club | Claude 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 编程助手,可以把配置工作直接交给它:
- 打开控制台的 API 密钥 页面,点密钥右侧的 接入配置。
- 选择要配置的工具和模型,点 复制给 Agent。
- 把复制的内容发给你的 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
接入方法参考 /ja/docs/integrations/opencode 。
写好配置后运行验证命令,告诉我结果。这段话里有我的 API 密钥:只把它写进本地配置文件,回复时不要完整复述,也不要提交到代码仓库。手动接入:发送第一个请求
不想用 AI 助手,也可以自己来。下面用一条命令验证密钥和模型都能用。
在 模型广场 选一个模型,点模型名旁的复制按钮,复制它的模型 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": "你好"}]}'