调接口报错怎么办？鉴权失败、频率超限、余额不足逐个排查

按错误码排查

• 401 Unauthorized：密钥无效或未填。重新复制密钥，确认请求头格式正确。
• 403 Forbidden：密钥无该模型 / 接口权限，检查模型代号与账户权限。
• 429 Too Many Requests：触发频率限制。降低并发，按退避重试（见限流文章）。
• 402 / 余额不足：账户额度或余额不够，前往充值或升级套餐。
• 400 Bad Request：参数错误，检查 model、messages 等字段格式。
• 5xx：服务端异常，稍后重试；持续出现请联系支持并附上请求 ID。

通用排查清单

1. 确认 API 地址与模型代号正确。
2. 确认密钥有效且未过期 / 吊销。
3. 查看返回体里的 error 字段与 message，通常包含原因。
4. 保留响应头中的请求 ID，便于工单排查。

常见问题

• 报 401：最常见是密钥前后有空格，或用了错误环境的密钥。
• 报 404：多为模型代号拼写错误或该接口路径不对。

错误码与返回结构以官方文档为准。