错误与排查

先做这三个检查

1. 请求域名是否正确，路径是否重复包含 /v1。
2. API Key 是否完整、启用且余额充足。
3. 请求模型是否出现在当前密钥的 GET /v1/models 返回中。

这三项能解决大部分问题。

常见状态码

状态码	常见原因	处理方式
400	请求体或模型参数不符合协议	对照接口格式检查 JSON 与模型 ID
401	缺少、错误或已失效的 API Key	检查请求头格式，重新创建密钥
403	密钥无权限使用该模型，或分组受限	在控制台检查密钥的模型限制与所属分组
404	路径错误，或当前不支持该端点	检查 Base URL 是否重复 /v1
429	请求频率、Token 或并发达到限制	降低并发，等待窗口恢复
500	网关内部错误	记录请求时间与请求 ID，到 QQ 群反馈
502 / 503	上游服务暂时不可用	稍后重试，持续出现到 QQ 群反馈

按现象排查

模型列表正常，但调用失败

• 确认调用使用的模型 ID 与列表返回完全一致（大小写、连字符）。
• 检查密钥余额与额度上限。
• 在控制台 日志 页面查看该条请求的上游返回详情。
• 持续失败时记录请求 ID 反馈。

流式响应没有实时输出

确认客户端已启用流式模式，并且没有把响应当作普通 JSON 一次性读取。用 curl 验证时记得加 -N：

curl -N https://api.allenyeahger.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-id","stream":true,"messages":[{"role":"user","content":"hi"}]}'

如果 curl 有实时输出但客户端没有，问题在客户端或中间的缓冲代理。

额度消耗异常

• 在 日志 页面按令牌、按模型筛选，定位消耗来源。
• 检查是否有脚本在循环调用；必要时先禁用该密钥。
• 为该密钥设置额度上限，避免继续扩大损失。

Codex 粘性会话异常

先创建新会话重试，确认没有复用旧会话缓存。持续出现请提供发生时间到 QQ 群反馈。

Claude Code 报 authentication_error

检查 ANTHROPIC_AUTH_TOKEN 是否完整，是否有多余空格或换行；确认 ANTHROPIC_BASE_URL 不带 /v1。

在群里反馈时提供什么

• 发生时间和时区（北京时间）；
• 请求路径与模型 ID；
• HTTP 状态码和错误信息；
• 控制台日志中的请求 ID；
• 不含真实 API Key 的最小复现请求。

QQ 群：1125021051

反馈模板见加入 QQ 群。