图像审核-华为云

内容审核 MODERATION-图像内容审核（同步批量）（V3）:请求示例

请求示例使用图片的url POST https://{endpoint}/v3/{project_id}/moderation/image/batch { "event_type" : "comment", "categories" : [ "string" ], "image_text_config" : { "black_glossary_names" : [ "string" ], "white_glossary_names" : [ "string" ] }, "urls" : [ { "url" : "http://xxxxxx.com/qweqeqeqz.jpg", "data_id" : "1234" } ], "language" : "zh" } 使用bizType POST https://{endpoint}/v3/{project_id}/moderation/image/batch { "urls" : [ { "url" : "http://xxxxxx.com/qweqeqeqz.jpg", "data_id" : "1234" } ], "language" : "zh", "biz_type" : "test_type" }

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（同步批量）（V3）:响应参数

响应参数状态码： 200 表6 响应Body参数参数参数类型描述 request_id String 本次请求的唯一标识，用于问题排查，建议保存。 results Array of ImageDetectionResult objects 调用结果。表7 ImageDetectionResult 参数参数类型描述 suggestion String 审核结果是否通过。 block：包含敏感信息，不通过。 pass：不包含敏感信息，通过。 review：需要人工复检。 category String 检测结果的一级标签。支持category列表如下： terrorism: 暴恐。 porn: 色情。 image_text: 图文审核。 details Array of ImageDetectionResultDetail objects 检测详情。 ocr_text String 图文审核检测出的文本，只有在category参数配置image_text且检测出文本时展示该字段。 data_id String 图片唯一标识。同一次请求中不可重复，由大小写英文字母、数字、下划线（_）、中划线（-）组成，不超过30个字符。 error_code String 调用失败时的错误码，具体请参见错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。表8 ImageDetectionResultDetail 参数参数类型描述 suggestion String 审核结果是否通过。 block：包含敏感信息，不通过。 review：需要人工复检。 category String 检测结果的一级标签。支持category列表如下： terrorism: 暴恐。 porn: 色情。 image_text: 图文审核。 confidence Float 置信度，可选值在0-1之间，值越大，可信度越高。 face_location FaceLocationDetail object 人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567]，207代表的是左上角的横坐标，522代表左上角的纵坐标，340代表的是右下角的横坐标，567代表的是右下角的纵坐标。 qr_location QRLocationDetail object 图片中二维码指向的链接，当请求参数categories中包含image_text时存在。 qr_content String 图片中二维码指向的链接，当请求参数categories中包含image_text时存在。 segments Array of OCRTextDetail objects image_text场景下命中的文本片段。 label String 识别的详细标签。表9 FaceLocationDetail 参数参数类型描述 top_left_x Integer 检测出人脸的左上角横坐标。 top_left_y Integer 检测出人脸的左上角纵坐标。 bottom_right_x Integer 检测出人脸的右下角横坐标。 bottom_right_y Integer 检测出人脸的右下角纵坐标。表10 QRLocationDetail 参数参数类型描述 top_left_x Integer 检测出的二维码左上角横坐标。 top_left_y Integer 检测出的二维码左上角纵坐标。 bottom_right_x Integer 检测出的二维码右下角横坐标。 bottom_right_y Integer 检测出的二维码右下角纵坐标。表11 OCRTextDetail 参数参数类型描述 segment String 命中的风险片段。 glossary_name String 命中的自定义词库名称。命中自定义词库时，才会返回当前字段。状态码： 400 表12 响应Body参数参数参数类型描述 error_code String 错误码最小长度：8 最大长度：36 error_msg String 错误描述最小长度：2 最大长度：512

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（同步批量）（V3）:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见获取Token 接口，响应消息头中X-Subject-Token的值即为Token。表3 请求Body参数参数是否必选参数类型描述 event_type 否 String 事件类型。可选值如下： head_image：头像。 album：相册。 dynamic：动态。 article：帖子。 comment：评论。 room_cover：房间封面。 group_message：群聊图片。 message：私聊图片。 product：商品图片。说明：如果请求参数中包含biz_type则优先使用biz_type，event_type和categories参数将不生效，审核策略由biz_type的设置决定。如果未传biz_type则event_type和categories为必传参数。 categories 否 Array of strings 检测场景。可添加的检测场景如下： terrorism：暴恐元素的检测。 porn：涉黄元素的检测。 image_text：广告图文的检测。可通过配置上述场景，来完对应场景元素的检测。每个检测场景的检测次数会分类统计。说明：如果请求参数中包含biz_type则优先使用biz_type，event_type和categories参数将不生效，审核策略由biz_type的设置决定。如果未传biz_type则event_type和categories为必传参数。 image_text_config 否 image_text_config object 图文审核黑白词库配置。 urls 是 Array of urls objects 图片url列表。最大支持12张图片。 language 否 String 指定图片中文字语种类型。 zh: 中文（默认值为zh，中国站仅支持zh）。 en: 英文。 biz_type 否 String 用户在控制台界面创建的自定义审核策略名称。如果请求参数中包含biz_type则优先使用biz_type，event_type和categories参数将不生效，审核策略由biz_type的设置决定。如果未传biz_type则event_type和categories为必传参数。表4 image_text_config 参数是否必选参数类型描述 black_glossary_names 否 Array of strings 检测时使用的自定义黑名单词库列表。 white_glossary_names 否 Array of strings 检测时使用的自定义白名单词库列表。表5 urls 参数是否必选参数类型描述 url 是 String 图片url，目前支持：公网HTTP/HTTPS URL。 data_id 是 String 图片唯一标识。同一次请求中不可重复，由大小写英文字母、数字、下划线（_）、中划线（-）组成，不超过30个字符。

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（V3）:请求示例

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的endpoint不同，具体请参见终端节点。例如，服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”，请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/image”，“project_id”为项目ID，获取方法请参见获取项目ID。使用图片的BASE64编码，分析并识别用户上传的图像内容是否有敏感内容，事件类型为头像，检测场景为涉黄，暴恐。 POST https://{endpoint}/v3/{project_id}/moderation/image { "event_type" : "head_image", "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...", "categories" : [ "porn", "terrorism" ], "image_text_config" : { "black_glossary_names" : [ "test" ] } } 使用图片的url，分析并识别用户上传的图像内容是否有敏感内容，事件类型为头像，检测场景为涉黄，暴恐。 POST https://{endpoint}/v3/{project_id}/moderation/image { "event_type" : "head_image", "url" : "https://bucketname.obs.myhwclouds.com/ObjectName1", "categories" : [ "porn", "terrorism" ], "image_text_config" : { "black_glossary_names" : [ "test" ] } } 使用biz_type请求 POST https://{endpoint}/v3/{project_id}/moderation/image { "url" : "https://bucketname.obs.myhwclouds.com/ObjectName1", "biz_type" : "test-type" }

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（V3）:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 request_id String 本次请求的唯一标识，用于问题排查，建议保存。最小长度：2 最大长度：64 result ImageDetectionResult object 调用成功时表示调用结果。调用失败时无此字段。表6 ImageDetectionResult 参数参数类型描述 suggestion String 审核结果是否通过。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 category String 检测结果的一级标签。支持category列表如下： terrorism: 暴恐 porn: 色情 image_text: 图文审核 details Array of ImageDetectionResultDetail objects 检测详情。 ocr_text String 图文审核检测出的文本，只有在category参数配置image_text且检测出文本时展示该字段。表7 ImageDetectionResultDetail 参数参数类型描述 suggestion String 审核结果是否通过。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 category String 检测结果的一级标签。支持category列表如下： terrorism: 暴恐 porn: 色情 image_text: 图文审核 confidence Float 置信度，可选值在0-1之间，值越大，可信度越高。 face_location FaceLocationDetail object 人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如：[207,522,340,567]，207代表的是左上角的横坐标，522代表左上角的纵坐标，340代表的是右下角的横坐标，567代表的是右下角的纵坐标。 qr_location QRLocationDetail object 二维码位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如：[207,522,340,567]，207代表的是左上角的横坐标，522代表左上角的纵坐标，340代表的是右下角的横坐标，567代表的是右下角的纵坐标。 qr_content String 图片中二维码指向的链接，当请求参数categories中包含image_text时存在。 segments Array of OCRTextDetail objects image_text场景下命中的文本片段。 label String 识别的详细标签。表8 FaceLocationDetail 参数参数类型描述 top_left_x Integer 检测出人脸的左上角横坐标。 top_left_y Integer 检测出人脸的左上角纵坐标。 bottom_right_x Integer 检测出人脸的右下角横坐标。 bottom_right_y Integer 检测出人脸的右下角纵坐标。表9 QRLocationDetail 参数参数类型描述 top_left_x Integer 检测出的二维码左上角横坐标。 top_left_y Integer 检测出的二维码左上角纵坐标。 bottom_right_x Integer 检测出的二维码右下角横坐标。 bottom_right_y Integer 检测出的二维码右下角纵坐标。表10 OCRTextDetail 参数参数类型描述 segment String 命中的风险片段 glossary_name String 命中的自定义词库名称。命中自定义词库时，才会返回当前字段。状态码： 400 表11 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参见错误码。调用成功时无此字段。最小长度：8 最大长度：36 error_msg String 调用失败时的错误信息。调用成功时无此字段。最小长度：2 最大长度：512

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（V3）:响应示例

响应示例状态码： 200 成功响应示例 { "request_id" : "53f9719c3730d1169e47403d5c8a9473", "result" : { "category" : "porn", "details" : [ { "category" : "porn", "confidence" : 0.9934315, "label" : "sexy_female", "suggestion" : "review" }, { "category" : "porn", "confidence" : 0.99798274, "label" : "intimacy", "suggestion" : "review" } ], "suggestion" : "review" } } 状态码： 400 失败响应示例 { "error_code" : "AIS.0402", "error_msg" : "The image format is not supported." }

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（V3）:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 Enterprise-Project-Id 否 String 企业项目ID。Moderation支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。企业项目创建步骤请参见用户指南。说明：创建企业项目后，在传参时，有以下三类场景：携带正确的ID，正常使用Moderation服务，账单的企业项目会被分类到企业ID对应的企业项目中。携带格式正确但不存在的ID，正常使用Moderation服务，账单的企业项目会显示对应不存在的企业项目ID。不携带ID或格式错误ID（包含特殊字符等），正常使用Moderation服务，账单的企业项目会被分类到"default"中。表3 请求Body参数参数是否必选参数类型描述 event_type 否 String 事件类型。可选值如下： head_image：头像 album：相册 dynamic：动态 article：帖子 comment：评论 room_cover：房间封面 group_message：群聊图片 message：私聊图片 product：商品图片说明：群聊图片是指多人聊天的图片。事件类型是服务提前预置的业务场景（部分场景下存在未拦截情况）。如果您需要开启自定义审核策略，可以通过在控制台上自行添加自定义策略。如果您有特殊的审核需求，如果工单的方式联系我们进行调整。 categories 否 Array of strings 检测场景。可添加的检测场景如下： terrorism：暴恐元素的检测。 porn：涉黄元素的检测。 image_text：广告图文的检测。可通过配置上述场景，来完对应场景元素的检测。说明：每个检测场景的检测次数会分类统计。 image_text_config 否 ImgTextConfig object 图文审核黑白词库配置。 url 否 String 与image二选一。图片url，目前支持：公网HTTP/HTTPS URL。 image 否 String 与url二选一。图片文件Base64编码字符串，要求base64编码后大小不超过10M，图片宽高不低于20 x 20像素，支持JPG/PNG/JPEG/WEBP/GIF/TIFF/TIF/HEIF等格式。 language 否 String 可指定图片中的文字语种，目前支持中文（zh）。默认值为zh。 biz_type 否 String 用户在控制台界面创建的自定义审核策略名称，具体创建步骤请参见策略管理。如果请求参数中传了biz_type则优先使用biz_type，event_type和categories参数将不生效，审核策略由biz_type的设置决定。如果用户没传biz_type则event_type和categories必须传。表4 ImgTextConfig 参数是否必选参数类型描述 black_glossary_names 否 Array of strings 检测时使用的自定义黑名单词库列表。详情请看配置自定义词库 V3。 white_glossary_names 否 Array of strings 检测时使用的自定义白名单词库列表。详情请看配置自定义词库 V3。

内容审核 MODERATION 图像审核

内容审核 MODERATION-图像内容审核（V2）

图像内容审核（V2）本章节对图像内容审核AK/SK方式使用SDK进行示例说明。示例代码中可以修改ImageDetectionReq的url或image方法配置图像信息（image和url参数二选一），示例中以url为例配置完成后运行即可。服务所在的应用区域和终端节点，详情请查看地区和终端节点。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkmoderation.v2.region.moderation_region import ModerationRegion from huaweicloudsdkmoderation.v2 import ModerationClient,RunImageModerationRequest,ImageDetectionReq import os if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) client = ModerationClient.new_builder() \ .with_credentials(credentials) \ .with_region(ModerationRegion.value_of("xxx")) \ //把xxx替换成服务所在的区域，例如北京四：cn-north-4。 .build() try: request = RunImageModerationRequest() listImageDetectionReqCategoriesbody = [ "terrorism", "porn", "ad" ] request.body = ImageDetectionReq( threshold=0, categories=listImageDetectionReqCategoriesbody, moderation_rule="default", url="https://XXX.jpg" //此处替换为公网可以访问的图片地址 ) response = client.run_image_moderation(request) print(response.status_code) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 控制台输出200即表示程序执行成功，图像内容审核结果输出到控制台。 200 {"result": {"detail": { "porn": [{"confidence": 0.9883, "label": "normal"}, {"confidence": 0.0039, "label": "porn"}, {"confidence": 0.0078, "label": "sexy"}], "terrorism": [{"confidence": 0.0002, "label": "terrorist"}, {"confidence": 0.0002, "label": "fascist"}, {"confidence": 0.0001, "label": "cult"}, {"confidence": 0.0002}, {"confidence": 0.0001, "label": "kidnap"}, {"confidence": 0.0006, "label": "riot"}, {"confidence": 0.0001, "label": "parade"}, {"confidence": 0.0002, "label": "corpse"}, {"confidence": 0.0001, "label": "bloody"}, {"confidence": 0.0001, "label": "knife"}, {"confidence": 0.0001, "label": "gun"}, {"confidence": 0.0002, "label": "military_weapon"}, {"confidence": 0.0, "label": "special_characters"}, {"confidence": 0.9994, "label": "normal"}], "ad": [{"confidence": 0.0, "label": "ad"}, {"confidence": 1.0, "label": "normal"}]}, "suggestion": "pass", "category_suggestions": { "ad": "pass", "terrorism": "pass", "porn": "pass"}}} Process finished with exit code 0 父主题：图像审核

内容审核 MODERATION 图像审核

云服务器内容精选

图像审核

7*24

备案

专业服务

退订

建议反馈

售前咨询热线