错误码

请求失败时，先查看 HTTP 状态码，再读取响应体中的错误信息。状态码用于判断问题类别，响应内容用于定位当前 Key、分组、模型、路径或额度问题。

常见状态码

HTTP 状态码	问题类别	处理方式
`400`	请求参数错误或上游拒绝	结合错误类型和响应内容，检查参数或上游返回的原因
`401`	鉴权失败	检查 Key 是否完整有效，以及是否使用当前协议的认证头
`403`	权限或额度问题	根据响应信息检查分组适用范围、账户余额和套餐额度
`404`	路径或模型不可用	检查请求地址、模型 ID 和当前 Key 所属分组的模型列表
`413`	请求内容过大	缩短上下文，减少历史消息或附件大小
`429`	并发或请求频率受限	降低并发与请求频率，等待后再试
`500` / `502` / `503` / `504`	服务、上游或网络异常	查看返回信息，稍后重试；持续失败时提交工单

按当前接口协议检查请求头：

确认 Key 已完整复制、仍然有效，工具或部署环境也使用了最新配置。

确认当前 Key 绑定的分组包含目标模型，并适用于当前工具或直接 API 调用。

例如，下面是 Anthropic 格式的一种模型不可用响应：

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Model \"claude-opus-5-5\" is not available for this group"
  }
}

处理时核对 Key 与分组，再检查模型名称。AIGoCode 的 OpenAI 协议模型同时支持 Responses 和 Chat Completions；切换这两个入口时，按各自格式调整请求与响应解析即可。

Grok 支持双协议；GLM、Kimi、DeepSeek 等模型使用 Anthropic 协议。模型厂商与接口协议分别确认，见「API 兼容协议」。

出现 404 时，核对 SDK 填写的 Base URL 和 HTTP 完整请求路径，尤其检查 /v1、/v1beta 是否重复或缺失。

出现 400 时，核对当前入口使用的输入格式：

接口	输入格式
OpenAI Responses	`input`
OpenAI Chat Completions	`messages`
Anthropic Messages	`messages`；`max_tokens` 用于控制输出上限
Gemini	`contents`，模型 ID 写在请求路径中

出现 413 时，减少输入规模后重新提交。

余额或额度相关报错，应到控制台核对套餐有效期、当周可用额度和灵活余额。调用优先消耗套餐额度，套餐额度不足、当周额度用完或套餐到期后，改扣灵活额度。

429 可能与并发或请求频率有关。当前套餐并发规则为：

并发是同时进行的请求数，不等于每分钟请求数。多个客户端或 Agent 会话需要合计考虑，避免自动重试继续堆高并发。

如果 curl 返回 (35)、(28) 等连接错误且没有 HTTP 状态码，先检查本机网络、代理和 TLS 连接。Windows PowerShell 与 curl 使用的代理配置可能不同，排查时分别核对。

临时异常时，逐步增加等待时间并限制重试次数。配置、权限或模型选择有误时，先修正原因，再重新请求。

超时或流式中断后，先核对是否已收到部分结果，以及「使用统计」中的调用记录，再决定是否重新生成。消费以实际请求记录为准。

通过工单提供以下信息，方便定位：

提交前隐藏 API Key 和输入中的敏感内容。