报 401 Invalid API Key / 认证失败怎么办？

八成是 Key 过期。本站 Key 限时有效（Free 3 小时 / Grok 2 小时 / Claude 1 小时），到期自动失效。其余按顺序查：Key 是否复制完整、前后有无空格换行；领取后是否超过 15 分钟才发起首次调用（会被自动吊销）；协议是否配对（Anthropic 协议客户端误填 /openai/v1 也会认证失败）。确认后回首页重新领取即可。

报 404 Not Found 是什么原因？

几乎都是 Base URL 的 /v1 填错。规则：客户端自己拼完整路径的（Claude Code 的 ANTHROPIC_BASE_URL）不带 /v1，填 https://jiurelay.com/anthropic；客户端只拼资源名的（CC Switch、Cursor、Cline、Codex 的 base_url 字段）带 /v1，填 https://jiurelay.com/openai/v1 或 https://jiurelay.com/anthropic/v1。多写成 /v1/v1、末尾多加斜杠、漏写 /v1 都会 404。

报 429 Too Many Requests 怎么办？

429 表示触发限速，等待几十秒再重试即可，不要立刻反复重发（会持续触发）。免费线路是共享额度，高峰时段限速更明显。跑大型多文件任务频繁 429 时，把任务拆小、降低并发。429 不是 Key 坏了，不需要重新领取。

报模型不存在（model not found）怎么办？

模型 ID 必须原样填写：Free 线路填 5.2，Grok 线路填 grok-4.5。写成官方模型名（claude-sonnet-4、gpt-4o 等）会报模型不存在。另外 Key 和模型是绑定的：Free 的 Key 配 5.2，Grok 的 Key 配 grok-4.5，混填也会报错。Cursor 用户注意取消勾选所有官方模型，只留自定义模型。

Key 没到期为什么突然失效了？

两种情况：领取后 15 分钟内没有发起首次调用，Key 被自动吊销（回收领了不用的额度）；或检测到多 IP 共享同一个 Key 被限制（正常单人使用不会触发）。两种都需要回首页重新领取。

客户端一直转圈没响应 / 连接失败怎么办？

先用 curl 直接测试端点（见页面内命令），能通就是客户端配置问题：重点检查 Base URL 拼写、代理软件是否拦截了自定义域名、客户端是否需要重启才重新读配置（Codex 必须重启终端）。curl 也不通则可能是本地网络或运营商问题，换网络环境再试。

同一天为什么领不了第二个 Key？

领取侧限制：同一设备每条线路每天限领 1 次，每天 00:00（北京时间）刷新；此外每个 IP 每小时最多 1 次、连续 12 小时内最多 4 次。公司或校园网共享公网 IP 会共用 IP 额度。需要更长有效期可通过推广计划兑换 24 小时 / 7 天 / 30 天长效 Key。

TROUBLESHOOTING

报错排查：401 / 404 / 429 / 模型不存在

适用于所有客户端按报错码直达最后更新 2026-07-26

一句话回答

四个最常见报错的第一嫌疑：401 八成是 Key 过期（本站 Key 限时有效，Free 3 小时 / Grok 2 小时 / Claude 1 小时），回首页重领即可； 404 几乎都是 Base URL 的 /v1 填错（环境变量方式不带、图形工具带）； 429 是共享额度限速，等几十秒重试，不要连发； 模型不存在是模型 ID 没原样填 5.2 或 grok-4.5，或 Key 与模型线路不匹配。

30 秒自检：用 curl 绕开客户端直测

OPENAI 协议（5.2 / grok-4.5）

curl https://jiurelay.com/openai/v1/chat/completions \
  -H "Authorization: Bearer 你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"5.2","messages":[{"role":"user","content":"hi"}]}'

ANTHROPIC 协议（仅 Free 线路）

curl https://jiurelay.com/anthropic/v1/messages \
  -H "x-api-key: 你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"5.2","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'

curl 能通、客户端不通 = 客户端配置问题（Base URL / 模型 ID / 是否重启）；curl 也报错 = 看返回的报错码对号入座（下方逐条）。

按报错逐条排查

401 Invalid API Key / 认证失败

按命中率排序：① Key 过期——本站 Key 限时有效（Free 3 小时 / Grok 2 小时 / Claude 1 小时），这是 401 的头号原因；② Key 复制不完整或带了空格换行；③ 领取后超过 15 分钟没发起首次调用，被自动吊销；④ 协议错配——Anthropic 协议客户端填了 /openai/v1。处理方式统一：回首页重新领一个，重新填入。

404 Not Found

几乎都是 /v1 的锅，规则一句话：客户端自己拼完整路径的不带 /v1，只拼资源名的带 /v1。Claude Code 的 ANTHROPIC_BASE_URL 填 https://jiurelay.com/anthropic（它自己拼 /v1/messages）；CC Switch、Cursor、Cline、Codex 的 base_url 字段填 https://jiurelay.com/openai/v1 或 https://jiurelay.com/anthropic/v1。多写成 /v1/v1、末尾多斜杠、漏写，表现全是 404。细节见对应教程：Claude Code / Codex / Cursor。

429 Too Many Requests

触发了限速。等待几十秒再重试，不要立刻反复重发——那样会持续触发。免费线路是共享额度，高峰时段更明显。在 Claude Code / Codex 里跑大型多文件任务频繁 429 时，把任务拆小、降低并发。429 不代表 Key 坏了，不需要重领；持续半小时以上不恢复才考虑是上游波动，稍后再试。

模型不存在 / model not found

模型 ID 必须原样填写：Free 线路 5.2，Grok 线路 grok-4.5，写成 claude-sonnet-4、gpt-4o 等官方名都会报此错。另外 Key 和模型是绑定的：Free 的 Key 只能配 5.2，Grok 的 Key 只能配 grok-4.5。Cursor 用户额外注意：把官方模型全部取消勾选，只留自定义模型，否则请求会打到不存在的模型上。可以用 GET /openai/v1/models 实时查看当前 Key 可用的模型列表。

Key 没到期却突然失效

两种情况：① 领取后 15 分钟内没发起首次调用被自动吊销（回收领了不用的额度）——领完立刻试跑一句话就能避免；② 检测到多 IP 共享同一个 Key 被限制，正常单人使用（含手机电脑切换）不会触发。都需要重新领取。

一直转圈 / 无响应 / 连接失败

先跑上面的 curl 自检。curl 能通：检查客户端 Base URL 拼写、是否重启（Codex 必须重开终端才重新读配置）、本地代理软件是否拦截了该域名（把 jiurelay.com 加入直连规则试试）。curl 也不通：本地网络或 DNS 问题，换网络环境（如手机热点）对照测试。

今天领不了第二个 Key

领取侧规则：同一设备每条线路每天限领 1 次（每天 00:00 北京时间刷新）；每个 IP 每小时最多 1 次、连续 12 小时内最多 4 次。公司 / 校园网共享公网 IP 会共用 IP 额度，属正常现象。需要更长有效期的 Key，走推广计划兑换 24 小时 / 7 天 / 30 天长效 Key。