错误码
说明 api-service 当前统一响应 code，以及视频任务 result.error 的区别。
最后更新: 2026-08-06错误响应格式
{
"code": "FAIL",
"msg": "可用额度不足"
}当前统一响应 code
| HTTP | 业务 code | 是否建议重试 | 说明 |
|---|---|---|---|
| 200 | SUCCESS | 否 | 接口业务操作成功，读取 result；分页接口同时读取 page。 |
| 200 | FAIL | 先修正原因 | 参数校验或业务条件不满足，具体原因读取 msg。当前没有为余额、模型、素材等分别定义对外 code。 |
| 200 | UNAUTHORIZED | 否 | Bearer API Key 缺失、格式不合法、未找到、已禁用，或所属用户不是 ACTIVE。 |
| 200 | INTERNAL_SERVER_ERROR | 是 | 未处理的服务端异常。请携带 X-Request-Id 联系技术支持。 |
任务 error 对象
查询任务接口本身成功时，统一响应 code 仍为 SUCCESS。若 result.status 为 FAILED、EXPIRED、SUBMIT_UNKNOWN 或 BILLING_PENDING，result.error 才描述异步任务的最终或异常状态。公开 error.code 例如 EXECUTION_TIMEOUT、TASK_PROCESSING_FAILED、PROCESSING_CHANNEL_UNAVAILABLE、TASK_STATUS_CONFIRMING 或 TASK_SETTLEMENT_PENDING。
重试建议
- code=FAIL 时先根据 msg 修正参数、配置、账户或余额问题，不要盲目重试。
- code=UNAUTHORIZED 时更换有效的 ACTIVE API Key，不要继续自动重试。
- code=INTERNAL_SERVER_ERROR 时使用指数退避，并保留响应头 X-Request-Id。
- 创建任务接口没有幂等键，请求超时后直接重试可能创建并冻结两个任务。
- 联系技术支持时提供 taskId、result.requestId、X-Request-Id 和发生时间，不要发送完整 API Key。