任务处理是否成功, 需要结合HTTP请求响应状态码和任务状态码(HTTP 响应报文中的 state 字段)进行判断。
任务结果数据结构示例
{
"status": 200,
"data": {
"completed_at": 1698387307,
"created_at": 1698387304,
"image": "yourimage",
"processed_at": 1698387303,
"progress": 100,
"return_type": 1,
"state": 1, //任务状态码。1 为成功,大于 1 为处理中,小于 0 为失败。
"state_detail": "Complete",
"task_id": "5f461cfc-ec4b-446b-aa31-57afa8fb5256"
}
}
HTTP 响应状态码
| HTTP 响应状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 客户端参数传递错误。 请检查参数是否缺失或值是否正确 |
| 401 | 认证失败。 请检查X-API-KEY是否正确或者服务是否开通 |
| 404 | 请求的URL或资源不存在。 请检查URL 或 URL中的 task id 是否正确 |
| 413 | 上传的文件超出大小限制。 请检查文件大小,参见各个服务的最大文件限制 |
| 429 | 请求频率超出QPS限制(默认QPS为2)。请放缓请求速率,或者联系商务提升QPS限制 |
| 500 | 服务端异常。请反馈给商务或技术对接人员 |
任务状态码
任务状态码为HTTP 响应报文中的 state 字段,具体含义如下:
| 任务状态码 | 说明 |
|---|---|
| -17 | 处理失败,非法提示词 |
| -16 | 处理失败,使用第三方检测发现违规 |
| -15 | 处理失败,资源不足 |
| -14 | 处理失败,输入图片内容不符合要求 |
| -13 | 处理失败,任务异常被取消了 |
| -11 | 处理失败,结果是空的 |
| -10 | 处理失败,内部检测非法 |
| -9 | 处理失败,内部程序循环处理失败 |
| -8 | 处理超时,最长处理时间 180 秒 |
| -7 | 无效图片文件(比如图片损坏、格式不对等) |
| -5 | image_url 图片超出大小(30MB) |
| -3 | 服务器下载图片文件失败,请检查图片URL是否可用 |
| -2 | 修复完成,上传 OSS 失败 |
| -1 | 修复失败 |
| 0 | 排队中,修复任务正在队列中 |
| 1 | 完成,修复成功 |
| 2 | 准备中 |
| 3 | 等待中 |
| 4 | 处理中,修复正在进行 |
| 5 | 内部在发布处理中 |
| 6 | 处理中,内部循环处理中 |