故障排查

本页只写用户侧能做的排查。遇到问题时，先保存错误信息里的 request id、请求时间、模型名和客户端名称。

先确认 Base URL

客户端类型	Base URL
OpenAI SDK / Codex / OpenAI Compatible	https://ai.enodot.shop/v1
Anthropic SDK / Claude Code / Claude Desktop	https://ai.enodot.shop
Gemini SDK / Gemini CLI	https://ai.enodot.shop/v1beta

最常见错误是多写或少写 /v1。

先用 curl 自测

OpenAI：

curl https://ai.enodot.shop/v1/models \
  -H "Authorization: Bearer 你的 Enodot API Key"

Anthropic：

curl https://ai.enodot.shop/v1/messages \
  -H "x-api-key: 你的 Enodot API Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "只回复 ok"}]
  }'

Gemini：

curl "https://ai.enodot.shop/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: 你的 Enodot API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "只回复 ok"}]}]
  }'

curl 成功但客户端失败，说明问题大概率在客户端配置。

401 Invalid API key

检查：

• API Key 是否复制完整。
• Key 前后是否多了空格或换行。
• OpenAI 模式是否使用 Authorization: Bearer YOUR_KEY。
• Anthropic 模式是否使用 x-api-key: YOUR_KEY。
• 你填的是 Enodot Key，不是官方 OpenAI / Anthropic / Gemini Key。

403 Access denied

检查：

• 账号余额是否充足。
• 当前 Key 是否被停用。
• 当前 Key 是否绑定了正确分组。
• 请求模型是否在 /v1/models 返回列表里。
• IP 白名单是否限制了当前网络。

404 Not Found

按协议检查地址：

• OpenAI SDK 填 https://ai.enodot.shop/v1。
• Anthropic SDK 填 https://ai.enodot.shop。
• Gemini SDK 填 https://ai.enodot.shop/v1beta。

如果 Anthropic 客户端填成 https://ai.enodot.shop/v1，经常会拼出错误路径。

429 或 quota exceeded

通常代表当前 Key、用户余额、订阅窗口或分组额度不足。处理方式：

1. 打开控制台查看余额。
2. 查看 API Key 用量。
3. 换一个自己有权限的模型。
4. 等待额度窗口重置。

502 Bad Gateway

502 表示请求已经到达 Enodot，但上游链路暂时失败。用户侧可以做三件事：

1. 重试一次。
2. 换一个可用模型。
3. 记录 request id、模型名、请求时间，提交给支持。

不要连续高频重试同一个失败请求，这会更快消耗客户端重试次数。

流式请求中断

可能原因：

• 本地网络不稳定。
• 浏览器、代理或客户端中途断开连接。
• 输出太长，客户端超时。
• 上游临时断流。

建议：

• 缩短单次问题或降低输出长度。
• 关闭本地网络代理后再试一次。
• 换非流式请求确认 Key 和模型是否正常。
• 保留 request id 给支持排查。

模型不可用

先查自己的模型列表：

curl https://ai.enodot.shop/v1/models \
  -H "Authorization: Bearer 你的 Enodot API Key"

如果列表里没有，不要在客户端里手动填写。当前文档推荐的常用模型包括：

• gpt-5.5
• gpt-5.4-mini
• claude-opus-4-7
• claude-sonnet-4-6
• claude-haiku-4-5
• gemini-2.5-pro