错误与排查

排查顺序

1. 记录 HTTP 状态码和响应中的请求 ID。
2. 确认基础地址、接口路径和模型名称没有多余字符。
3. 检查密钥是否有效、余额是否充足。
4. 使用最小请求体重试，排除工具调用或上下文长度影响。
5. 仍无法解决时，携带时间、模型名称和请求 ID 联系支持。

常见状态码

状态码	常见原因	建议
400	请求参数或消息格式不正确	缩减为最小请求并核对字段
401	密钥缺失、错误或失效	检查认证头并轮换密钥
403	账户或模型没有访问权限	核对账户与模型可用范围
429	触发速率、额度或并发限制	指数退避后重试
5xx	上游或网关暂时异常	保留请求 ID，稍后重试

提交排查信息时

请勿发送完整 API Key、账户凭据或含敏感研究数据的请求正文。