查询断句
2024.10.10 16:17:24
内容安全直播音视频查询音频断句,客户可以通过轮询调用该接口获取数据。
接口说明
该接口支持客户根据提交检测时返回的taskId查询音频的断句内容,需要客户通过该接口进行定时轮询获取。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
结果说明
- 接口一次最多返回1000个结果,最多查询7天内的提交的直播
- 接口请求频率建议1s一次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整
接口耗时
结果获取接口的响应很快,正常100ms内返回结果,业务方根据需求适当调整超时时间,建议为1s
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | http://as.dun.163.com/v1/livewallsolution/query/audio/task |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成
公共参数
公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数
业务参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本v1 |
taskId | String | 是 | 32 | 直播音视频taskId,示例值:"38e08da8d2574df4bd2eca9b5153df72" |
startTime | Number | 是 | 13 | 查询断句起始时间,单位毫秒,查询时间区间最多10分钟 |
endTime | Number | 是 | 13 | 查询断句结束时间,单位毫秒,查询时间区间最多10分钟 |
请求体示例
version=v1&signature=xxx&secretId=xxx&taskId=38e08da8d2574df4bd2eca9b5153df72&startTime=1633017600000&endTime=1633017660000
响应
该接口可以返回直播音视频机器检测断句信息。
响应结果
响应字段如下,响应公共字段已省略,详细见响应公共字段,详细字段信息如下:
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
result | Object[] | 是 | 直播音视频音频检测结果 |
∟taskId | String | 是 | 直播唯一标识 |
∟asrStatus | Number | 是 | 直播检测状态,2-检测中,3-检测完成,4-检测失败 |
∟asrResult | Number | 否 | 音频翻译检测失败原因,1-文件格式错误,2-文件下载失败,3-解析失败,4-音频流不存在 |
∟callback | String | 否 | 产品调用直播音视频在线检测传递的 callback 字段数据 |
∟segmentId | String | 是 | 直播音频断句id |
∟action | Number | 是 | 直播音频断句检测结果,1-嫌疑,2-不通过 |
∟censorSource | Number | 是 | 审核来源,0-易盾人审,1-客户人审,2-易盾机审 |
∟speakerId | String | 否 | 针对接入SDK监听客户,可能返回的说话人ID信息 |
∟startTime | Number | 是 | 最近开始时间点,单位毫秒 |
∟endTime | Number | 是 | 最近结束时间点,单位毫秒 |
∟segments | Object[] | 否 | 证据信息,通过时数据为空 |
∟label | Number | 是 | 分类信息,100-色情,200-广告,300-暴恐,400-违禁,500-涉政,600-谩骂,1100-涉价值观 |
∟level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟evidence | String | 否 | 命中的敏感词或者声纹检测的分值 |
响应体示例
{
"code": 200,
"msg": "ok",
"result": [
{
"taskId":"5473fbabe7774dbc9cc80e12d60f6fb6",
"action":2,
"asrStatus":3,
"callback":"",
"censorSource":"2",
"speakerId":"10096",
"startTime":1584415110890,
"endTime":1584415115720,
"segments":[
{
"label":400,
"level":2,
"evidence":"(我+你)"
}
]
}
]
}
响应返回码
响应返回码见:响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 了解更多。
Github Demo 地址
Gitee Demo 地址(Github 无法访问时选择)
该接口的使用方法可参考SDK demo