错误处理
| HTTP 状态码 | 含义 | 建议处理 |
|---|---|---|
400 | 请求参数、格式或模型能力不匹配 | 检查请求 Schema、字段类型和模型能力 |
401 | API Key 缺失、无效或已过期 | 检查 Bearer 鉴权头并更换有效密钥 |
403 | 当前用户、分组或 Token 无权调用 | 检查账户和 Token 限制 |
404 | 接口、模型或任务不存在 | 检查路径和 GET /v1/models 返回 |
429 | 请求频率过高或额度不足 | 降低并发、指数退避并检查余额 |
500 | 平台内部异常 | 稍后重试并保留请求时间 |
502 | 上游暂时不可用或返回异常 | 有限重试，持续失败时联系支持人员 |
重试建议
429、500 和 502 进行有限次数重试。400、401、403 等确定性错误应先修正请求或权限，不要盲目重试。service@zhuanqicloud.com。