云服务器内容精选

  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48", "request_id" : "07490f57ac5e034c077ab25b5f9e1da5" } 状态码: 400 失败响应示例 { "error_code": "AIS.0401", "error_msg": "The input parameter event_type is incorrect." }
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯一标识,用于问题排查,建议保存。 最小长度:2 最大长度:64 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/audio/jobs”,“project_id”为项目ID,获取方法请参见获取项目ID。 创建音频 内容审核 作业,事件类型为默认事件,检测的风险类型为涉黄,广告。 POST https://{endpoint}/v3/{project_id}/moderation/audio/jobs { "data" : { "url" : "https://xxxxx.wav" }, "event_type" : "default", "categories" : [ "porn", "ad" ], "callback" : "http://xxxx" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 AudioInputBody object 音频数据输入。 event_type 否 String 事件类型,可选值如下: default:默认事件 audiobook:有声书 education:教育音频 game:游戏语音房 live:秀场直播 ecommerce:电商直播 voiceroom:交友语音房 private:私密语音聊天 categories 否 Array of strings 需要检测的风险类型,列表不能为空。 风险类型如下: porn:涉黄检测 ad:广告检测 moan:娇喘检测 abuse:辱骂检测 callback 否 String 该字段非空时,检测结果会回调通知您的URL。该字段为空时,您需要定时轮询获取检测结果。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询音频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 biz_type 否 String 用户在控制台界面创建的自定义审核策略名称。 如果请求参数中传了biz_type则优先使用biz_type,event_type和categories参数将不生效,审核策略由biz_type的设置决定。 如果用户没传biz_type则event_type和categories必须传。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 AudioInputBody 参数 是否必选 参数类型 描述 url 是 String 音频url地址。 language 否 String 支持检测的音频语言。可选值为zh:中文。 不传该参数表示默认为zh。
  • 查询音频内容审核作业 本章节对查询音频审核AK/SK方式使用SDK进行示例说明。 示例代码中需要配置使用RunQueryAudioModerationJobRequest类的withJobId配置审核任务的id,配置完成后运行即可。 服务所在的应用区域和终端节点,详情请查看 地区和终端节点 。 package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.moderation.v3.region.ModerationRegion; import com.huaweicloud.sdk.moderation.v3.*; import com.huaweicloud.sdk.moderation.v3.model.*; public class RunQueryAudioModerationJobSolution { public static void main(String[] args) { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全 // 本示例以ak和sk保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv("HUAWEICLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); ModerationClient client = ModerationClient.newBuilder() .withCredential(auth) .withRegion(ModerationRegion.valueOf("xxx")) //把xxx替换成服务所在的区域,例如北京四:cn-north-4。 .build(); RunQueryAudioModerationJobRequest request = new RunQueryAudioModerationJobRequest(); request.withJobId("xxx"); try { RunQueryAudioModerationJobResponse response = client.runQueryAudioModerationJob(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } 控制台输出查询音频内容审核作业的结果,查询音频内容审核结果输出到控制台。 class RunQueryAudioModerationJobResponse { jobId: 01661702400_cd06d61c16a14565995fcbfb04877bd3 status: running result: null requestParams: class AudioModerationResultRequestParams { eventType: default data: class AudioModerationResultRequestParamsData { url: https://****.wav } callback: null categories: [porn] } createTime: 2022-08-29T11:57:14.014Z updateTime: 2022-08-29T11:57:14.014Z requestId: 57ea754a1fdec2d13e4e8ffbff6a458d } 父主题: 音频审核