轮询模式
2024.12.02 17:19:12
内容安全图片异步检测或人工审核的结果，客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥，只能选取一种模式进行结果获取。
接口说明
该接口返回图片经过人工审核的结果或者图片异步机器检测结果，需要客户通过该接口进行定时轮询获取，当提交检测接口参数callbackUrl为空时，表示结果通过该接口获取，结果可以根据提交检测时返回的taskId对应。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权
接入说明
- 获取结果后，下次调用，不会再次返回之前获取过的结果
- 接口一次最多返回200个结果，人工审核结果数据默认保留7天，7天不获取会失效，异步检测结果默认保留4小时，超过4小时不获取会失效
- 接口请求频率建议1s一次，过快服务器会拒绝处理，客户可以根据业务需求进行适当调整
- 异步检测一般10s内会检测完成，异步机器检测结果建议尽快获取
接口耗时
结果获取接口的响应很快，正常50ms内返回结果，业务方根据需求适当调整超时时间，建议为1s。
历史版本
请求
请求地址
| 名称 | 值 |
|---|---|
| HTTP URL | http://as.dun.163.com/v5/image/callback/results |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 描述 |
|---|---|---|
| Content-Type | String | 固定值："application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成。
公共参数
公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数
业务参数
| 名称 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| version | String | 是 | 4 | 接口版本v5 |
| yidunRequestId | String | 否 | 64 | 幂等参数说明 |
请求体示例
version=v5&signature=xxx&secretId=xxx&businessId=xxx×tamp=1646984669446&nonce=12353
响应
该接口可以返回人工审核结果或异步机器检测结果，两类结果响应字段有一定区分，可根据resultType字段进行区分解析，为了方便阅读，下面响应结果分为：人工审核响应结果以及异步检测相应结果。
人工审核响应结果
响应字段如下，响应公共字段已省略，详细见响应公共字段，resultType为2时表示人工审核结果，详细字段信息如下：
| 名称 | 类型 | 是否返回 | 描述 |
|---|---|---|---|
| result | Object[] | 是 | 图片人工审核结果 |
| ∟ antispam | Object | 是 | 图片内容安全检测结果 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，2：不通过 |
| ∟ remark | String | 否 | 人审备注信息 |
| ∟ resultType | Number | 是 | 结果类型，1：机器结果，2：人审结果 |
| ∟ labels | Object[] | 是 | 命中的分类信息 |
| ∟ label | Number | 是 | 分类信息，100：色情，110：性感低俗，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，800：恶心类，900：其他，1100：涉价值观 |
| ∟ level | Number | 是 | 命中级别，示例值：1：嫌疑，2：不通过，0：正常 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低。若level为正常，置信度越大，说明正常的可能性越高。若level为嫌疑或不通过，置信度越大，说明垃圾的可能性越高 |
| ∟ censorLabels | Object[] | 否 | 审核标签信息 |
| ∟ code | String | 是 | 审核标签唯一编号 |
| ∟ desc | String | 否 | 选择标签填写的备注内容 |
| ∟ customCode | String | 否 | 自定义审核标签编号 |
| ∟ name | String | 是 | 审核标签的名称 |
| ∟overAllMarkDesc | String | 是 | 整体审核备注 |
| ∟detailMarks | Object[] | 是 | 细节标注 |
| ∟ position | Object[] | 是 | 标注标签列表 |
| ∟ x | folat | 是 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y | float | 是 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟censorLabels | Object[] | 是 | 标注备注 |
| ∟ code | String | 是 | 审核标签唯一编号 |
| ∟ desc | String | 否 | 选择标签填写的备注内容 |
| ∟ name | String | 是 | 审核标签的名称 |
| ∟ desc | String | 是 | 选择标签填写的备注内容 |
| ∟ censorSource | Number | 是 | 审核来源，0：易盾人审，1：客户审核，2：易盾机审，3：用户质检，4：易盾质检 |
| ∟ censorRound | Number | 是 | 审核轮数，普通审核轮数为0。高级审核轮数如下，1：第1轮人审，2：第2轮人审，以此类推，saas人工审核模板配置请参考人工审核模板设置说明文档。若您使用易盾人工审核服务，非必要情况下不要对该字段做解析依赖。人审团队为了您的审核质量，会自发的在某些高风险时段进行多轮审核来保证交付质量，所以该字段可能会在不通知到您的情况下变化，感谢您的配合，有任何问题可以随时联系我们 |
| ∟ censorTime | Number | 是 | 审核时间 |
人工审核响应体示例
{
"code": 200,
"msg": "ok",
"result": [
{
"antispam": {
"taskId": "a2e53718f9c348d09206e4671304ca7c",
"suggestion": 2,
"remark"："人审备注信息，填写才会返回",
"dataId": "dataId",
"name": "name",
"labels": [
{
"label": 400,
"level": 2,
"rate": 1.0
},
{
"label": 500,
"level": 0,
"rate": 1.0
},
{
"label": 300,
"level": 0,
"rate": 1.0
}
],
"censorLabels": [
{
"code": "审核标签编码",
"customCode"："自定义标签编码",
"name": "审核标签名称",
"desc": "风景"
}
],
"resultType": 2,
"censorTime": 1622036595467,
"censorSource": 0,
"censorRound": 1
}
}
]
}
异步检测响应结果
响应字段如下，响应公共字段已省略，详细见响应公共字段，resultType为1时表示异步机器检测结果，详细字段信息如下：
| 名称 | 类型 | 是否返回 | 描述 |
|---|---|---|---|
| result | Object[] | 是 | 图片检测结果 |
| ∟ antispam | Object | 是 | 图片内容安全检测结果 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ status | Number | 是 | 检测状态：2：检测成功，3：检测失败 |
| ∟ imgMd5 | String | 是 | 图片MD5 |
| ∟ customAction | Number | 否 | 自定义动作，0：通过，2：不通过。customAction字段用于saas审核系统-机审标准集中的自定义调度功能，将易盾机器检测嫌疑结果通过配置映射为业务自己的自定义动作，可参考图片流程：https://nos.netease.com/yidun/bceb8815e1f50c2339899976e9a2ec28.png |
| ∟ failureReason | Number | 否 | 检测失败原因，当status为3（检测失败）时返回：610 图片下载失败、620 图片格式错误、630 其他 |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，1：嫌疑，2：不通过 |
| ∟ label | Number | 是 | 命中分类，分类信息，100：色情，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂，700：灌水，800：恶心类，900：其他，1100：涉价值观 |
| ∟ secondLabel | String | 否 | 命中二级标签细分类 |
| ∟ thirdLabel | String | 否 | 命中三级标签细分类 |
| ∟ suggestionLevel | Number | 否 | 嫌疑级别，针对部分定制策略支持命中嫌疑时返回，1：低嫌疑，2：高嫌疑，对通用策略、模型结果暂不支持，v5.2版本新增，默认不返回，如果需要返回请联系策略经理配置 |
| ∟ resultType | Number | 是 | 结果类型，1：机器结果，2：人审结果 |
| ∟ frameSize | Number | 是 | 长图、gif图片拆帧后的分帧数，默认为1 |
| ∟ url | String | 否 | 易盾转存图片oss地址。默认有效期6小时 |
| ∟ hidden | Boolean | 否 | 是否有隐藏文件，返回需要单独开启，请联系策略经理 |
| ∟ hiddenFormat | String | 否 | 隐藏文件的格式：mpegts，返回需要单独开启，请联系策略经理 |
| ∟ labels | Object[] | 是 | 命中的分类信息 |
| ∟ label | Number | 是 | 分类信息，100：色情，110：性感低俗，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，800：恶心类，900：其他，1100：涉价值观 |
| ∟ level | Number | 是 | 命中级别，示例值：1：嫌疑，2：不通过，0：正常 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低。若level为正常，置信度越大，说明正常的可能性越高。若level为嫌疑或不通过，置信度越大，说明垃圾的可能性越高 |
| ∟ subLabels | Object[] | 是 | 细分类信息，可能包含多个 |
| ∟ hitStrategy | Number | 是 | 用于区分本次机器审核的命中原因：0：图片内容，1：图片上的文字 |
| ∟ subLabel | String | 是 | 细分类，详细编码请参考下方对应细分类编码 对照表 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低 |
| ∟ details | Object | 否 | 命中的详细对象信息 |
| ∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
| ∟ word | String | 是 | 敏感词内容 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ libInfos | Object[] | 是 | 命中的自定义图片名单信息 |
| ∟ type | Number | 是 | 1：自定义用户名单，2：自定义ip名单，3：自定义设备名单，4：自定义图片名单，目前只支持返回4自定义图片名单 |
| ∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
| ∟ releaseTime | Number | 是 | 名单解封时间，时间戳单位毫秒 |
| ∟ hitCount | Number | 是 | 历史针对该数据源图片命中所有次数 |
| ∟ value | String | 否 | 图片中包含的可识别内容 |
| ∟ group | String | 否 | value对应的分组名称，用于对value的解释 |
| ∟ hitInfos | Object[] | 是 | 命中的线索信息 |
| ∟ value | String | 是 | 图片中包含的可识别内容 |
| ∟ group | String | 否 | value对应的分组名称，用于对value的解释 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ anticheat | Object | 否 | 命中的反作弊信息 |
| ∟ hitType | Number | 是 | 反作弊命中类型，详见[hitType返回码及含义表] |
| ∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
| ∟ name | String | 是 | 规则名 |
| ∟ ocr | Object | 否 | OCR结果信息，OCR功能需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ height | Number | 是 | 图片高度，单位像素 |
| ∟ width | Number | 是 | 图片宽度，单位像素 |
| ∟ frameSize | Number | 是 | 长图、gif图片拆帧后的分帧数，默认为1 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ content | String | 是 | 该图片中所有的文字信息集合 |
| ∟ lineContents | Object[] | 是 | OCR行信息 |
| ∟ lineContent | String | 是 | 每行的文字信息 |
| ∟ lang | String | 否 | 语种信息 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ face | Object | 否 | 人脸检测信息，人脸检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ faceNumber | Number | 是 | 该图片中包含的人脸个数 |
| ∟ deepfake | Integer | 否 | 是否有伪造人脸，0：无，1：有 ；如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ faceContents | Object[] | 是 | 人脸详细信息 |
| ∟ name | String | 是 | 图片中出现的人脸名字，未识别则为空。该字段可识别明星、政治人物等人脸信息，用于落马官员/劣迹艺人检测，或明星头像/政治头像检测 |
| ∟ gender | String | 否 | 人脸性别，值为男（male）、女（female）；不可识别则为空 |
| ∟ age | Number | 否 | 人脸年龄，值为具体年龄（age）；不可识别则为空 |
| ∟ type | String | 否 | 人脸类型，包含卡通脸（cartoon）、普通（normal） |
| ∟ category | String | 否 | 人物分类，包含名人（star）、普通（normal）、海外娱乐明星（overseaEntertainmentStar）、海外体育明星（overseaSportStar）、海外政客（overseaPolitician）、海外网红（overseaInternetStar） |
| ∟maskType | String | 否 | mask（有遮挡），normal（无遮挡）。判断人脸是否有遮挡，可以用于判断用户是否佩戴口罩墨镜纱巾等综合性遮挡场景 |
| ∟ glasses | String | 是 | 人脸戴眼镜，normal（无眼镜）、 glasses（普通眼镜）、 sunglasses（墨镜），如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ growthStage | String | 否 | 成长阶段（未成年，成年），值为child（未成年幼态），young（非幼态未成年），adult（成年），如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ beautyScore | Number | 否 | 人脸颜值分数，0-1，保留4位小数，如有检测需求请联系易盾策略经理开启服务，如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ expression | String | 否 | 人脸情绪：neutral（扮酷）,happy（微笑）,sad（悲伤）,surprise（惊讶）,fear（害怕）,anger（生气）,disgust（不喜欢），如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ completeness | Number | 否 | 人脸完整性，0：不完整，1：完整，2：未知，如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ rotation | Boolean | 否 | 人脸是否旋转。如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ rotationAngle | Number | 否 | 人脸旋转角度，范围为±180度。正负代表方向，顺时针为正，逆时针为负。如有需要请联系您的专属商务，未开通状态下不返回该字段。 |
| ∟ poseInfoList | Object[] | 否 | 人脸角度，如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ label | String | 否 | 旋转角度类型。pitch是俯仰角，是“点头“，即绕x轴上下旋转；yaw是偏航角，是“摇头”，即绕y轴左右旋转；roll是滚转角，是“摆头”，即绕z轴平面旋转 |
| ∟ angle | Number | 否 | 旋转角度，-99~99，如-11.84 |
| ∟ sizeRatio | String | 否 | 人脸占比，百分比形式 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ quality | Object | 否 | 图片质量检测结果，图片质量检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ aestheticsRate | Number | 否 | 美观度分数，0-1，分数越高美观度越高，建议0.5分以上可认为美观度较好，0.3分以下可认为美观度较差，具体视业务场景而定 |
| ∟ sharpnessRate | Number | 否 | 清晰度分数，0-1，分数越高清晰度越高，建议0.5分以上可认为清晰度较好，0.3分以下可认为清晰度较差，具体视业务场景而定 |
| ∟ grayValue | Number | 否 | 图片灰度值，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ glassmorphismBoarderInfo | Object | 否 | 检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ anyHit | Boolean | 否 | 图片是否包含毛玻璃边框（任一边包含边框均视为包含）true：包含边框；false：不包含边框 |
| ∟ top | Boolean | 否 | 图片顶部是否包含毛玻璃边框，true：包含；false：不包含 |
| ∟ right | Boolean | 否 | 图片右侧是否包含毛玻璃边框，true：包含；false：不包含 |
| ∟ bottom | Boolean | 否 | 图片底部是否包含毛玻璃边框，true：包含；false：不包含 |
| ∟ left | Boolean | 否 | 图片左侧是否包含毛玻璃边框，true：包含；false：不包含 |
| ∟ metaInfo | Object | 否 | 图片基本信息 |
| ∟ byteSize | Number | 否 | 图片大小，单位byte |
| ∟ format | String | 否 | 图片格式 |
| ∟ height | Number | 否 | 图片高度，单位像素 |
| ∟ width | Number | 否 | 图片宽度，单位像素 |
| ∟ hiddenPlayer | Boolean | 否 | 是否隐藏播放器，返回需要单独开启，请联系策略经理 |
| ∟ boarderInfo | Object | 否 | 图片背景信息 |
| ∟ hit | Boolean | 否 | 图片是否包含边框（任一边包含边框均视为包含）true：包含边框；false：不包含边框 |
| ∟ top | Boolean | 否 | 图片顶部是否包含边框，true：包含边框；false：不包含边框 |
| ∟ right | Boolean | 否 | 图片右侧是否包含边框，true：包含边框；false：不包含边框 |
| ∟ bottom | Boolean | 否 | 图片底部是否包含边框，true：包含边框；false：不包含边框 |
| ∟ left | Boolean | 否 | 图片左侧是否包含边框，true：包含边框；false：不包含边框 |
| ∟ backgroundInfo | Object | 否 | 图片背景信息 |
| ∟ pureBackground | Boolean | 否 | 纯色背景检测，true：背景纯色；false：背景复杂 |
| ∟ logo | Object | 否 | logo检测结果，logo检测支持对图片中包含的通识logo进行识别，检测结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ logoName | String | 是 | logo名字，不可识别则为空 |
| ∟ x1 | Number | 否 | logo位置信息，对应logo矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | logo位置信息，对应logo矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | logo位置信息，对应logo矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | logo位置信息，对应logo矩形右下角纵坐标相对坐标 |
| ∟rate | String | 否 | 置信度分数 ，置信度0-1，越接近1，置信度越高 |
| ∟sizeRatio | String | 否 | logo占百分比大小 |
| ∟ aigc | Object | 否 | aigc检测结果，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ isAigc | boolean | 是 | true：是aigc；false：非aigc |
| ∟ discern | Object | 否 | 图片个性化内容识别结果，识别检测支持对图片中物体进行识别，识别结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ discernName | String | 是 | 识别物体名称 |
| ∟ discernKey | String | 是 | 识别标识 |
| ∟ label | String | 否 | 大模型识别标签（同步检测不支持，只支持异步检测返回 ） |
| ∟explain | String | 否 | 大模型识别解释 （同步检测不支持，只支持异步检测返回 ） |
| ∟ rate | Number | 是 | 识别分数，0-1之间取值，1为置信度最高，0为置信度最低。 |
| ∟ type | Number | 是 | 图片识别类型，1 场景识别，2 地标识别，3 通用识别，4：乐谱识别，5：动漫识别，6：服饰识别，7：地图截图识别，8：聊天截屏识别，9：手机识别，10：举白纸识别，11：哺乳照识别，12：可爱卡通骷髅识别 ，13：广告表情包识别，14：睡播识别，100：客户自训练模型 |
| ∟ userRisk | Object | 否 | 图片用户画像识别结果，用户画像识别返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ account | String | 是 | 账号信息 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ account | String | 是 | 账号信息 |
| ∟ acDetails | Object[] | 是 | 命中的详细信息 |
| ∟ riskType | String | 否 | yin_liu_hei_chan（引流黑产），qi_zha_xian_yi（欺诈嫌疑），she_jiao_la_ren（社交拉人） |
| ∟ riskLevel | Number | 否 | 账号等级，0：低风险，1：中风险，2：高风险 |
| ∟ riskScore | String | 否 | 风险分值：0-1 |
| ∟ anticheat | Object | 否 | 图片反作弊检测结果，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ dataId | String | 是 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ suggestion | Number | 是 | 检测结果，0：通过，10：嫌疑，20：不通过 |
| ∟ hitInfos | Object[] | 是 | 命中信息 |
| ∟ hitType | Number | 是 | 反作弊命中类型，详见hitType返回码及含义表 |
| ∟ hitMsg | String | 是 | 反作弊命中详情，可定制返回值 |
| ∟ riskControl | Object | 否 | 智能风控检测结果，如有需要请联系您的专属商务，未开通状态下不返回 |
| ∟ taskId | String | 是 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| ∟ dataId | String | 是 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 智能风控命中详情 |
| ∟ riskLevel | Number | 是 | 风险等级：0 正常，1 低风险，2 中风险，3 高风险，4 可信源。 风险等级只会返回一个，取本次命中的最高风险等级 |
| ∟ hitInfos | Object[] | 否 | 备注 |
| ∟ type | String | 是 | 命中的风险标签编号 |
| ∟ name | String | 是 | 命中的风险标签对应的名称，命中的标签的上下级名称采用‘-’进行拼接 |
异步检测响应体示例
{
"code": 200,
"msg": "ok",
"result": [
{
"antispam": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"status": 2,
"imgMd5":"587a7628ee57485863287eabb41d7dd2",
"suggestion": 1,
"suggestionLevel":2,
"dataId": "dataId",
"name": "name",
"resultType": 1,
"frameSize":1,
"labels": [
{
"label": 500,
"level": 1,
"rate": 1.0,
"subLabels": [
{
"hitStrategy":0,
"subLabel": 50003,
"rate": 1.0,
"details": {
"keywords": [
{
"word": "自定义敏感词",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530
}
],
"libInfos": [
{
"entity": "自定义图片名单url",
"hitCount": 3,
"value": "可识别内容",
"group": "可识别内容分组"
}
],
"hitInfos": [
{
"value": "可识别内容",
"group": "可识别内容分组",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530
}
],
"anticheat": {
"hitType": 1
}
}
}
]
},
{
"label": 300,
"level": 1,
"rate": 0.9949978,
"subLabels": [
{
"subLabel": 30003,
"rate": 0.9839978
},
{
"subLabel": 30002,
"rate": 0.99499786
}
]
},
{
"label": 400,
"level": 1,
"rate": 0.984296,
"subLabels": [
{
"subLabel": 40007,
"rate": 0.974296
},
{
"subLabel": 40003,
"rate": 0.984296
}
]
}
]
},
"ocr": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"dataId": "dataId",
"name": "name",
"height": 730,
"width": 572,
"frameSize":1,
"details": [
{
"content": "唐新唐人电视台NEWTANGDYNASTYTELEVISIONRFA",
"lineContents": [
{
"lineContent": "唐",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530,
"lang": "zh"
}
]
}
]
},
"face": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "0",
"dataId": "dataId",
"details": [
{
"faceNumber": 3,
"faceContents": [
{
"name": "艾力更·依明巴海",
"glasses":"normal",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530,
"type": "normal",
"category": "normal",
"gender": "male",
"age": 59,
"sizeRatio": "1.74%"
}
]
}
]
},
"quality": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"aestheticsRate": 0.466,
"sharpnessRate": 0.511,
"metaInfo": {
"byteSize": 355357,
"height": 730,
"width": 572,
"format": "png"
},
"boarderInfo": {
"hit": false,
"top": false,
"right": false,
"bottom": false,
"left": false
},
"backgroundInfo": {
"pureBackground": false
}
}
]
},
"logo": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"logoName": "RFA",
"x1": 0.5611,
"y1": 0.7369,
"x2": 0.8444,
"y2": 0.9506,
"rate":0.9742,
"sizeRatio":"2.7%"
}
]
},
"discern": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"type": 1,
"discernName": "泳池",
"discernKey": "pool",
"rate": 0.5611
}
]
},
"anticheat": {
"taskId": "fx6sxdcd89fvbvg4967b4787d78a",
"dataId": "dataId",
"details": [
{
"suggestion": 20,
"hitInfos": [
{
"hitType": 5,
"hitMsg": "无SDK数据"
}
]
}
]
},
"userRisk": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"account":"account",
"details": [
{
"account": "account",
"acDetails":[
{
"riskType":"qi_zha_xian_yi",
"riskLevel":1,
"riskScore":0.6
}
]
}
]
}
}
]
}
响应返回码
响应返回码见：响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 服务端 SDK 接入指引 了解更多。
