查询断句
2024.10.15 18:18:14
内容安全直播音频查询音频断句，客户可以通过轮询调用该接口获取数据。
接口说明
该接口支持客户根据提交检测时返回的taskId查询音频的断句内容，需要客户通过该接口进行定时轮询获取。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权
结果说明
- 接口一次最多返回1000个结果，最多查询7天内的提交的直播
- 接口请求频率建议1s一次，过快服务器会拒绝处理，客户可以根据业务需求进行适当调整
接口耗时
结果获取接口的响应很快，正常100ms内返回结果，业务方根据需求适当调整超时时间，建议为1s
请求
请求地址
| 名称 | 值 |
|---|---|
| HTTP URL | http://as.dun.163.com/v1/liveaudio/query/task |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | String | 是 | 固定值："application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成
公共参数
公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数
业务参数
| 名称 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| version | String | 是 | 4 | 接口版本v1 |
| taskId | String | 是 | 32 | 易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询 |
| startTime | Number | 是 | 13 | 查询断句起始时间，单位毫秒，查询时间区间最多10分钟 |
| endTime | Number | 是 | 13 | 查询断句结束时间，单位毫秒，查询时间区间最多10分钟 |
请求体示例
version=v1&signature=xxx&secretId=xxx&businessId=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 | 是 | 直播音频断句检测结果，0-通过，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 | 否 | 命中的敏感词或者声纹检测的分值 |
| ∟records | Object[] | 否 | 录制信息 |
| ∟startTime | Number | 是 | 最近开始时间点，单位毫秒 |
| ∟endTime | Number | 是 | 最近结束时间点，单位毫秒 |
| ∟url | String | 是 | 录制地址 |
响应体示例
{
"code": 200,
"msg": "ok",
"result": [
{
"taskId":"38e08da8d2574df4bd2eca9b5153df72",
"action":2,
"asrStatus":3,
"callback":"",
"censorSource":"2",
"speakerId":"10096",
"startTime":1584415110890,
"endTime":1584415115720,
"segments":[
{
"label":400,
"level":2,
"evidence":"(我+你)"
}
],
"records":[
{
"startTime":1584415091830,
"endTime":1584415111830,
"url":"https://yidun-antispam.nos-eastchina1.126.net/5473fbabe7774dbc9cc80e12d60f6fb6_1584415091830.mp3?Signature=9lVvAIpjHF7lsJNhzuH4FrgebpfZGwiotjBCa%2FdfTq4%3D&Expires=1585330675&NOSAccessKeyId=a681ebcbcd5646a488d275c33acb16bd"
}
]
}
]
}
响应返回码
响应返回码见：响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 服务端 SDK 接入指引 了解更多。
