结果查询

更新时间:

hidden = true

该文档为 V1 版本接口。V2 版本接口已上线，请求/响应结构更清晰，推荐使用：结果查询（V2）。

请求规范

  • 请求 URL:

https://isafe.ilivedata.com/api/v1/image/check/async/result

  • 接口描述:

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

  • HTTP 请求Header:
Header 值 描述
Content-Type application/json;charset=UTF-8 请求体类型
Accept application/json;charset=UTF-8 接受的返回类型
X-AppId 项目或应用的唯一标识符
X-TimeStamp 请求的UTC时间戳。需要把时间戳按W3C标准格式化，例如: 2010-01-31T23:59:59Z. (http://www.w3.org/TR/xmlschema-2/#dateTime)。
Authorization 签名值

  • 请求方法:POST

  • 请求体JSON对象：

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

  • 请求体示例:

    JSON request

  {
    "taskId": "us_******************"
  }
  • 请求签名:

该接口需要在请求 Header 中传入 Authorization 签名。签名计算规则请参考帮助中心的请求签名。

HTTP响应

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

结果为JSON格式，请参考以下示例。

  • HTTP响应

返回json字段说明：

参数
类型
描述
errorCode Number 错误码：0表示成功
errorMessage String 错误消息
imageSpams json数组 结果信息
code Number 状态码，定义为：0:检测成功，1:图片下载失败，2:图片格式错误，3:其他，4:检测中，5:taskId不存在
result Number 0:通过，1:建议审核，2:不通过
taskId String 任务ID

imageSpams:

参数
类型
描述
code Number 状态码，定义为：0:检测成功，1:图片下载失败，2:图片格式错误，3:其他
result Number 0:通过，1:建议审核，2:不通过
tags json数组 分类信息

extraInfo：

参数 类型 描述
cartoonScore Number 画风为卡通的分数，0-100，越高越接近卡通画风
genderResult json数组 人脸性别及其对应置信度
子参数 类型 描述
gender String male/female
confidence Number 性别置信度
numHuman Number 人体检测检出数
numFace Number 人脸检测检出数

tags:

参数
类型
描述
tag Number 一级分类信息代码
100:涉政, 110:暴恐, 120:违禁, 130:色情, 140:性感, 150:广告, 160:涉价值观, 180:未成年保护, 200:二维码, 230:无人脸挂机, 232:图片质量, 300:图标, 400:图文, 666:恶心, 800:标签, 888:人脸对比, 900:其他, 999:用户自定义
level Number 分类级别，0：正常，1：疑似，2：异常
confidence Number 置信度分数，0-100之间取值，100为置信度最高，0为置信度最低。若level为疑似或异常，置信度越大，说明垃圾的可能性越高
tagName String 检测图片命中的一级类型名称
tagNameEn String 检测图片命中的一级类型名称（英文）
subTags json数组 敏感信息的二级分类
wordList 字符串数组 命中图文时返回（tag=400）

subTags:

参数
类型
描述
subTag Number 二级分类详细编码请参考 分类编码对照表
subTagName String 检测图片命中的二级类型名称
subTagNameEn String 检测图片命中的二级类型名称（英文）
level Number 分类级别，0：正常，1：疑似，2：异常
confidence Number 置信度分数，0-100之间取值，100为置信度最高，0为置信度最低。若level为疑似或异常，置信度越大，说明垃圾的可能性越高
wordList 字符串数组 命中图文时返回（tag=400）

  • 返回结果示例:

    {
    "errorCode": 0,
    "code": 0,
    "result": 2,
    "imageSpams": [
        {
            "code": 0,
            "result": 2,
            "tags": [
                {
                    "tag": 110,
                    "level": 2,
                    "confidence": 95,
                    "tagName": "暴恐",
                    "tagNameEn": "Violence",
                    "subTags": [
                        {
                            "subTag": 110008,
                            "subTagName": "枪支器械",
                            "subTagNameEn": "guns and knife",
                            "level": 2,
                            "confidence": 95
                        }
                    ]
                }
            ]
        }
    ],
    "gender": [

    ],
    "taskId": "us_d56b5c2d38614be3bf1a1e98663d3c29_1653017203620",
    "extraInfo": {
        "cartoonScore": 7,
        "genderResult": [

        ],
        "numHuman": 0,
        "numFace": 0
    }
}

错误码

详见帮助中心的常见异常码