GetImageDefectDetectionTaskResult - 查询图片瑕疵检测任务结果-AI 数智鉴密(AI DeepSign )-阿里云帮助中心

接口说明

请求说明

本接口用于查询通过 CreateImageDefectDetectionTask 创建的图片瑕疵检测任务的执行状态和结果。请确保遵循以下轮询约定：

建议轮询间隔不小于 5 秒：当任务处于 running 状态时，每次调用此接口都会触发一次真实的下游续查。过于频繁的轮询只会增加系统负担且不会加快结果返回速度。
总超时 30 分钟：如果在任务创建后 30 分钟内仍未收到结果，服务端会将任务标记为 failed，并附带消息 poll timeout: no result within 30m0s。此后，该任务不再向下游发起新的查询请求。
当任务达到 succeeded 或 failed 终态后，后续对该接口的调用将直接返回已存储的结果，而不会再触发额外的下游处理。

注意，Result 字段中的内容可能是经过 HTML 转义的 JSON 格式数据，在解析前需要先进行反转义处理。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	幂等参数	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
TaskId	string	是	任务 ID，由 `CreateImageDefectDetectionTask` 返回。	f47ac10b-58cc-4372-a567-0e02b2c3d479

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
Success	boolean	请求是否成功。	true
Message	string	任务失败时的失败原因。仅在 `Status` 为 `failed` 时返回。	poll timeout: no result within 30m0s
HttpStatusCode	integer	HTTP 状态码。请求成功时返回 200。	200
Code	string	业务错误码。请求成功时返回 "OK"。	OK
TaskId	string	任务 ID。	f47ac10b-58cc-4372-a567-0e02b2c3d479
Status	string	任务状态。取值： `running`（执行中） `succeeded`（已完成） `failed`（失败）	succeeded
AbnormalityScore	number	画面异常分数。范围 0~1，值越高表示画面异常越严重。仅在 `Status` 为 `succeeded` 时返回。	0.9667
AbnormalityReason	string	画面异常原因。仅在 `Status` 为 `succeeded` 时返回。	画面主体模糊
RiskCode	string	风险码。该字段暂废弃，无意义，是否异常需要通过 AbnormalityScore、AbnormalityReason、Result 等字段判断	"0"
Result	string	下游检测结果原文（JSON 字符串）。`AbnormalityScore` / `AbnormalityReason` 即由该原文解析而来；保留原文便于排错与透传上游新增字段。	{"image_abnormality_score": 0.75, "image_abnormality_reason": "画面主体模糊"}

示例

正常返回示例

JSON格式

{
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "Success": true,
  "Message": "poll timeout: no result within 30m0s",
  "HttpStatusCode": 200,
  "Code": "OK",
  "TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "Status": "succeeded",
  "AbnormalityScore": 0.9667,
  "AbnormalityReason": "画面主体模糊",
  "RiskCode": "\"0\"",
  "Result": "{\"image_abnormality_score\": 0.75, \"image_abnormality_reason\": \"画面主体模糊\"}"
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。