推送模式
2024.12.02 16:12:00
内容安全点播音视频结果获取推送模式用于将点播音视频异步检测或人工审核结果主动推送给客户,保证客户最快的获取结果。客户需要按照以下规范实现接收结果的接口。推送模式与轮询模式互斥,只能选取一种模式进行结果获取。
接口说明
结果主动推送模式以数据为维度,将异步机器检测结果或者人工审核结果推送给客户,需客户在调用检测接口时设置回调地址callbackUrl参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据。
鉴权说明
客户接口可以通过业务开通时易盾分配的密钥信息字段进行接口鉴权,鉴权粒度是否要精确到业务级别,用户可以根据需要自行决定,请参见接口鉴权
接入说明
- 协议说明:检测接口请求参数中指定了回调地址参数callbackUrl(即一个http(s)协议接口的URL)。主动推送接口需要支持http协议,支持POST方法,传输数据编码采用utf-8
- 接口性能:推送结果接口默认超时时间为2s,为了保证顺利接收数据,客户需保证接收接口可用性和性能稳定
- 失败重试:客户接口处理结果数据,并返回应答。如果客户接口请求异常,超时或收到的应答不符合规范,易盾会认为推送失败;我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送
- 幂等性:结果推送时同样的结果可能会多次请求客户接口。客户接口需要保证幂等性,能够正确处理重复结果数据
接口耗时
客户接收接口需保证接收接口可用性和性能稳定,易盾请求超时时间为2s,客户接口尽量保证在1s内返回应答,如有特殊要求,可联系易盾运营适当调整超时时间
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | 回调地址callbackUrl |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
secretId | String | 是 | 32 | 产品秘钥 id ,由易盾内容安全云服务分配,产品标识 |
signature | String | 是 | 32 | 请求签名,用来验证此次请求的合法性,具体算法见接口鉴权 |
callbackData | String | 是 | - | 主动推送结果数据,格式为 json 字符串, 详细见下表 callbackData 结构 |
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
callbackData | String | 是 | 点播音视频检测结果 |
∟ antispam | Object | 是 | 内容安全检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ md5 | String | 否 | 点播音视频md5值 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ label | Number | 否 | 整体垃圾分类,0:正常,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,800:恶心类,900:其他,1020:黑屏,1030:挂机,1050:噪音,1100:涉价值观 |
∟ secondLabel | String | 否 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ callback | String | 否 | 提交时传递的callback |
∟ censor | String | 否 | 审核操作人,在censorSource字段值为1时返回 |
∟ censorSource | Number | 是 | 审核来源,0:易盾人审,1:客户人审,2:易盾机审,3:用户质检,4:易盾质检 |
∟ censorTime | Number | 否 | 人工审核完成时间,毫秒单位时间戳(13位) |
∟ checkTime | Number | 是 | 机器审核完成时间,毫秒单位时间戳(13位) |
∟ duration | Number | 否 | 音视频开始到结束的总时长,单位毫秒 |
∟ picCount | Number | 否 | 视频截图张数 |
∟ strategySource | Number | 否 | 策略来源,0:易盾策略来源,1:客户策略来源 |
∟ solutionExtra | Object | 否 | 子数据检测失败原因汇总,检测失败或部分检测失败会返回,检测成功不返回 |
∟ failUnit | Object | 是 | 子数据检测失败原因汇总 |
∟ audio | Object | 否 | 音频检测失败原因 |
∟ failureReason | Number | 是 | 音频:1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在。 |
∟ video | Object | 否 | 视频检测失败原因 |
∟ failureReason | Number | 是 | 视频:110:请求重复,120:参数错误,130:文件下载失败/解析错误,140:数据类型错误,160:视频大小超限(>5G)。 |
∟ images | Object[] | 否 | 图片检测失败原因 |
∟ failureReason | Number | 是 | 图片:610:图片下载失败,620:图片格式错误,630:其他。 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ evidences | Object | 否 | 证据信息 包含 text文本,image截图, audio音频,video视频属性 |
∟ text | Object | 否 | 文本检测信息 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ censorType | Number | 是 | 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审 |
∟ isRelatedHit | Boolean | 是 | 是否关联检测命中,true:关联检测命中,false:原文命中 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 命中分类,示例值:100 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ subLabels | Object[] | 否 | 细分类信息,可能包含多个 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码 对照表 |
∟ subLabelDepth | Number | 是 | 命中的标签层级,目前支持的层级:2,3 |
∟ secondLabel | String | 是 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ details | Object | 否 | 命中的详细信息 |
∟ keywords | Object[] | 否 | 命中的敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ libInfos | Object[] | 否 | 命中的自定义库信息 |
∟ type | Number | 是 | |
∟ entity | String | 是 | 自定义库实体 |
∟ hintInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 线索内容 |
∟ positions | Object[] | 是 | 线索位置 |
∟ fieldName | String | 是 | 返回title(音视频标题),content(音视频简介) |
∟ startPos | Number | 是 | 线索开始坐标 |
∟ endPos | Number | 是 | 线索结束坐标 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ images | Object[] | 否 | 图片检测结果 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ status | Number | 是 | 检测状态:2 检测成功、3 检测失败 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ 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 | 否 | 命中三级标签细分类 |
∟ hitStrategy | Number | 是 | 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ details | Object | 否 | 命中的详细对象信息 |
∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
∟ word | string | 是 | 敏感词内容 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ libInfos | Object[] | 否 | 命中的自定义图片名单信息 |
∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
∟ hitCount | Number | 是 | 历史针对该数据源图片命中所有次数 |
∟ value | String | 否 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ hintInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ audio | Object | 否 | 音频检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ status | Number | 是 | 检测状态,2-检测成功,3-检测失败 |
∟ label | Number | 是 | 音频整体分类信息,0:正常,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观 |
∟ failureReason | Number | 否 | 检测失败原因,当检测失败时返回,1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在 |
∟ suggestion | Number | 是 | 建议结果 0-通过 1-嫌疑 2-删除 |
∟ resultType | Number | 是 | 结果类型 1-机器结果 2-人审结果 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交时传递的callback |
∟ censorSource | Number | 是 | 审核来源,0:易盾人审,1:客户人审,2:易盾机审 |
∟ censorTime | Number | 否 | 审核完成时间,毫秒单位时间戳(13位) |
∟ duration | Number | 是 | 音频时长字段,单位s |
∟ durationMs | Number | 是 | 音频时长字段,单位ms |
∟ customAction | Number | 否 | 客户自定义建议结果 0-通过 2-删除 |
∟ segments | Object[] | 是 | 音频数据所在断句详细信息 |
∟ startTime | Number | 是 | 断句开始时间点,单位秒 |
∟ endTime | Number | 是 | 断句结束时间点,单位秒 |
∟ startTimeMillis | Number | 是 | 断句开始时间点,单位毫秒 |
∟ endTimeMillis | Number | 是 | 断句结束时间点,单位毫秒 |
∟ type | Number | 是 | 断句类型,0-语音识别,1-声纹检测 |
∟ leaderName | String | 否 | 领导人名,若命中领导人声纹,返回对应的领导人名 |
∟ url | String | 否 | 风险片段对应语音片段的临时访问地址,地址有效期为7天,如需开启请联系易盾策略经理 |
∟ content | String | 是 | 音频数据所在断句语音识别原文内容,支持返回异常数据所在断句内容 |
∟ labels | Object[] | 是 | 分类信息 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,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 | 是 | 命中的敏感词或者声纹检测的分值 |
∟ songName | String | 否 | 命中的涉政歌曲名称 |
∟ keywords | Object[] | 否 | 自定义敏感词线索分类信息 |
∟ word | String | 是 | 自定义添加敏感词 |
∟ libInfos | Object[] | 否 | 自定义名单线索分类信息 |
∟ listType | Number | 是 | 名单类型 |
∟ entity | String | 是 | 名单内容 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ video | Object | 否 | 视频检测结果 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ failureReason | Number | 否 | 检测失败原因,当检测失败时返回,110:请求重复,120:参数错误,130:文件下载失败/解析错误,140:数据类型错误,160:视频大小超限(>5G) |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ callback | String | 否 | 提交时传递的callback |
∟ censorSource | Number | 是 | 审核来源,0:易盾人审,1:客户人审,2:易盾机审 |
∟ censorTime | Number | 否 | 人工审核完成时间,毫秒单位时间戳(13位) |
∟ duration | Number | 是 | 视频时长字段,单位s |
∟ customAction | Number | 否 | 客户自定义建议结果 0-通过 2-删除 |
∟ censorLabels | String[] | 否 | 支持在智能审核系统自定义标签分类信息,人审可返回信息 |
∟ picCount | Number | 是 | 截图张数 |
∟ pictures | Object[] | 否 | 截图证据信息 |
∟ type | Number | 是 | 截图类型,1:图片,2:视频 |
∟ url | String | 是 | 截图下载地址 |
∟ startTime | Number | 是 | 证据开始相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29" |
∟ endTime | Number | 是 | 证据结束相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29" |
∟ pictureId | String | 否 | 截图id |
∟ frontPics | Object[] | 否 | 关联信息-命中前截图信息 |
∟ url | String | 是 | 命中前截图下载地址 |
∟ backPics | Object[] | 否 | 关联信息-命中后截图信息 |
∟ url | String | 是 | 命中前截图下载地址 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,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 | 否 | 命中三级标签细分类 |
∟ hitStrategy | Number | 是 | 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ details | Object | 否 | 命中的详细对象信息 |
∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ libInfos | Object[] | 否 | 命中的自定义图片名单信息 |
∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
∟ hitCount | Number | 是 | 历史针对该数据源图片命中所有次数 |
∟ value | String | 否 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ hintInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ reviewEvidences | Object | 否 | 此字段只有人审核之后才会有值,人审证据信息 包含 text文本,image截图, audio音频,video视频属性 |
∟ spamType | Number | 否 | 人审垃圾类型,100:色情,110:性感低俗,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:漫骂,700:灌水,900:其他,1100:涉价值观 |
∟ description | String | 否 | 描述 |
∟ detail | String | 否 | 详情 |
∟ texts | Object[] | 否 | 文本审核结果 |
∟ snippet | String | 否 | 命中片段 |
∟ description | String | 否 | 审核备注 |
∟ images | Object[] | 否 | 图片审核结果 |
∟ url | String | 否 | 图片地址 |
∟ description | String | 否 | 审核备注 |
∟ audios | Object[] | 否 | 音频审核结果 |
∟ startTime | Number | 否 | 位置信息,断句开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,断句结束时间点,单位秒 |
∟ startTimeMillis | Number | 否 | 位置信息,断句开始时间点,单位毫秒 |
∟ endTimeMillis | Number | 否 | 位置信息,断句结束时间点,单位毫秒 |
∟ description | String | 否 | 审核备注 |
∟ videos | Object[] | 否 | 视频审核结果 |
∟ startTime | Number | 否 | 位置信息,截图开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,截图结束时间点,单位秒 |
∟ description | String | 否 | 审核备注 |
∟ url | String | 否 | 图片地址 |
∟ censorLabels | Object[] | 否 | 审核标签列表,人审打标的内容列表 |
∟ code | String | 否 | 标签编码 |
∟ name | String | 否 | 名称 |
∟ desc | String | 否 | 描述 |
∟ customCode | String | 否 | 用户自定义编码 |
∟ language | Object | 否 | 语种检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交时传递的callback |
∟ details | Object[] | 否 | 命中的详细对象信息 |
∟ type | String | 否 | 语音识别后语种,支持检测语种类型请参考语种代码表 |
∟ segments | Object[] | 否 | 命中的断句时间段 |
∟ startTime | Number | 否 | 位置信息,断句开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,断句结束时间点,单位秒 |
∟ startTimeMillis | Number | 否 | 位置信息,断句开始时间点,单位毫秒 |
∟ endTimeMillis | Number | 否 | 位置信息,断句结束时间点,单位毫秒 |
∟ voice | Object | 否 | 人声属性检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交时传递的callback |
∟ detail | Object | 否 | 命中的详细对象信息 |
∟ mainGender | String | 否 | 命中的性别 "female" / "male" |
∟ mainAgeGroup | String | 是 | 识别人声年龄建议值,underage(0~18岁),adult(18岁以上) |
∟ mainAgeGroupRate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ deepfake | Number | 否 | 音频深度伪造检测值,1-伪造,0-真实 |
∟asr | Object | 否 | 语音识别检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交时传递的callback |
∟ details | Object[] | 否 | 命中的详细对象信息 |
∟ startTime | Number | 否 | 位置信息,断句开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,断句结束时间点,单位秒 |
∟ startTimeMillis | Number | 否 | 位置信息,断句开始时间点,单位毫秒 |
∟ endTimeMillis | Number | 否 | 位置信息,断句结束时间点,单位毫秒 |
∟ content | String | 是 | 音频数据所在断句语音识别原文内容 |
∟ ocr | Object | 否 | OCR结果信息,OCR功能需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ pictures | Object[] | 是 | 截图OCR结果数组,最多返回视频截图的前100张 |
∟ startTime | Number | 否 | 位置信息,截图开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,截图结束时间点,单位秒 |
∟ pictureId | String | 否 | 截图id |
∟ 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 | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ discern | Object | 否 | 图片个性化内容识别结果,支持对截图中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ pictures | Object[] | 是 | 物体识别结果数组,最多返回视频截图的前100张 |
∟ startTime | Number | 否 | 位置信息,截图开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,截图结束时间点,单位秒 |
∟ pictureId | String | 否 | 截图id |
∟ details | Object[] | 否 | 物体识别命中的详细信息 |
∟ discernName | String | 是 | 识别物体名称 |
∟ rate | Number | 是 | 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。 |
∟ type | Number | 是 | 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别,5:动漫识别,6:服饰识别,7:地图截图识别,8:聊天截屏识别,9:手机识别,10:举白纸识别,11:哺乳照识别,12:可爱卡通骷髅识别 |
∟ logo | Object | 否 | logo检测结果,logo检测支持对图片中包含的通识logo进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ pictures | Object[] | 是 | 物体识别结果数组,最多返回视频截图的前100张 |
∟ startTime | 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占百分比大小 |
∟ quality | Object | 否 | 质量检测结果,质量检测需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空 |
∟ video | Object | 否 | 视频截图质量检测结果 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ pictures | Object[] | 是 | 视频截图质量检测结果数组,最多返回视频截图的前100张 |
∟ startTime | Number | 否 | 位置信息,截图开始时间点,单位秒 |
∟ endTime | Number | 否 | 位置信息,截图结束时间点,单位秒 |
∟ pictureId | String | 否 | 截图id |
∟ 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:背景复杂 |
∟ audio | Object | 否 | 音频断句质量检测结果 |
∟ taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 提交数据时的 callback |
∟ silentSegments | Object | 是 | 音频无声断句检测结果详情 |
∟ startTime | Number | 否 | 断句开始时间点,单位秒 |
∟ endTime | Number | 否 | 断句结束时间点,单位秒 |
∟ startTimeMillis | Number | 否 | 断句开始时间点,单位毫秒 |
∟ endTimeMillis | Number | 否 | 断句结束时间点,单位毫秒 |
∟face | Object | 否 | 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空 |
∟taskId | String | 是 | 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a" |
∟dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟pictures | Object[] | 否 | 视频截图人脸检测结果数组,最多返回视频截图的前100张 |
∟startTime | Number | 是 | 位置信息,截图开始时间点,单位秒 |
∟endTime | Number | 是 | 位置信息,截图结束时间点,单位秒 |
∟url | String | 是 | 截图下载链接 |
∟details | Object[] | 否 | 截图人脸检测详情数组 |
∟faceNumber | Number | 是 | 该图片中包含的人脸个数 |
∟deepfake | Number | 否 | 是否有伪造人脸,0-无,1-有 |
∟faceContents | Object[] | 是 | 人脸详细信息 |
∟name | String | 是 | 图片中出现的人脸名字,未识别则为空。该字段可识别明星、政治人物等人脸信息,用于落马官员/劣迹艺人检测,或明星头像/政治头像检测 |
∟glasses | String | 是 | 人脸戴眼镜,normal(无眼镜)、 glasses(普通眼镜)、 sunglasses(墨镜),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟gender | String | 否 | 人脸性别,值为男(male)、女(female);不可识别则为空 |
∟age | Number | 否 | 人脸年龄,值为具体年龄(age);不可识别则为空 |
∟growthStage | String | 否 | 成长阶段(未成年,成年),值为child(未成年幼态),young(非幼态未成年),adult(成年) |
∟type | String | 否 | 人脸类型,包含卡通脸(cartoon)、普通(normal),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟category | String | 否 | 人物分类,包含名人(star)、普通(normal)、海外娱乐明星(overseaEntertainmentStar)、海外体育明星(overseaSportStar)、海外政客(overseaPolitician)、海外网红(overseaInternetStar) |
∟maskType | String | 否 | mask(有遮挡),normal(无遮挡)。判断人脸是否有遮挡,可以用于判断用户是否佩戴口罩墨镜纱巾等综合性遮挡场景 |
∟expression | String | 否 | 人脸情绪:neutral(扮酷),happy(微笑),sad(悲伤),surprise(惊讶),fear(害怕),anger(生气),disgust(不喜欢),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ completeness | Number | 否 | 人脸完整性,0:不完整,1:完整,2:未知,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟beautyScore | Number | 否 | 人脸颜值分数,0-1,保留4位小数,如有检测需求请联系易盾策略经理开启服务,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟sizeRatio | String | 否 | 人脸占比,百分比形式 |
∟x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
请求体示例
callbackData=***&signature=xxx&secretId=xxx
请求体 callbackData 格式如下,callbackData 为 JSON 字符串格式,请自行解析或者反序列化为 JSON 对象使用。
{
"antispam":{
"taskId":"18xrunm6fr35t49nnv506ukg02009q66",
"suggestion":2,
"status":2,
"resultType":1,
"censorSource":2,
"checkTime":1633759861164,
"censorTime":1633759853762,
"duration":71339,
"censorLabels":[
{
"code":101,
"desc":"自定义标签",
"customCode":"68684"
}
],
"evidences":{
"images":[
{
"censorType":0,
"labels":[
{
"label":100,
"level":2,
"rate":0.9999,
"subLabels":[
{
"details":{
"hitInfos":[
{
"group":"色情部位分组",
"value":"女胸"
}
]
},
"rate":1,
"subLabel":10002
}
]
},
{
"label":500,
"level":0,
"rate":0.9999
},
{
"label":300,
"level":0,
"rate":1
},
{
"label":400,
"level":0,
"rate":1
},
{
"label":200,
"level":0,
"rate":0.9975
}
],
"name":"gpqis0e92czvfliemjpa3neg02009q6a",
"resultType":1,
"status":2,
"suggestion":2,
"taskId":"0b2dd0e561a8457fbfcf7d79378eec37"
}
],
"text":{
"taskId":"44i3effo1j5w5for9l8xtdjg02009q6a",
"suggestion":2,
"resultType":1,
"censorType":0,
"isRelatedHit":false,
"labels":[
{
"label":200,
"level":2,
"subLabels":[
{
"subLabel":"200009",
"details":{
"hitInfos":[
{
"value":"加我",
"positions":[
{
"fieldName":"content",
"startPos":5,
"endPos":8
},
{
"fieldName":"title",
"startPos":5,
"endPos":8
}
]
}
]
}
}
]
}
]
},
"audio":{
"taskId":"18xrunm6fr35t49nnv506ukg02009q66",
"dataId":"",
"status":2,
"suggestion":2,
"label":100,
"resultType":1,
"callback":"",
"censorSource":2,
"censorTime":1633759861065,
"segments":[
{
"startTime":0,
"endTime":6,
"content":"第一次用这个软件上了半天,全是长得漂亮呢?",
"type":0,
"labels":[
{
"label":100,
"level":2,
"subLabels":[
{
"subLabel":"100001",
"details":{
"hitInfos":[
{
"value":"120",
"startTime":1684201,
"endTime":1684201,
}
],
"keywords":[
{
"word":"自定义敏感词"
}
],
"libInfos":[
{
"listType":1,
"entity":"127.0.0.1"
}
]
}
}
]
}
]
},
{
"startTime":52,
"endTime":53,
"content":"哦。",
"type":0,
"labels":[
]
}
],
"duration":71
},
"video":{
"taskId":"18xrunm6fr35t49nnv506ukg02009q66",
"dataId":"",
"status":2,
"suggestion":2,
"resultType":1,
"censorSource":2,
"censorTime":1633759858920,
"pictures":[
{
"type":1,
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_1_5000.jpg?Signature=zAyZL%2B8cuIZlQyAguVxzeXtoSB20NYykv32i9IQpdQI%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8",
"startTime":5000,
"endTime":5000,
"labels":[
{
"label":100,
"level":2,
"rate":0.95157,
"subLabels":[
{
"subLabel":10007,
"rate":0.926,
"details":{
"hitInfos":[
{
"value":"卡通色情",
"group":"色情部位分组"
}
]
}
}
]
}
],
"censorSource":2,
"frontPics":[
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_0_0.jpg?Signature=OLZBW0E1tD21RTp7JD58hB1xuwwhd%2FDbeMXFSxOTL%2FU%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
}
],
"backPics":[
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_2_10000.jpg?Signature=6mtVdESs0R%2BwzRVE%2BmVYT8RVVh1nllu%2FO1dkaQJwMAc%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
},
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_3_15000.jpg?Signature=qekds78dhYRIrhXw6NK7Xh88nW18FObulqA6aPU7Mcg%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
},
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_4_20000.jpg?Signature=ZyrIX4TJP5MpOYoPRhVTf6L%2BelcNJFlnt7t8J7ucwKk%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
}
]
},
{
"type":1,
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_2_10000.jpg?Signature=6mtVdESs0R%2BwzRVE%2BmVYT8RVVh1nllu%2FO1dkaQJwMAc%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8",
"startTime":10000,
"endTime":10000,
"labels":[
{
"label":100,
"level":2,
"rate":0.95157,
"subLabels":[
{
"subLabel":10007,
"rate":0.926,
"details":{
"hitInfos":[
{
"value":"卡通色情",
"group":"色情部位分组"
}
]
}
}
]
}
],
"censorSource":2,
"frontPics":[
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_0_0.jpg?Signature=OLZBW0E1tD21RTp7JD58hB1xuwwhd%2FDbeMXFSxOTL%2FU%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
},
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_1_5000.jpg?Signature=zAyZL%2B8cuIZlQyAguVxzeXtoSB20NYykv32i9IQpdQI%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
}
],
"backPics":[
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_3_15000.jpg?Signature=qekds78dhYRIrhXw6NK7Xh88nW18FObulqA6aPU7Mcg%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
},
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_4_20000.jpg?Signature=ZyrIX4TJP5MpOYoPRhVTf6L%2BelcNJFlnt7t8J7ucwKk%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
},
{
"url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_5_25000.jpg?Signature=exB1s%2BEQoMq%2FL4BZqyMofQB8H%2FwkiinkpFjG39mDpl0%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
}
]
}
],
"duration":71
}
}
},
"language":{
"taskId":"38e08da8d2574df4bd2eca9b5153df72",
"dataId":"",
"callback":"",
"details":[
{
"type":"en-GB",
"segments":[
{
"startTime":35,
"endTime":40
},
{
"startTime":160,
"endTime":165
}
]
}
]
},
"asr":{
"taskId":"38e08da8d2574df4bd2eca9b5153df72",
"dataId":"",
"callback":"",
"details":[
{
"startTime":0,
"endTime":15,
"content":"5月15日,我国首次火星探测任务着陆火星取得成功。"
}
]
},
"voice":{
"taskId":"7f03cdeaf4cf4c748a4edbe97833a9ee",
"dataId":"",
"callback":"",
"details":{
"mainGender":"male"
}
},
"discern":{
"taskId":"33a188743184455683405c1fe8c5a74f",
"dataId":"",
"pictures":{
"startTime":"1675070777",
"endTime":"1675070777",
"details":{
"discernName":"识别物品名称",
"rate":0.998,
"type":3
}
}
}
}
响应
响应结果
- 客户接口接收到我们回调的结果后,需要返回应答信息,接口响应HTTP状态码为200。当回调处理异常时,应答的HTTP状态码应为500或4xx。
- 目前推送方式默认连接超时(connect timeout)为150ms,回调超时(socket timeout)为2s。建议收到推送检测结果后,优先返回response应答信息,异步处理检测结果,避免因为回调超时,易盾侧未收到响应重复推送结果。如业务侧对于超时配置有特殊要求,可联系易盾策略经理调整配置。
- 应答信息为JSON格式,字段定义如下:
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
code | Number | 是 | 应答code,易盾方解析code为200表示推送成功 |
msg | String | 否 | 具体描述信息 |
响应体示例
{
"code": 200,
"msg": "接收成功"
}