错误代码
以下为常见 API 错误码说明,建议在客户端按错误码做可恢复处理和重试策略。
| 错误码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求参数不正确 | 请参考文档以输入正确的请求参数 |
| 401 | 认证无效 | 请确保使用正确的API Key |
| 402 | 账户余额不足 | 请先充值后重试 |
| 404 | 请求的内容未找到 | 请参考文档以输入正确的请求参数 |
| 422 | 请求参数不正确 | 请参考文档以输入正确的请求参数 |
| 429 | 任务的并发数达到上限 | 请稍后重试 |
| 451 | 参数没有通过安审 | 请修改请求参数 |
| 500 | 我们的服务出现了问题 | 稍后重试您的请求,如果问题仍然存在,请联系我们 |
建议重试策略
- 对
429和500使用重试。 - 首次重试建议延迟 1 秒,后续按 2 倍递增,最多重试 3 次。
- 对
400、401这类错误不要盲目重试,应先修正请求。
错误响应示例
HTTP/1.1 401 Unauthorized
Content-Type: application/json
{
"detail": "Invalid API Key"
}
