任务处理是否成功, 需要结合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 字段,具体含义如下:


任务状态码说明
-8处理超时,最长处理时间30秒
-7

无效图片文件(比如图片损坏、格式不对等)

-5图片超出大小(15MB)
-3服务器下载图片文件失败,请检查图片URL是否可用
-2任务处理完成,但任务结果上传OSS失败
-1任务处理失败
0任务正在队列中
1任务处理完成
2准备中
3等待中
4处理中