云服务器内容精选

  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v2/{project_id}/moderation/image”,“project_id”为项目ID,获取方法请参见获取项目ID。 方式一:使用图片的BASE64编码,识别用户上传的图像内容是否有敏感内容,检测场景为涉黄,暴恐, 图像审核 规则为默认规则。 POST https://{endpoint}/v2/{project_id}/moderation/image { "categories" : [ "porn", "terrorism" ], "moderation_rule" : "default", "url" : "", "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...", "threshold" : "" } 方式二:使用图片的url,识别用户上传的图像内容是否有敏感内容,检测场景为涉黄,暴恐,图像审核规则为默认规则。 POST https://{endpoint}/v2/{project_id}/moderation/image { "categories" : [ "porn", "terrorism" ], "moderation_rule" : "default", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "image" : "", "threshold" : "" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见 获取Token 接口,响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 url 否 String 与image二选一。 图片的URL路径,目前支持: 公网HTTP/HTTPS URL 华为云OBS提供的URL,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。 说明: 接口响应时间依赖图片的下载时间,如果图片下载时间过长,会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。 image 否 String 与url二选一。 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 支持JPEG/PNG/BMP/WEBP/GIF格式。 moderation_rule 否 String 图像审核规则名称,默认使用default规则。 说明: 审核规则的创建和使用请参见配置审核规则。 categories 否 Array of strings 检测场景。可添加的检测场景如下: terrorism:暴恐元素的检测。 porn:涉黄内容元素的检测。 ad:广告图文的检测。 all:terrorism和porn等场景的检测,当选择all时,无法再添加其他场景,否则会报错。 可通过配置上述场景,来完对应场景元素的检测。 为空或无此参数表示terrorism检测,但不包含porn场景。 说明: 每个检测场景的检测次数会分类统计。 ad_categories 否 Array of strings 图文审核检测场景。当categories包含ad时,该参数生效。 当前支持的场景有系统场景和用户自定义场景: 系统场景为: qr_code:二维码 porn:涉黄 ad:广告 abuse:辱骂 contraband:违禁品 用户自定义场景为:自定义黑名单词库。 说明: 自定义词库的创建和使用请参见配置自定义词库 V2。 threshold 否 Float 结果过滤门限,只有置信度不低于此门限的结果才会呈现在detail的列表中,取值范围 0-1,当未设置此值时各个检测场景会使用各自的默认值。 terrorism检测场景的默认值为0。 ad检测场景的默认值为0。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。 说明: 如果检测场景中的最高置信度也未达到threshold,则结果列表为空;反之threshold过小,则会使结果列表中内容过多。 threshold参数不支持porn场景筛选。 threshold参数不会对响应中的suggestion产生影响。 show_ocr_text 否 Boolean 是否返回ocr识别结果,默认值为false。
  • 响应示例 状态码: 200 成功响应示例 { "result" : { "detail" : { "terrorism" : [ { "confidence" : 0.7315528178215026, "label" : "xxx" }, { "confidence" : 0.26844718217849733, "label" : "yyy" } ] }, "suggestion" : "block", "category_suggestions" : { "terrorism" : "review" } } } 状态码: 400 失败响应示例 { "error_code" : "AIS.0402", "error_msg" : "The image format is not supported." }
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/image/batch”,“project_id”为项目ID,获取方法请参见获取项目ID。 识别用户上传的图像内容是否有敏感内容,检测场景为涉黄,暴恐。 POST https://{endpoint}/v2/{project_id}/moderation/image/batch { "urls" : [ "https://bucketname.obs.myhwclouds.com/ObjectName1", "https://bucketname.obs.myhwclouds.com/ObjectName2" ], "categories" : [ "terrorism", "porn" ], "threshold" : "" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result Array of ImageBatchModerationResultBody objects 调用成功时表示调用结果。 调用失败时无此字段。 表5 ImageBatchModerationResultBody 参数 参数类型 描述 url String 图片的URL路径。 suggestion String 审核结果是否通过。 block:包含敏感信息,不通过 pass:不包含敏感信息,通过 review:需要人工复检 说明: 当同时检测多个场景时,suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block,所有场景都pass时suggestion为pass,这两种情况之外则一定有场景需要review,此时suggestion为review。 目前本服务不会保存客户的调用结果(如block的历史信息),因为涉及到客户的数据隐私问题,建议您保留接口调用结果的日志信息。 detail ImageDetectionResultDetail object 针对选定的每个检测场景列出结果列表,terrorism为暴恐检测结果,porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。 category_suggestions Object 具体每个场景的检测结果。 block:包含敏感信息,不通过 pass:不包含敏感信息,通过 review:需要人工复检 ocr_text String ocr识别结果,仅在审核图文场景下且“show_ocr_text”=true时返回,否则无此字段,调用失败时也无此字段。 表6 ImageDetectionResultDetail 参数 参数类型 描述 porn Array of ImageDetectionResultSimpleDetail objects 涉黄检测结果。 terrorism Array of ImageDetectionResultSimpleDetail objects 暴恐检测结果。 ad Array of ImageDetectionResultAdDetail objects 广告检测结果。 表7 face_detail 参数 参数类型 描述 h Integer 人脸区域高度。 w Integer 人脸区域宽度。 x Integer 人脸区域左上角到y轴距离。 y Integer 人脸区域左上角到x轴距离。 表8 ImageDetectionResultSimpleDetail 参数 参数类型 描述 confidence Float 置信度,取值范围 0-1。 label String 每个检测结果的标签化说明。 terrorism:label为对应的暴恐元素信息。 暴恐场景当前支持label列表如下: normal:正常(表示您上传的图像不涉及暴恐场景) knife:刀 gun:枪 fire:火灾 bloody :血腥 terrorist:暴恐组织及标志 fascist:法西斯组织及标志 cult:邪教组织及标志 special_characters :特殊文字 kidnap:绑架 corpse:尸体 riot:暴乱事件 parade :游行示威 sensitive_landmarks:敏感地标 military_weapon:军事武器 army:警察部队 crowd:人群聚集 porn:label为对应的涉黄分类(涉黄、性感等)信息。 鉴黄场景当前支持label列表如下: normal:正常(表示您上传的图像内容不涉黄) porn:色情 sexy:性感 ad:label为对应的广告识别结果信息。 广告场景当前支持label列表如下: normal:正常(表示您上传的图像不涉及广告内容) ad:广告 图文审核场景当前支持label列表如下: normal:正常 qr_code:二维码 porn:涉黄 ad:广告 abuse:辱骂 contraband:违禁品 其他自定义黑名单词库名称 表9 ImageDetectionResultAdDetail 参数 参数类型 描述 confidence Float 置信度,取值范围 0-1。 label String ad:label为对应的广告识别结果信息。 广告场景当前支持label列表如下: normal:正常 ad:广告 图文审核场景当前支持label列表如下: normal:正常 qr_code:二维码 porn:涉黄 ad:广告 abuse:辱骂 contraband:违禁品 其他自定义黑名单词库名称 hit_contexts Array of strings 图文审核场景命中的文本列表。 状态码: 400 表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 fail_category String 当包含多个场景时,调用失败的场景。
  • 响应示例 状态码: 200 成功响应示例 { "result": [ { "url": "https://bucketname.obs.myhwclouds.com/ObjectName1", "suggestion": "block", "category_suggestions": { "terrorism": "pass", "porn": "block" }, "detail": { "terrorism": [ { "confidence": 0, "label": "xxx" }, { "confidence": 1, "label": "normal" } ], "porn": [ { "confidence": 0, "label": "normal" }, { "confidence": 1, "label": "xxx" } ] } } ] } 状态码: 400 失败响应示例 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist." }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 urls 是 Array of strings 图片的URL路径,目前支持: 公网HTTP/HTTPS URL 华为云OBS提供的URL,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。 说明: 图片的URL路径列表最多支持10个URL地址。接口响应时间依赖图片的下载时间,如果图片下载时间过长,会返回接口调用失败。请保证被审核图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。 categories 否 Array of strings 检测场景。 terrorism:暴恐元素的检测。 porn:涉黄内容元素的检测。 ad:广告图文的检测。 all:包含terrorism和porn场景的检测。 可通过配置上述场景,来完对应场景元素的检测。 为空或无此参数表示terrorism检测,但不包含porn场景。 说明: 每个检测场景的检测次数会分类统计。 ad_categories 否 Array of strings 图文审核检测场景。当categories包含ad时,该参数生效。 当前支持的场景有系统场景和用户自定义场景: 系统场景为: qr_code:二维码 porn:涉黄 ad:广告 abuse:辱骂 contraband:违禁品 用户自定义场景为:自定义黑名单词库。 说明: 自定义词库的创建和使用请参见配置自定义词库 V2。 threshold 否 Double 结果过滤门限,只有置信度不低于此门限的结果才会呈现在detail的列表中,取值范围 0-1,当未设置此值时各个检测场景会使用各自的默认值。 terrorism检测场景的默认值为0。 ad检测场景的默认值为0。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。 说明: 如果检测场景中的最高置信度也未达到threshold,则结果列表为空;反之如果设置的threshold过小,则会使结果列表中内容过多。 threshold参数不支持porn场景筛选。 threshold参数不会对响应中的suggestion产生影响。 moderation_rule 否 String 图像审核规则名称,默认使用default规则。 说明: 审核规则的创建和使用请参见配置审核规则。 show_ocr_text 否 Boolean 是否返回ocr识别结果,默认值为false。
  • 错误码说明 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 当您调用API时,如果遇到“APIG”开头的错误码,请参见APIG错误码。 状态码 错误码 错误信息 描述 处理措施 400 AIS.0002 The authentication token is abnormal. 验证Token异常。 请检查Token是否正确。 400 AIS.0003 Failed to complete the request because of an internal service error. 服务内部错误。 请联系华为云支持人员,请通过工单联系我们。 400 AIS.0004 The request is unauthorized. 无权限操作。 服务未开通请开通服务。服务开通请参见《 内容审核 快速入门》。 400 AIS.0005 The service does not exist. 服务不存在。 请检查传入的服务类型或场景是否正确,如果无法解决请联系华为云支持人员,请通过工单联系我们。 400 AIS.0007 The service has not been enabled yet. 服务未开通。 请开通服务。开通步骤请参考开通服务步骤说明。 400 AIS.0010 The header is missing or left empty. 缺少Header或者Header为空。 HTTP请求缺少必须的header信息,请检查是否有Content-type等必须字段。 400 AIS.0011 Lack the request parameter, or the request parameter is empty. 缺少请求参数或者参数为空。 请检查请求body是否缺少必须字段,请参考对应API的请求说明。 400 AIS.0012 The request parameter is not supported. 请求参数不支持。 请检查请求中的字段不合法,请参考对应API的请求说明。 400 AIS.0013 The request method is not allowed. 请求方法不允许。 请检查请求方法是否正确。 400 AIS.0014 The JSON format of the input data is incorrect. 输入数据JSON格式错误。 请检查输入数据的JSON格式。 400 AIS.0015 Base64 decoding of the input data is incorrect. 输入数据BASE64解码错误。 图片的Base64编码错误,请检查Base64内容。 400 AIS.0020 The size of the request body exceeds the upper limit. 请求体大小超过限制。 请检查请求体大小。 400 AIS.0021 The requested file type is not supported. 请求的文件类型不支持。 请检查请求的文件类型。 400 AIS.0022 The URL is invalid. URL不合法。 请检查输入的url格式。 400 AIS.0023 The file stored in OBS is oversized. 存储在OBS上的文件过大。 检查图片格式是否是服务支持的格式。具体请参见《内容审核使用限制》。 400 AIS.0024 Failed to obtain the file from OBS. 从OBS上获取文件失败。 原因可能为签名过期或签名验证未通过等。 400 AIS.0025 The file stored in OBS is empty. 存储在OBS上的文件为空。 请先上传文件到OBS上。 400 AIS.0026 Incorrect token type. token类型错误。 应使用project类型的token。 400 AIS.0027 The account has been frozen. 此账户已被冻结。 请检查是否账户是否欠费。 400 AIS.0028 The job is not owned by the current user. 此任务不属于当前用户。 请检查当前账户。 400 AIS.0029 Failed to download the file from the Internet. 从外网下载文件失败。 检查文件url是否正确以及是否在支持的范围内。 400 AIS.0030 Job not found 任务未找到。 任务已过期被清理了或者传入的job id错误。请检查job id是否正确。 400 AIS.0031 The maximum number of uncompleted jobs has been reached. 未处理完的任务总数达到限制。 暂停提交新任务。 400 AIS.0032 The monthly free calls have been used up. 月免费调用量已使用完。 如需继续使用给关联的华为云账户充值即可。 400 AIS.0501 Check whether the request JSON is abnormal. 检查请求json是否存在异常。 请求参数不是json格式。 400 AIS.0502 Check whether the Base64 encoding and URL of the image are correct. 检查图像base64以及url是否正确。 请检查图片base64编码是否正常,检查图片格式是否是服务支持的格式。 400 AIS.0504 The image size does not meet requirements. 图像大小不符合要求。 请检查图像大小是否符合服务限制。 400 AIS.0401 The input parameter is incorrect. 输入参数有误。 请输入正确的参数。 400 AIS.0402 The image format is not supported. 图片格式不支持。 检查图片格式是否是服务支持的格式。 400 AIS.0403 The image file has been damaged. 图片文件已损坏。 请重新上传图片文件。 400 AIS.0404 An exception occurs in Content Moderation . 内容审核处理错误。 请联系华为云支持人员,请通过工单联系我们。 400 AIS.0405 An internal error occurs. 内部错误。 请联系华为云支持人员,请通过工单联系我们。 400 APIG.0101 The API does not exist or has not been published. 您所访问的API不存在或尚未在环境中发布。 请检查输入的api信息是否正确,是否该服务存在对应的区域中。检查API的URL是否拼写正确,HTTP请求方法(POST,GET等)是否正确,请检查服务调用配置的 域名 和uri信息是否正确,域名可参考域名。 400 APIG.0301 1. Incorrect IAM authentication information: Failed to decrypt the token. Check whether the entered token is complete. 2. The validity period of a token is 24 hours. If the token expires, obtain a new token and pass it. 3. The AK/SK authentication fails. Check whether the AK/SK is correct and whether the account is restricted due to arrears. 1.IAM身份验证信息不正确:解密令牌失败,检查输入的token是否完整。 2.token有效期为24小时,token超时,重新传入获取token值。 3.因为AK/SK认证失败,请检查AK/SK是否正确,账号是否因欠费等原因权限被限制。 decrypt token fail:发送的HTTP请求header中x-auth-token的token请求认证信息错误,请检查发送的请求和token。 token expires:token超时,请重新获取新token传入。 verify aksk signature fail:请检查AK、SK是否正确,账号是否欠费。 400 APIG.0201 The request body is oversized. 请求体过大。 请检查请求的body体是否过大,具体请参见《内容审核使用限制》,进行调整。 400 APIG.0308 The request is sent too fast and exceeds the default rate limit of the service. 请求发送太快,超过了服务的默认配置限流。 请求发送太快,达到了API的限速阈值,请降低请求速度。如有更高请求速度要求,请联系华为云支持人员,请通过工单联系我们。 400 ModelArts.0203 Invalid token. 非法Token。 请检查Token是否正确。 400 ModelArts.4101 The token is empty. Token为空。 发送的HTTP请求header中没有带x-auth-token的token请求认证信息,请检查发送的请求。 400 ModelArts.4102 Failed to parse the token. 解析Token失败。 发送的HTTP请求header中x-auth-token的token请求认证信息错误,请检查发送的请求和token。 400 ModelArts.4103 The token is invalid. Token不合法。 发送的HTTP请求header中x-auth-token的token请求认证信息错误,请检查发送的请求和token。 400 ModelArts.4104 The length of the request body is invalid. 请求body体长度不合法。 请检查请求body体长度。 400 ModelArts.4105 The JSON format of the request body is incorrect. 请求body体json格式不对。 请检查请求body体是否符合json格式。 400 ModelArts.4106 The account is restricted. 用户账号受限。 请检查用户资源状态,账号受限原因请参考账号中心相关描述。 400 ModelArts.4107 An exception occurred when obtaining the temporary AK/SK. 获取用户临时AK,SK异常。 请联系华为云支持人员,通过工单联系我们。 400 ModelArts.4201 The request URL does not contain the service ID. 请求url中需要包含服务ID。 请检查请求url中的服务ID。 400 ModelArts.4202 The request URL format is invalid. 请求url格式不合法。 请检查请求url格式。 400 ModelArts.4203 No access permission. 没有权限访问。 请检查访问权限。 400 ModelArts.4204 The API is not subscribed to. 没有订阅该API。 请订阅该API,订阅API请参考服务介绍开通申请服务。如已开通服务,请检查开通服务的区域与服务调用的一致,如果一致请检查API的URL是否拼写正确,HTTP请求方法(POST,GET等)是否正确。 400 ModelArts.4601 The external URL is invalid. 外网下载地址不合法。 请检查输入的url下载地址参数格式。 400 ModelArts.4603 The file failed to be downloaded from the external URL. 下载外网URL文件失败。 请检查输入的url是否可下载。 400 ModelArts.4702 The OBS agency failed to be queried. 查询OBS委托失败。 请检查是否已开通给服务的OBS委托。 400 ModelArts.4703 The OBS URL is invalid. OBS地址不合法。 请检查输入的OBS的url地址。 400 ModelArts.4704 Failed to obtain the OBS file. 获取OBS文件失败。 下载OBS文件失败,请检查对应的文件是否存在。 400 ModelArts.4705 The OBS file is oversized. OBS文件大小超限。 请使用符合服务大小限制的文件作为输入,具体请参见《内容审核使用限制》。 400 ModelArts.4706 The OBS file does not exist. OBS文件不存在。 下载OBS文件失败,请检查对应的文件是否存在。 400 其他 如果出现其他无法解决的错误码,请通过工单联系我们。
  • 请求示例 创建视频流内容审核作业。 POST https://{endpoint}/v3/{project_id}/moderation/video-stream/jobs { "data" : { "url" : "xxx", "frame_interval" : 3 }, "event_type" : "default", "image_categories" : [ "politics", "porn", "image_text", "terrorism" ], "audio_categories" : [ "porn", "ad", "politics", "moan", "abuse" ], "callback" : "xxx" }
  • 响应示例 状态码: 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 本次请求的唯一标识,用于问题排查,建议保存。 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 data object 视频流数据输入。 event_type 是 String 事件类型,可选值为default,default表示默认事件。 image_categories 是 Array of strings 视频流中画面需要检测的风险类型,列表不能为空。 可选择的风险类型如下: porn:鉴黄内容的检测 terrorism:暴恐内容的检测 image_text:图文违规内容的检测(检测图片中出现的广告、色情、暴恐的文字违规内容以及二维码内容) audio_categories 否 Array of strings 视频流中音频需要检测的风险类型,不传或为空时表示不审核音频维度。 可选择的风险类型如下: porn:涉黄检测 abuse: 辱骂检测 ad: 广告检测 moan: 娇喘检测 callback 是 String 该字段非空时,检测结果会回调通知您的URL。视频流未结束时,检测片段违规时回调客户端,视频流结束时,检测片段违规或正常都将回调客户端。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询视频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 data 参数 是否必选 参数类型 描述 url 是 String 视频流url,支持rtmp、rtmps、hls、http、https等主流协议。 frame_interval 否 Integer 截帧频率间隔,单位为秒,取值范围为1~60s;如果不传递默认5s截帧一次。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 data object 音频流数据输入。 event_type 是 String 事件类型,可选值如下: default:默认事件 audiobook:有声书 education:教育音频 game:游戏语音房 live:秀场直播 ecommerce:电商直播 voiceroom:交友语音房 private:私密语音聊天 categories 是 Array of strings 需要检测的风险类型,列表不能为空。可选择的风险类型如下: porn:涉黄检测 abuse: 辱骂检测 ad: 广告检测 moan: 娇喘检测 callback 是 String 该字段非空时,检测结果会回调通知您的URL。音频流未结束时,检测片段违规时回调客户端,音频流结束时,检测片段违规或正常都将回调客户端。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询音频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 data 参数 是否必选 参数类型 描述 url 是 String 音频流url地址,支持rtmp、rtmps、hls、http、https等主流协议。 language 否 String 支持检测的音频流语言。可选值为zh:中文。 不传该参数表示默认为zh。
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯一标识,用于问题排查,建议保存。 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48", "request_id" : "07490f57ac5e034c077ab25b5f9e1da5" } 状态码: 400 失败响应示例 { "error_code" : "AIS.0401", "error_msg" : "The input parameter event_type is incorrect." }