错误码
排查鉴权、计费、参数校验和服务端错误。
错误响应与成功响应使用相同的 { code, msg, data } 外层结构。msg 字段会给出可执行的错误原因。
| 状态码 | 含义 | 处理方式 |
|---|---|---|
401 | API Key 缺失或无效 | 检查 Authorization 请求头 |
402 | credits 不足 | 充值后重试，错误信息会说明所需和当前余额 |
403 | 账号被停用 | 联系支持人员 |
404 | 任务不存在 | 检查 taskId，客户只能读取自己的任务 |
422 | 参数不合法 | 根据 msg 修正请求 |
429 | 超出频率限制 | 等待 Retry-After 响应头给出的秒数后重试 |
500 | 服务端或上游异常 | 稍后重试，已提交且最终失败的任务会退款 |
频率限制
每个账号通过 createTask 每 10 秒最多新建 20 个任务，账号下所有 API Key 共用这个额度。超出的请求返回 429 并附带 Retry-After 响应头，不排队，也不扣费。用 recordInfo 查询任务不受限制。
如果经常遇到 429，可以联系我们申请提额。
重试建议
对于临时性的 500 错误，可以使用指数退避重试。429 按 Retry-After 的秒数等待后再重试。401、402、403 和 422 错误需要先修复请求或账号问题，不要直接重试。