保利威文档中心

幫助中心

查詢頻道音訊審核設定（需開通）

更新時間：2026-06-26 16:04:48

介面描述

1、查询频道音频审核设置
2、接口支持https协议
3、按账号开通版本返回配置：账号 audioModerationFunctionEnable 为 Y（金融版）或 AI（大模型版）即视为已开通音频审核；未开通（N、空或其他值）返回错误码 1041。返回对象为合并结构，金融版与大模型版字段同时返回，调用方按账号版本取用即可

介面URL

http://api.polyv.net/live/v4/channel/audio-moderation/get

線上API呼叫

請求方式

GET

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數描述

參數名 必選 類型 說明
appId true String 帳號appId【詳見取得金鑰】
channelId true String 頻道ID
sign true String 簽名，為32位大寫的MD5值，產生簽名的appSecret金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料【詳見簽名產生規則】
timestamp true String 當前13位毫秒級時間戳，3分鐘內有效

範例

http://api.polyv.net/live/v4/channel/audio-moderation/get?appId=gga8efhn0h&sign=A172F9012D17020EEB0BF343492FB26D&channelId=3791474&timestamp=1678087256825

回應參數描述

參數名 類型 說明
code Integer 狀態碼，與http狀態碼相同，用於確定基本的回應狀態
data Object 【詳見Data參數描述】
error Object 狀態碼非200時的錯誤資訊【詳見Error參數描述】
requestId String 請求ID，每次請求產生的唯一UUID，僅可用於排查、除錯，不應該和業務掛鉤
status String 回應結果，由業務決定，成功回傳success，失敗回傳error
success Boolean 是否成功回應

Data參數描述

參數名 類型 說明
badwordEnabled String 應用嚴禁詞開關，Y/N
channelId Integer 頻道id
customRule String 自訂審核規則（大模型版，llmAuditEnabled=Y 時作為審核規則生效）
illegalNotify Object 違規提醒配置【詳見IllegalNotify參數描述】
llmAuditEnabled String 大模型審核開關，Y/N（大模型版）
moderationEnabled String 審核開關，Y/N
moderationStrategy String 審核策略（金融版）
easy：寬鬆審核策略
normal：一般審核策略
strict：嚴格審核策略
userId String POLYV用戶ID，與保利威官網一致，取得路徑：官網->登入->直播（開發設定）

回傳為合併結構：金融版帳號會一併回傳大模型版欄位（llmAuditEnabled、customRule、illegalNotify.notifyLevel 等，可能為空），大模型版帳號會一併回傳 moderationStrategy（預設 easy，不參與大模型版審核）。呼叫方按帳號開通版本取用對應欄位即可。

IllegalNotify參數描述

參數名 類型 說明
assistantEnabled String 助理提醒，Y/N
monitorEnabled String 監播提醒，Y/N
notifyLevel String 接收提醒等級（大模型版）
all：所有風險項目
medium_plus：中風險及以上
high_only：僅高風險項目
notifyUrl String 對外提醒URL（大模型版）；為空表示對外提醒未開啟，有值時違規事件會推送到該URL
platformEnabled String 平台通知，Y/N
talentEnabled String 主播提醒，Y/N

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 audioModerationGetTest() 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/get";
    String channelId = "";

    //http 调用逻辑
    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("channelId", channelId);
    requestMap.put("timestamp", timestamp);

    requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));

    String response = HttpUtil.get(url, requestMap);

    log.info("测试查询频道音频审核设置成功：{}", response);
    //do somethings

}

回應範例

系統全域錯誤說明詳見全域錯誤說明

金融版成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "414afeb28f1c4f0ca17e1c3c1e39d247.10285.16780871639086817",
  "data": {
    "userId": "4bcae48f78",
    "channelId": 3791474,
    "moderationEnabled": "Y",
    "moderationStrategy": "normal",
    "badwordEnabled": "N",
    "llmAuditEnabled": "N",
    "customRule": "",
    "illegalNotify": {
      "monitorEnabled": "Y",
      "talentEnabled": "Y",
      "assistantEnabled": "Y",
      "platformEnabled": "Y"
    }
  },
  "success": true
}

大模型版成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "414afeb28f1c4f0ca17e1c3c1e39d247.10285.16780871639086817",
  "data": {
    "userId": "4bcae48f78",
    "channelId": 3791474,
    "moderationEnabled": "Y",
    "moderationStrategy": "easy",
    "badwordEnabled": "Y",
    "llmAuditEnabled": "Y",
    "customRule": "禁止主播引导观众添加微信、QQ等社交账号进行私下交易；禁止主播在直播中提及其他竞品平台名称；禁止主播使用攻击性语言。",
    "illegalNotify": {
      "monitorEnabled": "Y",
      "talentEnabled": "N",
      "assistantEnabled": "Y",
      "platformEnabled": "N",
      "notifyUrl": "https://example.com/audio-moderation/callback",
      "notifyLevel": "medium_plus"
    }
  },
  "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
}
联系客服，在线咨询