用户头像审核

接口描述

通过人脸检测、文字识别、色情识别、暴恐识别、公众人物检测等多个维度,识别图片是否合规,直接返回审核结果,并支持自定义黑词库和审核规则配置。

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/solution/v1/face_audit

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 类型 是否必须 说明
images string N 待审核图片Base64编码字符串,以图片文件形式请求时必填。不能与imgUrls并存。
imgUrls string N 网图URL地址,以网图形式请求,图片Url需要做UrlEncode。不能与images并存。

请求示例代码

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

返回说明

返回参数

字段 类型 是否必须 说明
error_code uint32 错误码,错误才返回,成功不返回,具体错误码请参考下文
error_msg string 错误提示,错误才返回,成功不返回
result object[] 识别结果集合,成功才返回,默认[]
+res_code uint32 业务校验结果 0:校验通过,1:校验不通过
+res_msg object[] 未校验通过的项,[]描述的是未校验通过的规则,具体参考 result中的res_msg业务错误码定义
+error_code uint32 底层服务调用异常码,正常不返回,异常才返回
+error_msg string 底层服务调用提示信息,正常不返回,异常才返回
+data object 识别详细结果数据,默认[],data中的key含义:
ocr:文字识别
face:人脸检测
public:公众人物
politicians:政治敏感识别
antiporn:色情识别
terror:暴恐识别
quality:图像质量检测
++ocr object 文字识别服务返回结果。请参照“通用文字识别接口文档
++face object 人脸检测服务返回结果。请参照“人脸检测接口文档
++antiporn object 色情识别返回结果。请参照下文,色情识别说明。
++terror object 暴恐识别返回结果。请参照本文档 下文,暴恐识别说明。
++public object 公众人物服务返回结果。请参照下文,公众人物识别说明。
++politician object 政治敏感识别返回结果。请参照下文,政治敏感识别说明。
++quality object 图像质量返回结果。请参照下文,图像质量识别说明。
log_id uint64 请求标识码,随机数,唯一。

result中的res_msg业务错误码定义:

返回码 提示信息 描述
101 OCR相关 文字中包含手机号码
102 OCR相关 文字中包含“QQ”号字样,或包含超过9位的连续数字
103 OCR相关 文字中包含竞品名称
104 OCR相关 文字中包含疑似手机号/QQ的连续数字
201 face相关 图片中不包含人脸
202 face相关 图片中包含人脸
203 face相关 图片中包含多个人脸(默认为>=2)
204 face相关 图片中包含明星脸
205 face相关 片中包含政治人物人脸
206 face相关 片中包含公众人物人脸
207 face相关 自定义人脸库识别未通过
301 黄反识别及审核相关 图片中包含色情内容
302 黄反识别及审核相关 图片中包含性感内容,如穿着比较暴露
401 暴恐识别及审核相关 图片中包含血腥暴力场景内容
501 图像美观度相关 图像美观度低于阀值
502 图像美观度相关 图像美观度高于阀值
503 图像美观度相关 图像美观度不等于阀值

失败返回示例

{
    "log_id": 149319909347709, 
    "error_code": 282804,
    "error_msg":"download image error"
}

成功返回示例

{
   "log_id": 149319909347709,
    "result": [
        {
            "res_code": 0,
            "res_msg": [
                2001,
                2002,
                2003
            ],
            "data": {
                "ocr": {
                    "log_id": 2471272194,
                    "words_result_num": 2,
                    "words_result": [
                        {
                            "words": " TSINGTAO"
                        },
                        {
                            "words": "青島睥酒"
                        }
                    ]
                },
                "face": {
                    "result_num": 1,
                    "result": [
                        {
                            "location": {
                                "left": 90,
                                "top": 92,
                                "width": 111,
                                "height": 99
                            },
                            "face_probability": 1,
                            "rotation_angle": 6,
                            "yaw": 11.61234664917,
                            "pitch": -0.30852827429771,
                            "roll": 8.8044967651367,
                            "landmark": [
                                {
                                    "x": 105,
                                    "y": 110
                                }
                            ],
                            "landmark72": [
                                {
                                    "x": 88,
                                    "y": 109
                                }
                            ],
                            "gender": "male",
                            "gender_probability": 0.99358034133911,
                            "glasses": 0,
                            "glasses_probability": 0.99991309642792,
                            "race": "yellow",
                            "race_probability": 0.99960690736771,
                            "qualities": {
                                "occlusion": {
                                    "left_eye": 0.000085282314103097,
                                    "right_eye": 0.00001094374601962,
                                    "nose": 3.2677664307812e-7,
                                    "mouth": 2.6582130940866e-10,
                                    "left_cheek": 8.752236624332e-8,
                                    "right_cheek": 1.0212766454742e-7,
                                    "chin": 4.2632994357028e-10
                                },
                                "blur": 4.5613666312237e-41,
                                "illumination": 0,
                                "completeness": 0,
                                "type": {
                                    "human": 0.98398965597153,
                                    "cartoon": 0.016010366380215
                                }
                            }
                        }
                    ],
                    "log_id": 2418894422
                },
                "antiporn": [
                    {
                        "class_name": "色情",
                        "probability": 0.014619
                    },
                    {
                        "class_name": "正常",
                        "probability": 0.171783
                    },
                    {
                        "class_name": "性感",
                        "probability": 0.813598
                    }
                ]
            }
        }
    ]
}



色情识别识别说明


错误返回值:

参数 类型 必须 说明
error_code uint32 错误码,参考错误码表错误码说明。只在异常响应中出现
error_msg string 错误信息,参考错误码表错误码说明。只在异常响应中出现
log_id uint64 请求标识码,随机数,唯一

正确返回值:

字段 类型 是否必须 说明
confidence_coefficient string 结果是否确定,分为“确定”和“不确定”两种。
result_num uint32 返回结果数目,即:result数组中元素个数。
result array(array(double)) 结果数组,每项内容对应一个分类维度的结果。
conclusion string 本张图片最终鉴定的结果,分为“色情”,“性感”,“正常”三种。
log_id uint64 请求标识码,随机数,唯一。

其中元素的每项内容包含以下字段:

字段 类型 是否必须 说明 示例
class_name string 分类结果名称 色情
probability double 分类结果置信度 0.89471650123596

返回示例

result: [
    {"class_name": "色情", ""probability": 0.014619},
    {"class_name": "正常", ""probability": 0.171783},
    {"class_name": "性感", ""probability": 0.813598}
    ]



暴恐识别说明


请求参数:

无额外参数

错误返回值:

参数 类型 必须 说明
error_code uint32 错误码,参考错误码表错误码说明。只在异常响应中出现
error_msg string 错误信息,参考错误码表错误码说明。只在异常响应中出现
log_id uint64 请求标识码,随机数,唯一

正确返回值:

字段 类型 是否必须 说明
result array(array(double)) 暴恐置信度得分。
log_id uint64 请求标识码,随机数,唯一。
result_coarse object[] 粗粒度得分结果
name string 粗粒度标签,包含两个标签:正常、暴恐
score float 对应标签的置信度得分,越高可信度越高
result_fine object[ ] 细粒度得分结果
name string 细粒度标签,包含9个标签:正常、警察部队、血腥、尸体、爆炸火灾、杀人、暴乱、暴恐人物、军事武器
score float 对应标签的置信度得分,越高可信度越高

返回示例

{
    "errno": 0,
    "msg": "success",
    "data": {
        "result": 0.0082325544208288,
        "result_coarse": [
            {
                "name": "正常",
                "score": 0.99176746606827
            },
            {
                "name": "暴恐",
                "score": 0.0082325544208288
            }
        ],
        "result_fine": [
            {
                "name": "正常",
                "score": 0.98908758163452
            },
            {
                "name": "警察部队",
                "score": 0.0062405453063548
            },
            {
                "name": "血腥",
                "score": 0.0009653537417762
            },
            {
                "name": "尸体",
                "score": 0.001054480439052
            },
            {
                "name": "爆炸火灾",
                "score": 0.00011743687355192
            },
            {
                "name": "杀人",
                "score": 0.0011699661845341
            },
            {
                "name": "暴乱",
                "score": 0.000021190358893364
            },
            {
                "name": "暴恐人物",
                "score": 0.0010401027975604
            },
            {
                "name": "军事武器",
                "score": 0.00030337597127073
            }
        ]
    }
}



政治敏感识别说明


请求参数:

无额外参数

错误返回值:

参数 类型 必须 说明
error_code uint32 错误码,参考错误码表错误码说明。只在异常响应中出现
error_msg string 错误信息,参考错误码表错误码说明。只在异常响应中出现
log_id uint64 请求标识码,随机数,唯一

正确返回值:

参数 类型 是否必须 说明
include_politician string 是否包含政治人物,取值为”是”或”否”
result_confidence string 对于include_politician字段的置信度,取值为“确定”或“不确定”
result_num uint32 实际检测到人脸数目(不大于max_face_num)
result array(object) 识别出的结果数据
+location object 人脸在输入图片中的位置
++left uint32 人脸区域离左边界的距离
++top uint32 人脸区域离上边界的距离
++width uint32 人脸区域的宽度
++height uint32 人脸区域的高度
+stars object[] 政治人物数组
++name string 姓名
++star_id string 人物id,全局唯一
++probability float 相似度,[0, 1]
log_id uint64 请求标识码,随机数,唯一

返回值样例:

{
        "log_id": 3268660173,
        "include_politician": "是",
        "result_confidence": "确定",
        "result_num": 1,
        "result": [
            {
                "location": {
                    "left": 132,
                    "top": 168,
                    "width": 238,
                    "height": 223
                },
                "stars": [
                    {
                        "name": "习近平",
                        "star_id": "515617",
                        "probability": 0.9750030040741
                    }
                ]
            }
        ]
    }



公众人物识别说明


错误返回值:

参数 类型 必须 说明
error_code uint32 错误码,参考错误码表错误码说明。只在异常响应中出现
error_msg string 错误信息,参考错误码表错误码说明。只在异常响应中出现
log_id uint64 请求标识码,随机数,唯一

正确返回值:

参数 类型 是否必须 说明
result_num uint32 实际检测到人脸数目(不大于max_face_num)
result object[] 识别出的结果数据
+location object 人脸在输入图片中的位置
++left uint32 人脸区域离左边界的距离
++top uint32 人脸区域离上边界的距离
++width uint32 人脸区域的宽度
++height uint32 人脸区域的高度
+stars object[] 公众人物数组
++name string 姓名
++star_id string 人物id,全局唯一
++probability float 相似度,[0, 1]
log_id uint64 请求标识码,随机数,唯一

返回值样例:

{
    "log_id": 3268660173,
    "result_num": 1,
    "result": [
        {
            "location": {
                "left": 132,
                "top": 168,
                "width": 238,
                "height": 223
            },
            "stars": [
                {
                    "name": "习近平",
                    "star_id": "515617",
                    "probability": 0.9750030040741
                }
            ]
        }
    ]
}



图像质量检测说明


请求参数:

无额外参数

错误返回值:

参数 类型 必须 说明
error_code uint32 错误码,参考错误码表错误码说明。只在异常响应中出现
error_msg string 错误信息,参考错误码表错误码说明。只在异常响应中出现
log_id uint64 请求标识码,随机数,唯一

正确返回值:

参数 类型 是否必须 说明
aesthetic double 美观度分数 范围[0.0,1.0]
clarity double 清晰度分数 范围[0.0,1.0]
log_id uint64 请求标识码,随机数,唯一

返回值样例:

{
        "log_id": 716033439,
        "result": {
            "aesthetic": 0.56124178278668 // 美观度分数 范围[0.0,1.0],分值越高代表美观度越高
            "clarity": 0.82762561241786 // 清晰度分数 范围[0.0,1.0],分值越高代表清晰度越高
        }
    }