错误与重试
简介
错误返回 error.code。先按 HTTP 状态处理，再针对具体错误码反应；不要对所有错误统一重试。校验失败（400 invalid_input）还会带 error.message 说明具体哪里需要修改，能定位时再带 error.field 指出出错的字段或请求头；返回该状态时不会提交任务、不会扣费。
| 状态 | 含义 | 常见错误码 |
|---|---|---|
| 400 | 参数或素材无效。 | invalid_input |
| 401 | 缺少或无效的密钥。 | unauthorized |
| 402 | 积分不足。 | insufficient_credits |
| 403 | 来源或账号无权限。 | forbidden |
| 404 | 来源未知或任务归属不符。 | not_found |
| 409 | 报价、请求或幂等冲突。 | conflict |
| 429 | 并发或限流。 | concurrency_limit_reached |
| 503 | 配置或服务暂不可用。 | — |
- 超时、连接中断或 5xx 响应都不代表失败。
- 用已保存的 UUID 查询任务；404 不代表上游从未收到请求。
- GET 查询可有界退避重试；
pending任务交由平台核对。
结果未知时，绝不要用新的幂等键盲目重提收费生成。