五分钟快速接入
本页带你完成从创建 Key 到发出第一个请求的全过程。全程只需要一个控制台账号。
第一步：创建 API Key
- 登录 Router 控制台（地址由服务提供方告知，形如
https://router.<域名>或http://<IP>:31116）。 - 登录后默认进入「快速接入」首页。在第一步「创建 API Key」中点击签发 Key。
- 填写用途备注（如
prod、实验），可选填「可用模型」（限定该 Key 可调用的模型，留空 = 全部）与「月度限额」（超出后该 Key 调用被拒绝，次月自动恢复）。 - 点击签发。Key 明文只展示这一次——立即复制并妥善保存，关闭弹窗后无法再次查看。
第二步：选择协议，记下接入地址
控制台「快速接入」页第二步展示了三种协议的接入地址，按你的客户端/SDK 选择：
| 协议 | 接入地址 | 适用 |
|---|---|---|
| Anthropic Messages | https://routerapi.<域名>/anthropic | Claude Code、Cline 等 Anthropic 生态工具，Anthropic SDK |
| OpenAI Chat Completions | https://routerapi.<域名>/v1 | OpenAI SDK、LangChain、绝大多数聊天客户端与应用平台 |
| OpenAI Responses | https://routerapi.<域名>/v1 | 使用 OpenAI Responses API 的应用 |
以上为地址格式示例。实际地址以控制台「快速接入」页展示的为准（每台部署的域名不同）。
鉴权方式：OpenAI 协议在请求头携带 Authorization: Bearer <你的 Key>；Anthropic 协议携带 x-api-key: <你的 Key>（或 Authorization: Bearer，两者均可）。详见三种 API 协议。
第三步：发出第一个请求
以 OpenAI Chat Completions 协议为例（把地址与模型名替换为控制台实际值）：
bash
curl https://routerapi.<域名>/v1/chat/completions \
-H "Authorization: Bearer <你的 Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "<模型名>",
"messages": [{"role": "user", "content": "你好"}]
}'返回正常的 completion JSON 即接入成功。控制台「快速接入」页第三步会变为已完成状态，本次调用出现在「调用记录」中。
不知道模型名填什么？打开控制台「快速接入」页的可用模型列表，或参见可用模型与价格。选「智能路由池」让路由层自动选模型，选「直调模型」固定使用某个模型。
下一步
- 接入具体工具：Claude Code、Cline、Cherry Studio、Dify 等，见接入工具与平台全清单
- 在代码中集成：OpenAI / Anthropic SDK 示例见控制台「快速接入」页，框架接入见 LangChain、LlamaIndex