接线手册
所有 API 调用都发往 https://api.api365relay.com;网站主域只用来管理账户。
1线路地址表
同一个中继入口承接三种协议;按客户端说的协议,填对应的地址和鉴权头。
| 协议线路 | 填写的地址 | 鉴权头 | 常用路径 |
|---|---|---|---|
| Anthropic Messages · Claude Code / Claude Desktop | https://api.api365relay.com | x-api-key | /v1/messages · /v1/messages/count_tokens |
| OpenAI · Codex / OpenAI SDK | https://api.api365relay.com/v1 | Authorization: Bearer | /chat/completions · /responses · /models |
| Gemini · Gemini CLI | https://api.api365relay.com | x-goog-api-key | /v1beta/models/{model}:generateContent · :streamGenerateContent?alt=sse |
2状态码与处理
| 状态码 | 意味着什么 | 怎么处理 |
|---|---|---|
| 401 | 没带密钥、密钥写错,或密钥已停用 | 在控制台复制一把使用中的密钥,按上表的鉴权头发送 |
| 402 | 钱包余额已用完,或值守卡额度 / 7 天封顶已用完 | 充值,或换用另一张有额度的值守卡 |
| 403 | 账户已停用,或值守卡专用密钥调用了别的模型族 | 其它模型族请改用钱包按量的密钥 |
| 404 | 路径不在值班台的线路上(Gemini 路径需形如 /v1beta/models/模型:方法) | 对照上表核对基址和路径 |
| 413 | 请求体超过 25 MB | 拆小上下文或附件后重发 |
| 429 | 单把密钥 60 秒内超过 120 次,或同一账户同时在途超过 8 个请求 | 稍等片刻再试,并发控制在 8 以内 |
| 502 / 503 | 上游线路暂时不通(502)或线路未配置(503),这次不计费 | 稍后重试;持续出现请通过联系我们留言 |
3各客户端配置
| 客户端工具 | 要设置的项 | 填什么 |
|---|---|---|
| Claude Code / Claude Desktop | ANTHROPIC_BASE_URL · ANTHROPIC_AUTH_TOKEN | 中继入口(不加 /v1) · 你的 API 密钥 |
| Codex CLI | OPENAI_BASE_URL · OPENAI_API_KEY | 中继入口 + /v1 · 你的 API 密钥 |
| OpenAI SDK | base_url · api_key | 中继入口 + /v1 · 你的 API 密钥 |
| Gemini CLI | GOOGLE_GEMINI_BASE_URL · GEMINI_API_KEY | 中继入口(不加 /v1) · 你的 API 密钥 |
| cURL | Authorization: Bearer | 你的 API 密钥 |
上游只接受官方 Claude Code / Claude Desktop 客户端调用 Claude 系列模型,且 Claude Code 版本需不低于 2.1.285。GPT、Gemini 等模型可用任意 OpenAI 兼容客户端或 SDK。
export ANTHROPIC_BASE_URL=https://api.api365relay.com
export ANTHROPIC_AUTH_TOKEN=r365-your-line-key
claude
把 $R365_KEY 换成你的线路密钥,能收到回复就说明线路已通。
curl https://api.api365relay.com/v1/chat/completions \
-H "Authorization: Bearer $R365_KEY" -H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping from the night shift"}]}'
GPT 线路名可选: gpt-6.1-sol gpt-6-astra gpt-5.6-sol
Gemini 只走原生协议:非流式用 :generateContent,流式用 :streamGenerateContent?alt=sse,不能发到 /v1/chat/completions。
curl "https://api.api365relay.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: $R365_KEY" -H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"ping from the night shift"}]}]}'
Gemini 线路名: gemini-3.1-pro gemini-4-argon gemini-3.8-flash gemini-2.5-flash
4计费口径
- 每次请求按上游回报的真实 token 计费,缓存填充与缓存召回单独计价。
- HTTP 402:钱包余额不足,或值守卡额度已用完,充值后即可恢复。
- HTTP 429:单把密钥 60 秒内超过 120 次,或同一账户同时在途超过 8 个请求。
- HTTP 401:没有带密钥、密钥写错或已退役。
- OpenAI 协议用 Authorization: Bearer 传密钥,Anthropic 协议用 x-api-key,Gemini 用 x-goog-api-key。