主题
接口地址与协议
服务地址:两条线,先用默认那条
默认(三网优化直连) https://api.jichuanai.com ← 填这个
海外线路(Cloudflare) https://jc.jichuanai.com两条线功能完全一样,三套协议都支持,key 通用,不用改任何别的配置 —— 只把地址里的域名换掉即可。
| 什么时候用海外线路 | 说明 |
|---|---|
| 你人在海外 | CF 走全球节点,通常更稳 |
| 人在国内 | 别换,一直用默认线。海外线路在国内部分宽带会被拦,表现为连不上、要开梯子才行 |
控制台网页:国内用 cn.
https://cn.jichuanai.com 是网站(注册、兑换、看用量、建 key 都在这),国内直连,打开快。 人在海外也可以用 https://jc.jichuanai.com,两个网址账号通用。 https://api.jichuanai.com 是纯接口,用浏览器打开它只会看到一段 404 JSON, 那是正常的,不代表服务挂了。
本文下面所有示例都用默认线
人在海外时,看到 https://api.jichuanai.com 的地方换成 https://jc.jichuanai.com 同样成立。
三套协议都支持
用你的客户端原本支持的那一套即可,不需要改代码。
| 协议 | 完整地址 | 典型客户端 |
|---|---|---|
| OpenAI Chat Completions | https://api.jichuanai.com/v1/chat/completions | OpenAI SDK、Trae、WorkBuddy、ChatBox |
| Anthropic Messages | https://api.jichuanai.com/v1/messages | Claude Code |
| OpenAI Responses | https://api.jichuanai.com/v1/responses | Codex、Codex Desktop |
认证
两种写法都收:
http
Authorization: Bearer sk-xxxhttp
x-api-key: sk-xxxbase_url 该填哪个
取决于客户端会不会自己拼路径:
| 情况 | 填什么 |
|---|---|
| 客户端自己拼(多数 SDK、「完整 URL」关闭) | https://api.jichuanai.com/v1 |
| 客户端原样使用(「完整 URL」打开) | 带完整路径,如 https://api.jichuanai.com/v1/chat/completions |
Claude Code 的 ANTHROPIC_BASE_URL | https://api.jichuanai.com —— 不带 /v1 |
最后一行是特例
Claude Code 读环境变量时会自己补 /v1/messages。 你要是填了 https://api.jichuanai.com/v1,拼完就是 /v1/v1/messages → 404。
怎么验证地址填对了
用 curl 直接打一发(不依赖任何客户端):
bash
curl -i https://api.jichuanai.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{"model":"你的模型名","messages":[{"role":"user","content":"hi"}],"max_tokens":8}'- 返回 JSON 且含
choices→ 地址、key、模型名全都对 - 返回
Content-Type: text/html的网页 → 地址填错了(打到了站点根路径) - 返回 401 → key 不对
- 返回 404 且提示模型不存在 → 见 模型清单