修改頻道音訊審核設定

介面描述

1、<p>更新频道音频审核设置</p>

2、（timestamp, appId, channelId）参与sign签名，并和sign一起通过url传递，请求体参数不参与签名，通过post请求体传递【请设置请求头contentType:application/json】

3、接口支持https协议
4、按账号开通版本校验：audioModerationFunctionEnable 为 Y（金融版）或 AI（大模型版）即视为已开通；未开通（N、空或其他值）返回错误码 1041。请求体为合并结构，金融版提交金融版字段、大模型版提交大模型版字段，由服务端按账号版本校验【详见[校验规则](__PLV_KEEP_0__)】

介面URL

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

線上API呼叫

請求方式

POST

介面限制

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

請求參數描述

請求體參數描述

IllegalNotify參數描述

校驗規則

1、帳號版本由 audioModerationFunctionEnable 判斷：Y=金融版、AI=大模型版；未開通（N、空或其他值）回傳錯誤碼 1041。 2、金融版：moderationStrategy 必填且合法（easy/normal/strict），未傳或非法回傳錯誤碼 30130。 3、大模型版：moderationEnabled=Y 時，llmAuditEnabled 與 badwordEnabled 至少一個為 Y，否則回傳錯誤碼 30131；moderationStrategy 可不傳，服務端落預設值 easy（不參與大模型版審核）。 4、llmAuditEnabled=Y 時，customRule 作為大模型審核規則儲存並參與審核；llmAuditEnabled=N 時 customRule 可保留但不參與審核。 5、notifyUrl 為空表示關閉對外提醒；notifyUrl 有值時按 notifyLevel 判斷需要推送的風險等級（notifyLevel 換算為 notifyScore 落庫：all=0、medium_plus=50、high_only=80）。 6、moderationEnabled=N 時，系統仍儲存子開關配置，但音訊審核不生效。

範例

http://api.polyv.net/live/v4/channel/audio-moderation/update?appId=gga9dadhzm&sign=4D6E18824022FB69A10142E788E2F184&channelId=3775168&timestamp=1678088144335

請求體json參數：

金融版請求範例：

{
  "moderationEnabled": "Y",
  "moderationStrategy": "normal",
  "badwordEnabled": "N",
  "illegalNotify": {
    "monitorEnabled": "Y",
    "talentEnabled": "Y",
    "assistantEnabled": "Y",
    "platformEnabled": "Y"
  }
}

大模型版請求範例：

{
  "moderationEnabled": "Y",
  "llmAuditEnabled": "Y",
  "customRule": "禁止主播引导观众添加微信、QQ等社交账号进行私下交易；禁止主播在直播中提及其他竞品平台名称；禁止主播使用攻击性语言。",
  "badwordEnabled": "Y",
  "illegalNotify": {
    "monitorEnabled": "Y",
    "talentEnabled": "N",
    "assistantEnabled": "Y",
    "platformEnabled": "N",
    "notifyUrl": "https://example.com/audio-moderation/callback",
    "notifyLevel": "medium_plus"
  }
}

回應參數描述

Error參數描述

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 audioModerationUpdateTest() 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/update";
    String channelId = "";
    String badwordEnabled = "";
    String illegalNotify = "";
    String moderationEnabled = "";
    String moderationStrategy = "";
    String assistantEnabled = "";
    String monitorEnabled = "";
    String platformEnabled = "";
    String talentEnabled = "";

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

    Map<String, Object> jsonMap = new HashMap<>();
    jsonMap.put("channelId", channelId);
    jsonMap.put("badwordEnabled", badwordEnabled);
    jsonMap.put("illegalNotify", illegalNotify);
    jsonMap.put("moderationEnabled", moderationEnabled);
    jsonMap.put("moderationStrategy", moderationStrategy);
    jsonMap.put("assistantEnabled", assistantEnabled);
    jsonMap.put("monitorEnabled", monitorEnabled);
    jsonMap.put("platformEnabled", platformEnabled);
    jsonMap.put("talentEnabled", talentEnabled);

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

    url = HttpUtil.appendUrl(url, requestMap);
    String response = HttpUtil.postJsonBody(url, JSON.toJSONString(jsonMap), null);

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

}

回應範例

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

成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "414afeb28f1c4f0ca17e1c3c1e39d247.13959.16780881532635057",
  "data": true,
  "success": true
}

異常範例

{
    "code": 400,
    "status": "error",
    "requestId": "d310b70bc329403f87f77f9203d50f89.128.16360831552223589",
    "error": {
        "code": 20001,
        "desc": "application not found."
    },
    "success": false
}

業務錯誤碼說明