先确认 HTTP 状态码,再查看响应中的错误说明。
| 状态码 | 常见原因 | 处理方式 |
|---|---|---|
| 400 | 请求格式或参数不受支持 | 检查模型、messages 与参数类型 |
| 401 | 密钥无效或缺失 | 确认 Bearer 密钥与空格 |
| 403 | 权限或分组受限 | 检查密钥状态与模型分组 |
| 404 | 模型或接口不存在 | 检查 Base URL 与模型 ID |
| 429 | 速率、额度或并发限制 | 检查额度并降低并发,按返回信息退避 |
| 502 / 503 | 上游不可用或未配置 | 查看状态页并联系管理员 |
提交排障信息
记录请求时间、模型 ID、HTTP 状态码和错误消息。不要在需求单中包含 API 密钥、密码或完整敏感提示词。
检查服务状态