结果查询

更新时间:

接口概览

POSThttps://isafe.ilivedata.com/api/v2/image/check/async/result

该接口用于获取图片异步检测结果。

请求参数

请求头

Header 值 描述
Content-Type application/json;charset=UTF-8 请求体类型
Accept application/json;charset=UTF-8 接受的返回类型
X-AppId — 项目或应用的唯一标识符
X-TimeStamp — 请求发起时的 UTC 时间，采用 W3C 格式。
格式示例：2026-09-30T02:30:00Z，实际请求需使用当前时间。
Authorization — 签名值

请求体

参数 类型 是否必需 描述
taskId String 必需 提交图片检测任务后返回的任务 ID

请求示例

{
  "taskId": "ap_99b2bf004d4a4591bfedbba9574e74d4_1702882338368"
}

请求签名

签名计算规则见帮助中心的请求签名。本接口使用以下参数：

签名参数 值
HTTPMethod POST
HostHeaderInLowercase isafe.ilivedata.com
HTTPRequestURI /api/v2/image/check/async/result

HTTP 响应

Content-Type: application/json;charset=UTF-8

结果为 JSON 格式。响应结构同 同步单条检测（V2）- HTTP 响应，其中 errorCode 在结果查询场景下额外包含以下取值：

errorCode 描述
0 检测成功
100001 图片下载失败
100002 图片格式错误
100004 检测中
100005 taskId 不存在

响应示例

{
  "errorCode": 0,
  "result": 2,
  "taskId": "ap_d56b5c2d38614be3bf1a1e98663d3c29_1653017203620",
  "imageSpams": {
    "tags": [
      {
        "tag": 110,
        "level": 2,
        "confidence": 95,
        "nameZh": "暴恐",
        "nameEn": "Violence",
        "subTags": [
          {
            "subTag": 110008,
            "level": 2,
            "confidence": 95,
            "nameZh": "枪支器械",
            "nameEn": "guns and knife"
          }
        ]
      }
    ]
  },
  "personInfo": {
    "human": { "number": 0 },
    "face": { "number": 0 }
  },
  "extra": {}
}

错误码

详见帮助中心的通用错误码