请求方式：POST (HTTPS)
请求地址：
https://open.welink.huaweicloud.com/api/aiservice/v1/moderation/image
认证方式： access_token，请参考获取access_token
请求头部：
Content-Type: application/json
x-wlk-Authorization: access_token
请求参数
{
"image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...",
"categories":[
"politics",
"terrorism"
],
"threshold" : "0.5"
}
请求参数说明
| 参数 | 必选 | 参数类型 | 说明 |
|---|---|---|---|
| image | 是 | String | 图片文件Base64编码字符串。要求base64编码后大小不超过10M。政治人物检测人脸部分不小于50*50像素。支持JPG/PNG/BMP格式。 |
| categories | 否 | Array[String] | 检测场景。politics：是否涉及政治人物的检测。 terrorism：是否包含涉政暴恐元素的检测。porn：是否包含涉黄内容元素的检测。ad：是否包含广告的检测（公测特性）。all：包含politics、terrorism和porn三种场景的检测。可通过配置上述场景，来完对应场景元素的检测。 为空或无此参数表示politics和terrorism都检测，但不包含porn场景。每个检测场景的检测次数会分类统计。 |
| threshold | 否 | String | 结果过滤门限，只有置信度不低于此门限的结果才会呈现在detail的列表中，取值范围 0-1，当未设置此值时各个检测场景会使用各自的默认值。 politics检测场景的默认值为0.95。 terrorism检测场景的默认值为0。 ad检测场景的默认值为0。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。 说明： 如果检测场景中的最高置信度也未达到threshold，则结果列表为空；反之threshold过小，则会使结果列表中内容过多。 如果检测场景中的最高置信度也未达到threshold，则结果列表为空；反之threshold过小，则会使结果列表中内容过多。如果检测场景中的最高置信度也未达到threshold，则结果列表为空；反之threshold过小，则会使结果列表中内容过多。 threshold参数不支持porn场景筛选。 threshold参数不会对响应中的suggestion产生影响。 |
请求示例
curl -X POST \
'https://open.welink.huaweicloud.com/api/aiservice/v1/moderation/image' \
-H 'Accept-Charset: UTF-8' \
-H 'Content-Type: application/json' \
-H 'x-wlk-Authorization: access_token' \
-d '{"image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...",
"categories":[
"politics",
"terrorism"
]}'
响应格式说明
返回结果 正常返回结果
{
"code": "0",
"data": {
"politics":[
{
"confidence": 0.89155281782150264,
"face_detail":{
"h": 130,
"w": 103,
"x": 80,
"y": 125
},
"label": "xxx"
},
{
"confidence": 0.87563462432654422,
"face_detail":{
"h": 131,
"w": 203,
"x": 423,
"y": 109
},
"label": "yyy"
}
],
"terrorism":[
{
"confidence": 0.73155281782150264,
"label": "xxx"
},
{
"confidence": 0.26844718217849736,
"label": "yyy"
}
]
},
"suggestion": "block",
"category_suggestion": {
"politics":"block",
"terrorism":"review"
}
},
"error": "",
"message": "ok"
}
异常返回结果
失败响应示例
{
"code": "58401",
"data": null,
"error": "Failed to verify the token.",
"message": "Login authentication failed."
}
返回参数说明
图本审核响应参数说明请参见表。
- 响应参数说明
| 参数 | 必选 | 参数类型 | 说明 |
|---|---|---|---|
| code | 是 | String | 错误码 |
| message | 是 | String | 调用成功时为"ok"。调用失败时的错误信息。 |
| data | 是 | Object | 调用成功时表示调用结果，详见data数据结构。调用失败时为null。 |
| error | 是 | String | 错误信息。 |
data 数据结构
| 参数 | 必选 | 参数类型 | 说明 |
|---|---|---|---|
| detail | 是 | Object | 针对选定的每个检测场景列出结果列表，politics为涉政敏感人物检测结果，terrorism为涉政暴恐检测结果，porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。 |
| confidence | 是 | Float | 置信度，取值范围 0-1。 |
| face_detail | 是 | Object | politics场景中的人物面部信息，包括4个值： h：人脸区域高度 w：人脸区域宽度 x：人脸区域左上角到y轴距离 y：人脸区域左上角到x轴距离 |
| label | 是 | String | 每个检测结果的标签化说明： politics：label为对应的政治人物信息 terrorism：label为对应的涉政暴恐元素信息。 涉政暴恐场景当前支持label列表如下： normal：正常 knife：刀 gun：枪 fire：火灾 bloody ：血腥 terrorist：暴恐组织及标志 fascist：法西斯组织及标志 cult：邪教组织及标志 negative_politics ：涉政负面组织及标志 negative_political_events：涉政负面事件及标志 special_characters ：特殊文字 kidnap：绑架 corpse：尸体 riot：暴乱事件 parade ：游行示威 sensitive_landmarks：敏感地标 military_weapon：军事武器 army：警察部队 positive_politics：涉政正面组织及标志 crowd：人群聚集 porn：label为对应的涉黄分类（涉黄、性感等）信息 鉴黄场景当前支持label列表如下： normal：正常 porn：色情 sexy：性感 ad：label为对应的广告识别结果（普通、广告）信息 |
| suggestion | 是 | String | 审核结果是否通过。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 当同时检测多个场景时，suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block，所有场景都pass时suggestion为pass，这两种情况之外则一定有场景需要review，此时suggestion为review。 |
| category_suggestion | 是 | Object | 具体每个场景的检测结果。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 |
错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 成功。 |
| 58401 | 无权限。 |
| 58402 | 非法输入参数。 |
| 58500 | 服务异常。 |
| 58005 | Moderation服务异常。 |