查询频道音频审核记录
更新时间:2026-06-26 16:04:48
接口描述
1、<p>查询频道音频审核记录</p>
2、接口支持https协议
3、按账号开通版本返回记录:audioModerationFunctionEnable 为 Y(金融版)或 AI(大模型版)即视为已开通;未开通(N、空或其他值)返回错误码 1041。审核结果过滤统一使用 resultType 参数,金融版与大模型版取值不同【详见[请求参数描述](#请求参数描述)】
接口URL
http://api.polyv.net/live/v4/channel/audio-moderation/list
请求方式
GET
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | true | String | 账号appId【详见获取密钥】 |
| channelId | true | String | 频道号 |
| sign | true | String | 签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据【详见签名生成规则】 |
| timestamp | true | String | 当前13位毫秒级时间戳,3分钟内有效 |
| startTime | false | Long | 开始时间,毫秒级时间戳,默认值为最近3天,若传入该参数,则 在这一时间到 结束时间 之间的任务将会被筛选出来 |
| endTime | false | Long | 结束时间,毫秒级时间戳,默认值为空,若传入该参数,则 开始时间 到这一时间之间的任务将会被筛选出来。startTime、endTime 同时传入时,最大查询跨度为30天 |
| resultType | false | String | 审核结果过滤,多个用英文逗号分隔。金融版:pass-通过、block-违规、review-疑似;大模型版:pass-通过、low_risk-低风险、medium_risk-中风险、high_risk-高风险。示例:resultType=medium_risk,high_risk。不传时返回当前账号版本下可见的全部记录 |
| moderationStrategy | false | String | (旧参数,已废弃,建议改用 resultType)审核结果过滤,多个用','分隔开(pass:通过,block:违规,review:疑似)。与 resultType 同时传入时以 resultType 为准 |
| pageNumber | false | String | 当前页数,第几页 |
| pageSize | false | String | 分页大小 |
| sessionId | false | String | 场次号 |
示例
http://api.polyv.net/live/v4/channel/audio-moderation/list?pageNumber=1&moderationStrategy=&appId=gga9dadhzm&sign=B64A05B71680D23161511CF0B9617254&pageSize=10&startTime=&endTime=&sessionId=&channelId=3775168×tamp=1678087662266
响应参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 状态码,与 http 状态码相同,用于确定基本的响应状态 |
| data | Object | 【详见Data参数描述】 |
| error | Object | 状态码非200时的错误信息【详见Error参数描述】 |
| requestId | String | 请求ID,每次请求生成的唯一的 UUID,仅可用于排查、调试,不应该和业务挂上钩 |
| status | String | 响应结果,由业务决定,成功返回success,失败返回error |
| success | Boolean | 是否成功响应 |
Data参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| contents | Array | 分页数据集合【详见Contents参数描述】 |
| pageNumber | Integer | 当前页数,第几页 |
| pageSize | Integer | 分页大小 |
| totalItems | Integer | 总记录数 |
| totalPages | Integer | 总页数 |
Contents参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| audioText | String | 音频转写文本 |
| audioUrl | String | 音频切片链接 |
| badword | String | 命中的严禁词 |
| createTime | String | 审核时间 |
| duration | Integer | 音频文件时长 |
| id | Integer | 审核任务的审核ID |
| keyword | String | 命中的敏感词 |
| label | String | 识别类型。金融版:Normal-正常、Porn-色情、Abuse-谩骂、Ad-广告、Custom-自定义违规;大模型版:AiAudit-AI审核、Badword-自定义严禁词、Keyword-自定义敏感词、Normal-正常;以及其他令人反感、不安全或不适宜的内容类型 |
| labelDesc | String | 识别类型描述 |
| moderationStrategy | String | (金融版)审核策略 easy:宽松审核策略,normal:一般审核策略,strict:严格审核策略。大模型版不应使用该字段判断审核结果 |
| moderationStrategyDesc | String | 审核策略描述。大模型版不应使用该字段判断审核结果 |
| reason | String | 违规原因(大模型版) |
| resultType | Integer | 审核结果。金融版:1-通过、2-违规、3-疑似;大模型版:1-通过、4-低风险、5-中风险、6-高风险 |
| score | Integer | 风险评分/置信度,0-100 |
| sessionId | String | 场次id,可能为空,为空时表示当前审核结果还未确认归属到哪个场次 |
| startTime | String | 任务开始时间 |
Error参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误代码,用于确定具体的错误原因 |
| desc | String | 错误描述,与 error.code 对应 |
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
private static final Logger log = LoggerFactory.getLogger(getClass());
/**
* 查询频道审核记录
* @throws IOException
* @throws NoSuchAlgorithmException
*/
@Test
public void audioModerationListTest() throws IOException, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String appId = super.appId;
String appSecret = super.appSecret;
String timestamp = String.valueOf(System.currentTimeMillis());
//业务参数
String url = "http://api.polyv.net/live/v4/channel/audio-moderation/list";
String channelId = "";
String endTime = "";
String moderationStrategy = "";
String pageNumber = "";
String pageSize = "";
String sessionId = "";
String startTime = "";
//http 调用逻辑
Map<String, String> requestMap = new HashMap<>();
requestMap.put("appId", appId);
requestMap.put("channelId", channelId);
requestMap.put("timestamp", timestamp);
requestMap.put("endTime", endTime);
requestMap.put("moderationStrategy", moderationStrategy);
requestMap.put("pageNumber", pageNumber);
requestMap.put("pageSize", pageSize);
requestMap.put("sessionId", sessionId);
requestMap.put("startTime", startTime);
requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
String response = HttpUtil.get(url, requestMap);
log.info("测试查询频道审核记录成功:{}", response);
//do somethings
}
响应示例
系统全局错误说明详见全局错误说明
金融版成功示例
{
"code": 200,
"status": "success",
"requestId": "efbb877ed57a430390b23f7e341d3364.66.16780876444232085",
"data": {
"pageNumber": 1,
"pageSize": 10,
"totalPages": 1,
"totalItems": 1,
"contents": [
{
"id": 10001,
"sessionId": "u7vp3k8f",
"audioUrl": "https://example.com/audio/20260620.mp3",
"audioText": "直播过程中出现的音频转写文本",
"duration": 30,
"label": "Abuse",
"labelDesc": "谩骂",
"moderationStrategy": "normal",
"moderationStrategyDesc": "一般审核策略",
"resultType": 2,
"score": 88,
"badword": "",
"keyword": "",
"reason": "",
"createTime": "2026-06-20 10:00:00",
"startTime": "2026-06-20 09:59:30"
}
]
},
"success": true
}
大模型版成功示例(resultType=medium_risk,label=AiAudit,含 reason)
{
"code": 200,
"status": "success",
"requestId": "efbb877ed57a430390b23f7e341d3364.66.16780876444232085",
"data": {
"pageNumber": 1,
"pageSize": 10,
"totalPages": 1,
"totalItems": 1,
"contents": [
{
"id": 10001,
"sessionId": "u7vp3k8f",
"audioUrl": "https://example.com/audio/20260620.mp3",
"audioText": "本课程涉及未授权软件破解方法,请谨慎处理。",
"duration": 30,
"label": "AiAudit",
"labelDesc": "AI审核",
"moderationStrategy": "easy",
"moderationStrategyDesc": "宽松审核策略",
"resultType": 5,
"score": 72,
"badword": "",
"keyword": "",
"reason": "涉及未授权软件破解方法",
"createTime": "2026-06-20 10:00:00",
"startTime": "2026-06-20 09:59:30"
}
]
},
"success": true
}
异常示例
{
"code": 400,
"status": "error",
"requestId": "d310b70bc329403f87f77f9203d50f89.128.16360831552223589",
"error": {
"code": 20001,
"desc": "application not found."
},
"success": false
}
账号未开通音频审核(audioModerationFunctionEnable 为 N、空或其他值),返回错误码 1041
{
"code": 400,
"status": "error",
"requestId": "d310b70bc329403f87f77f9203d50f89.128.16360831552223589",
"error": {
"code": 1041,
"desc": "账号未开启音频审核功能"
},
"success": false
}
