轮询模式
内容安全直播音视频异步检测或人工审核的结果,客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥,只能选取一种模式进行结果获取。
接口说明
该接口返回直播音视频经过人工审核的结果或者直播音视频异步机器检测结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数callbackUrl为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的taskId对应。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
结果说明
- 获取结果后,下次调用,不会再次返回之前获取过的结果
- 接口一次最多返回200个结果,审核结果数据默认保留7天,7天不获取会失效
- 接口请求频率建议1s一次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整
接口耗时
结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s
历史版本
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | http://as.dun.163.com/v3/livewallsolution/callback/results |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成
公共参数
公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数
业务参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本v3.1 |
yidunRequestId | String | 否 | 64 | 幂等参数说明 |
请求体示例
version=v3.1&signature=xxx&secretId=xxx
响应
该接口可以返回人工审核结果或异步机器检测结果,两类结果结构保持一致。
响应结果
响应字段如下,响应公共字段已省略,详细见响应公共字段,resultType为2时表示人工审核结果,详细字段信息如下:
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
result | Object[] | 是 | 直播音视频检测结果 |
∟ antispam | Object | 否 | 内容安全检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ callback | String | 否 | 提交时传递的callback |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ censorSource | Number | 否 | 审核来源,0:易盾人审,1:客户人审,2:易盾机审 |
∟ status | Number | 是 | 检测状态,1-检测中,2-检测成功,3-检测失败 |
∟ finishType | Number | 是 | 结束检测类型,0-易盾结束检测,1-客户结束检测 |
∟ failureReason | Number | 否 | 检测失败原因,当检测失败时返回,1:下载失败,2:直播流不存在,3:解析失败,4:格式错误 |
∟ riskLevel | Number | 否 | 直播异常风险等级, 0-正常,1-低危,2-中危,3-中高危,4-高危 |
∟ riskScore | Number | 否 | 直播异常分数 |
∟ duration | Number | 否 | 直播开始到结束的总时长,单位s |
∟ billDuration | Number | 否 | 直播音频片段计费时长字段,单位s |
∟ strategySource | Number | 否 | 策略来源,0:易盾策略来源,1:客户策略来源 |
∟ evidences | Object | 否 | 直播审核证据信息 |
∟ audio | Object | 否 | 直播断句审核证据信息 |
∟ suggestion | Number | 是 | 建议结果 0-通过 1-嫌疑 2-删除 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1040:黑麦,1100:涉价值观 |
∟ secondLabel | String | 否 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ startTime | Number | 是 | 断句开始时间,单位毫秒 |
∟ endTime | Number | 是 | 断句结束时间,单位毫秒 |
∟ type | Number | 是 | 断句类型,0-语音识别,1-声纹检测 |
∟ rate | Number | 否 | 声纹检测命中置信度 |
∟ content | String | 是 | 当断句为声纹检测时返回命中声纹检测,语音识别时语音内容 |
∟ url | String | 否 | url访问频率限制为:单直播维度或者业务维度20次/s,需要开启返回直播语音片段播放地址,请联系易盾策略经理 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ segmentId | String | 是 | 断句id |
∟ frontSegment | Object | 否 | 关联证据信息,异常/嫌疑断句命中时返回,命中断句前20s的证据信息,包含前20s的音频语音识别内容及对应url,通过时数据为空 |
∟ content | String | 是 | 命中断句前20s的语音识别内容 |
∟ url | String | 是 | 命中断句前20s的音频url,可解析进行回放 |
∟ labels | Object[] | 否 | 分类信息,通过时数据为空 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1040:黑麦,1100:涉价值观 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ subLabels | Object[] | 否 | 命中细分类信息 |
∟ subLabel | String | 是 | 细分类,详细编码请参考细分类编码 对照表 |
∟ subLabelDepth | Number | 是 | 命中的标签层级,目前支持的层级:2,3 |
∟ secondLabel | String | 是 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ details | Object | 是 | 其他信息 |
∟ hitInfos | Object[] | 否 | 证据信息 |
∟ value | String | 否 | 命中线索内容 |
∟ hitLeaders | Object[] | 否 | 命中领导人信息 |
∟ value | String | 否 | 领导人名,若命中领导人声纹,返回对应的领导人名 |
∟ keywords | Object[] | 否 | 自定义敏感词线索分类信息 |
∟ word | String | 否 | 自定义添加敏感词 |
; ∟ libInfos | Object[] | 否 | 自定义名单线索分类信息 |
; ∟ listType | Number | 是 | 名单类型,1:自定义用户名单,2:自定义IP名单,3:自定义设备名单 |
; ∟ entity | String | 是 | 名单内容 |
; ∟ strategyGroupName | String | 否 | 策略组名称 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ video | Object | 否 | 直播截图审核证据信息 |
∟ evidence | Object | 否 | 证据信息 |
∟ suggestion | Number | 是 | 建议结果 0-通过 1-嫌疑 2-删除 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1040:黑麦,1100:涉价值观 |
∟ secondLabel | String | 否 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ type | Number | 是 | 证据信息类型,1-图片,2-视频 |
∟ url | String | 是 | 证据信息内容 |
∟ beginTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ endTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ frontPics | Object[] | 否 | 关联信息-命中前截图信息 |
∟ url | String | 是 | 命中前截图信息 |
∟ labels | Object[] | 否 | 分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1020:黑屏,1030:挂机,1100:涉价值观 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为嫌疑或不通过,置信度越大,说明垃圾的可能性越高 |
∟ subLabels | Object[] | 是 | 细分类信息,可能包含多个 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码 对照表 |
∟ subLabelDepth | Number | 是 | 命中的标签层级,目前支持的层级:2,3 |
∟ secondLabel | String | 是 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ hitStrategy | Number | 是 | 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字 |
∟ details | Object | 否 | 命中的详细对象信息 |
∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
∟ word | string | 是 | 敏感词内容 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ libInfos | Object[] | 否 | 命中的自定义图片名单信息 |
∟ type | Number | 是 | 命中类型1-自定义用户名单 2-自定义ip名单 3-自定义设备名单 |
∟ entity | String | 是 | 命中的信息,如用户account,设备id,ip等 |
∟ releaseTime | Number | 否 | 名单释放时间,-1为永久有效 |
∟ strategyGroupName | String | 否 | 名单策略组名称 |
∟ hintInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ anticheat | Object | 否 | 命中的反作弊信息 |
∟ hitType | Number | 是 | 反作弊命中类型,详见hitType返回码及含义表 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ reviewEvidences | Object | 否 | 直播墙人审证据信息 |
∟ action | Number | 是 | 审核操作, 1为忽略,2为警告,3为断流,4为提示,7为自定义提示1,8为自定义提示2,9为自定义提示3,10为机器检测结束 |
∟ actionTime | Number | 是 | 操作时间,UNIX_TIME时间戳,毫秒为单位 |
∟ label | Number | 是 | 违规类型,100-色情,111-淫秽表演,112-偶然走光,113-服装暴露,114-床上直播,115-音乐内容低俗,116-言论低俗涉黄,117-违规服装,118-上装暴露,119-下装暴露,120-低俗连麦,121-发出涉黄声音,122-ASMR,123-字幕低俗,124-出现不雅物品,125-低俗妆容,126-传播色情,200-广告,210-二维码,211-商业推广,212-提及竞品,213-字幕推广214-竞品标识,215,竞品播放器,,300-暴恐,311恐怖主义,312-暴力血腥,400-违禁,411-危险表演,412-涉毒/赌/传销,413-违禁服装,414-监管类违禁游戏,415-赌博游戏,416-赌博信息,500-涉政,511-影响政府形象,512-邪教迷信,513-涉军事,514涉宗教,517-涉及政治敏感话题,518-出现国旗国徽,519-出现领导人画像,800-不文明,811-非漏点赤膊,,812-性感,821-涉酒,822-涉烟,823-纹身,824-未成年,825-危险驾驶,826-传播负面情绪,1000-其他,1020-黑屏,1022-画质差,1023-无营养,1024-盗播版权内容,1025-无音乐设备,1026-与音乐无关,1028-无版权游戏,1029-非普通话直播,1030-挂机,1031-私密场所直播,1032-卡顿,1050-自定义 |
∟ detail | String | 否 | 违规详细说明 |
∟ censorLabels | Object[] | 否 | 支持在审核系统自定义标签分类信息;使用自定义标签时,label为1050 |
∟ code | String | 是 | 在系统配置自定义标签之后会生成一个唯一的标签ID |
∟ name | String | 否 | 在审核系统配置自定义标签名称 |
∟ desc | String | 否 | 在审核系统配置自定义标签备注 |
∟ customCode | String | 否 | 在审核系统配置自定义标签code |
∟ pictures | Object[] | 否 | 人审视频证据信息 |
∟ url | String | 是 | 人审截图地址 |
∟ beginTime | Number | 是 | 人审断句开始时间 |
∟ segments | Object[] | 否 | 人审音频证据信息 |
∟ startTime | Number | 是 | 人审断句开始时间 |
∟ endTime | Number | 是 | 人审断句结束时间 |
∟ content | String | 是 | 人审断句语音识别内容 |
∟ url | String | 否 | 人审断句语音url地址 |
∟ warnCount | Number | 否 | 警告次数 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,针对房间内具体说话人的处罚,返回说话人ID信息,若为空,则针对房间维度处罚 |
∟ censorAccount | String | 是 | 审核员账号 |
∟ frontAudioSegment | Object | 否 | 人审操作action时返回前20s的音频断句信息,用于还原场景 |
∟ url | String | 是 | 音频断句url |
∟ content | String | 是 | 音频断句语音识别结果 |
∟ evidence | Object[] | 否 | 人审操作action时返回前5张机器截图,用于还原场景 |
∟ snapshot | String | 是 | 证据截图url |
∟ language | Object | 否 | 语种识别检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ startTime | Number | 是 | 断句开始时间,单位毫秒 |
∟ endTime | Number | 是 | 断句结束时间,单位毫秒 |
∟ content | String | 是 | 语种识别类型,支持检测语种类型请参考语种代码表 |
∟ callback | String | 否 | 提交时传递的callback |
∟ segmentId | String | 是 | 断句id |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ ocr | Object | 否 | OCR结果信息,OCR功能需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ beginTime | String | 是 | 直播当前时间点,单位为毫秒 |
∟ endTime | String | 是 | 直播当前时间点,单位为毫秒 |
∟ height | Number | 是 | 截图高度,单位像素 |
∟ width | Number | 是 | 截图宽度,单位像素 |
∟ url | String | 是 | 截图地址 |
∟ details | Object[] | 否 | 截图 OCR 命中的详细信息 |
∟ content | String | 是 | 该图片中所有的文字信息集合 |
∟ lineContents | Object[] | 是 | OCR行信息 |
∟ lineContent | String | 是 | 每行的文字信息 |
∟ lang | String | 否 | 语种信息 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ voice | Object | 否 | 人声属性检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ startTime | Number | 是 | 断句开始时间,单位毫秒 |
∟ endTime | Number | 是 | 断句结束时间,单位毫秒 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ segmentId | String | 否 | 断句id |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ callback | String | 否 | 提交时传递的callback |
∟ mainGender | String | 否 | 音频性别建议值,male/female |
∟ mainAgeGroup | String | 否 | 识别人声年龄,underage(0~18岁),adult(18岁以上) |
∟ mainAgeGroupRate | Number | 否 | 人声年龄置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ url | String | 否 | 语音断句的临时访问地址 |
∟ logo | Object | 否 | logo检测结果,logo检测支持对图片中包含的通识logo进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ beginTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ endTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ pictureId | Number | 否 | 截图id |
∟ 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占百分比大小 |
∟ discern | Object | 否 | 图片个性化内容识别结果,识别检测支持对图片中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ beginTime | String | 是 | 直播当前时间点,单位为毫秒 |
∟ endTime | String | 是 | 直播当前时间点,单位为毫秒 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ discernName | String | 是 | 识别物体名称 |
∟ rate | Number | 是 | 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。 |
∟ type | Number | 是 | 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别,5:动漫识别,6:服饰识别,7:地图截图识别,8:聊天截屏识别,9:手机识别,10:举白纸识别,11:哺乳照识别,12:可爱卡通骷髅识别,100:客户自训练模型,discernName返回自训练模型名称 |
∟ quality | Object | 否 | 直播音视频质量检测结果,质量检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ audio | Object | 否 | 语音质量检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ startTime | Number | 是 | 断句开始时间,单位毫秒 |
∟ endTime | Number | 是 | 断句结束时间,单位毫秒 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交时传递的callback |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ details | Object | 是 | 详细说明 |
∟ silent | Boolean | 否 | 是否为无声片段,true:无声片段 |
∟ video | Object | 否 | 视频截图质量检测结果 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟ beginTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ endTime | Number | 是 | 直播当前时间点,单位为毫秒 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ aestheticsRate | Number | 否 | 美观度分数,0-1,分数越高美观度越高,建议0.5分以上可认为美观度较好,0.3分以下可认为美观度较差,具体视业务场景而定 |
∟ sharpnessRate | Number | 否 | 清晰度分数,0-1,分数越高清晰度越高,建议0.5分以上可认为清晰度较好,0.3分以下可认为清晰度较差,具体视业务场景而定 |
∟ metaInfo | Object | 否 | 图片基本信息 |
∟ byteSize | Number | 否 | 图片大小,单位byte |
∟ format | String | 否 | 图片格式 |
∟ height | Number | 否 | 图片高度,单位像素 |
∟ width | Number | 否 | 图片宽度,单位像素 |
∟ boarderInfo | Object | 否 | 图片边框信息 |
∟ hit | Boolean | 否 | 图片是否包含边框(任一边包含边框均视为包含)ture:包含边框;false:不包含边框 |
∟ top | Boolean | 否 | 图片顶部是否包含边框,ture:包含边框;false:不包含边框 |
∟ right | Boolean | 否 | 图片右侧是否包含边框,ture:包含边框;false:不包含边框 |
∟ bottom | Boolean | 否 | 图片底部是否包含边框,ture:包含边框;false:不包含边框 |
∟ left | Boolean | 否 | 图片底部是否包含边框,ture:包含边框;false:不包含边框 |
∟ color | Object | 否 | 图片边框颜色信息 |
∟ top | Number | 否 | 图片顶部边框颜色,1-白色,2-黑色 |
∟ right | Number | 否 | 图片右侧边框颜色,1-白色,2-黑色 |
∟ bottom | Number | 否 | 图片底部边框颜色,1-白色,2-黑色 |
∟ left | Number | 否 | 图片底部边框颜色,1-白色,2-黑色 |
∟ backgroundInfo | Object | 否 | 图片背景信息 |
∟ pureBackground | boolean | 否 | 纯色背景检测,ture:背景纯色;false:背景复杂 |
∟face | Object | 否 | 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
∟beginTime | Number | 是 | 位置信息,截图开始时间点,单位毫秒 |
∟endTime | Number | 是 | 位置信息,截图结束时间点,单位毫秒 |
∟url | String | 是 | 截图下载链接 |
∟details | Object[] | 否 | 截图人脸检测详情数组 |
∟faceNumber | Number | 是 | 该图片中包含的人脸个数 |
∟deepfake | Number | 是 | 是否有伪造人脸,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:未知,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟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 | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟asr | Object | 否 | 语音识别文字内容,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟dataid | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟callback | String | 否 | 提交时传递的callback |
∟startTime | Number | 是 | 断句开始时间,单位毫秒 |
∟endTime | Number | 是 | 断句结束时间,单位毫秒 |
∟content | String | 是 | 语音断句的文字内容 |
∟url | String | 否 | 语音断句的临时访问地址,地址有效期为7天,url的访问频率限制为:单直播维度或者业务维度20次/s,如需开启请联系易盾策略经理 |
∟speakerId | String | 否 | 针对接入SDK监听客户,返回说话人ID信息 |
响应体示例
检测中数据返回示例
{
"code":200,
"msg":"ok",
"result":[
{
"antispam":{
"taskId":"e67b92e39a814a8e82868db72c292db5",
"dataId":"1631947613504",
"callback":"",
"censorSource":2,
"status":1,
"evidences":{
"video":{
"evidence":{
"suggestion":1,
"type":1,
"url":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_60396_1631947822155.jpg?Signature=Wl6sup7QKel2PhsoDttRnD3ZzFRmAUz%2FBn7pugV1SPo%3D&Expires=1634539822&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff",
"beginTime":1631947821753,
"endTime":1631947821753,
"frontPics":[
{
"url":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_43038_1631947816930.jpg?Signature=pmrugKqwmq%2FE2yr8VyIsxXckCJX%2Fv6RiqCaZfxqvaMY%3D&Expires=1634539822&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"url":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_1631947817367.gif?Signature=6pHgkMh9LvC3ylBNeZRC8XXVGL15h6tKvWHj2E8pcQM%3D&Expires=1634539822&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"url":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_43038_1631947821781.jpg?Signature=PDXIf62QK5kW1IzCfJw%2F8yfDMRZxjREzMDl15ZAXqX4%3D&Expires=1634539822&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
}
]
},
"labels":[
{
"label":300,
"level":1,
"rate":0.98933,
"subLabels":[
{
"subLabel":"30002",
"subLabelDepth":2,
"secondLabel":"30002",
"rate":0.9893,
"details":{
"hitInfos":[
{
"value":"gangdu1",
"group":"暴恐旗帜分组",
"x1":0.5891,
"y1":0.225,
"x2":0.9016,
"y2":0.7472
}
]
}
}
]
}
]
}
},
"riskLevel":4,
"riskScore":978
}
},
{
"antispam":{
"taskId":"e67b92e39a814a8e82868db72c292db5",
"callback":"",
"dataId":"1631947613504",
"censorSource":2,
"status":1,
"evidences":{
"audio":{
"suggestion":2,
"startTime":1631947708845,
"endTime":1631947718745,
"content":"重庆祝了红包们成立不久,人民共和国成立奥慢。",
"labels":[
{
"label":500,
"level":2,
"subLabels":[
{
"details":{
"hitInfos":[
{
"value":"共和国"
}
],
"keywords":[
{
"word":"共和国"
}
]
},
"subLabel":"500049",
"subLabelDepth":2,
"secondLabel":"500049"
}
]
}
],
"url":"",
"speakerId":"43038",
"segmentId":"7db0f593546a404197344e688aa5e85e",
"frontSegment":{
"content":"第一次用这个软件刷了半天,全是长的漂亮,你那没得一个专业的,我第一次用这个软件。 我们隆重庆祝了中华人民共和国,成立同胞们,朋友们。 那半天全是装的漂亮,你老妹的一个发愁啊。 同胞们,朋友们。 前不久,我们隆重庆祝了中华人民共和国。",
"url":"http://as.test.dun.163.com/v1/liveaudio/segment/play?Signature=915ba16e20df622e3a26fbce0f9c68bb&Expires=1632034249661&AccessKey=e67b92e39a814a8e82868db72c292db5&BeginTime=1631947673101&EndTime=1631947708845&SpeakerId="
}
}
},
"riskLevel":4,
"riskScore":1121,
"duration":0
}
},
{
"antispam":{
"taskId":"e67b92e39a814a8e82868db72c292db5",
"dataId":"1631947613504",
"callback":"",
"censorSource":1,
"status":1,
"reviewEvidences":{
"action":4,
"actionTime":1631947937027,
"label":122,
"detail":"ASMR",
"warnCount":0,
"speakerId":"",
"evidence":[
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_43038_1631947929972.jpg?Signature=W6FiKewd2NOs95XAVAd8rsARTS7UCFZovt0qlvmdmoQ%3D&Expires=1634539937&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_43038_1631947929053.jpg?Signature=9HaQQQN1qfPkuJZ4H9aWQQ0WZIiJUqV96CPPKEkHRl4%3D&Expires=1634539937&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_60396_1631947934326.jpg?Signature=UZ4Sx0TeTOOsUvdk4mdSJnacjzwmA4E7vn%2BFnBLri5I%3D&Expires=1634539937&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_1631947930656.gif?Signature=si0v%2FqTrGTZ9xe%2FynQEUR2EI0L10DWdmhztl%2FmT0I2U%3D&Expires=1634539937&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/e67b92e39a814a8e82868db72c292db5_60396_1631947929349.jpg?Signature=2pbn2omrFyHrFXtxAnPIwMI75U6InhDzqyOjchBqiDI%3D&Expires=1634539937&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
}
]
}
}
}
]
}
检测完成数据返回示例
目前直播音视频提交会拆分为直播视频和直播音频检测,并且可能会出现直播视频或直播音频先结束的情况,所以在直播结束以后,或者调用停止检测以后会分别返回直播视频结束状态和直播音频结束状态。
直播视频
{
"code":200,
"msg":"ok",
"result":[
{
"antispam":{
"taskId":"d1vqgcbwcla0ah7upd5wng6g04009x8v",
"dataId":"1234",
"censorSource":2,
"status":2,
"reviewEvidences":{
"action":10,
"actionTime":1666861884279,
"label":0,
"detail":"处理完成",
"warnCount":0,
"censorAccount":"platform",
"evidence":[
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/zvcws76Expires=1669453884&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/zvcws76Expires=1669453884&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/zvcws76oExpires=1669453884&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/zvcws76Expires=1669453884&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
},
{
"snapshot":"https://yidun-video.nos-eastchina1.126.net/zvcws76oExpires=1669453884&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
}
]
},
"duration":5763
}
}
]
}
直播音频
{
"code":200,
"msg":"ok",
"result":[
{
"antispam":{
"taskId":"d1vqgcbwcla0ah7upd5wng6g04009x8v",
"evidences":{
"audio":{
"startTime":0,
"endTime":0,
"segments":[
],
"suggestion":0,
"censorSource":2
}
},
"duration":5763,
"status":2
}
}
]
}
响应返回码
响应返回码见:响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 了解更多。
Github Demo 地址
Gitee Demo 地址(Github 无法访问时选择)
该接口的使用方法可参考SDK demo