跳到主要内容

错误排查

先记录 HTTP 状态码、错误体中的 code 或 type，以及响应中的 request-id 或 x-request-id。不要在截图或工单中包含 API Key。

401：认证失败​

检查：

  1. Key 是否完整、是否已在控制台吊销。
  2. OpenAI 接口是否使用 Authorization: Bearer ...。
  3. Anthropic 接口的 x-api-key 与 Bearer 是否冲突。
  4. Key 是否被意外放进 URL；敏感查询参数会被拒绝。

不要通过在聊天中粘贴完整 Key 来验证。直接吊销并新建通常更安全。

402 / 429：余额或额度不足​

  • insufficient_quota：账户可用余额不足以预留本次请求的费用上限。
  • rate_limit_error：可能来自网关或上游限速，请参考 retry-after 后重试。

当前没有在线支付或自动充值。需要由管理员在控制台人工调整余额。

404：模型不存在​

确认模型名位于模型列表的受支持范围。模型可能在上游可见，但 尚未由管理员创建并启用价格版本；此时同样无法调用。

400：流式请求缺少用量​

Chat Completions 流式请求需设置：

{
  "stream": true,
  "stream_options": {"include_usage": true}
}

错误码为 stream_usage_required 时，补上该字段后重试。

501：Responses API 不可用​

当前默认 DeepSeek 上游没有公开 /v1/responses，因此生产环境默认关闭。 请改用 /v1/chat/completions。

Claude Code 仍在使用旧服务​

查看环境变量：

env | grep -E '^ANTHROPIC_(AUTH_TOKEN|API_KEY|BASE_URL)='

ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 的优先级可能高于 apiKeyHelper。一键配置工具不会擅自删除它们。确认来源后，从对应的 Shell 配置文件或启动环境中移除旧值，再重新打开终端。

查看安装器状态：

curl -fsSL https://yijue.ai/docs/install/yijue-claude-setup.py | python3 - status

Claude Code 提示 count_tokens​

/v1/messages/count_tokens 暂未实现。Claude Code 通常会本地估算；如果第三方 客户端强制依赖该接口，目前不在兼容范围内。

收集最小诊断信息​

可以提供：

  • UTC 时间与请求路径，不含查询中的敏感值；
  • HTTP 状态码、错误 code/type；
  • request-id / x-request-id；
  • 客户端名称与版本；
  • 是否为流式请求。

不要提供完整 API Key、Authorization 请求头、系统钥匙串内容或包含 Key 的环境 变量输出。