用户通过敏感人物识别接口qpolitician对存储在七牛云 bucket（支持华东、华北和华南 bucket）或 非七牛云 bucket 的图片进行智能识别，对识别出的人物检索敏感人物库，给出图片中是否存在敏感人物的结果。

返回结果包含检测出敏感人物的坐标、姓名、该敏感人物的示例图片信息以及检测结果概率值。其中概率值越高，表示结果可信度越高。用户可以根据返回结果中review字段的值来确定是否需要人工审核，true表示需要人工审核，false表示不需要人工审核。

接入前准备

1. 申请七牛账号

请用户打开七牛云官网，点击注册，个人账号或企业账号均可。我们会在一个工作日内完成实名认证。注册成功后，登录七牛云开发者平台。

2. 获取图片 url

• 存储在七牛云 bucket 的图片
  具体操作步骤如下：
  1.如果用户未将图片上传到七牛云 bucket，请根据对象存储快速入门建立 bucket 并将图片上传。
  2.获取单个文件 url：
  点击“复制外链”获取选定图片 url
  

  3.批量获取文件 url 可通过命令行工具来完成。

• 非七牛云 bucket 的图片
  请用户获取自己的图片 url。

请求说明

1. 存储在七牛云 bucket 的图片

该方法对存储在七牛云 bucket（支持华东、华北和华南 bucket）的图片进行智能高性能的敏感人物识别。

GET <DownloadURI>?qpolitician HTTP/1.1
Host: <DownloadHost>

第一步 获取图片 url

获取到您存在七牛 bucket 里面的图片的 url。 例如：https://dn-odum9helk.qbox.me/resource/gogopher.jpg

第二步 调用服务

在您的图片的 url 后面加上 ?qpolitician 例如：https://dn-odum9helk.qbox.me/resource/gogopher.jpg?qpolitician

调用示例代码：

curl https://dn-odum9helk.qbox.me/resource/gogopher.jpg?qpolitician

1.2 非七牛云 bucket 的图片

该方法支持对非七牛云 bucket 的图片进行高性能的敏感人物识别。

注: 此方法也支持对七牛云 bucket 的单张图片进行敏感人物识别。

POST /v1/face/search/politician HTTP/1.1
Host: ai.qiniuapi.com
Content-Type: application/json
Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=

{
    "data": {
        "uri": "https://dn-odum9helk.qbox.me/resource/gogopher.jpg"
    }
}

注意：请把 Authorization 换成您的账号七牛鉴权 QiniuToken。

返回说明

返回参数

返回示例

HTTP/1.1 200 OK
Content-Type: application/json

{
    "code": 0,
    "message": "",
    "result": {
        "review": true,
        "detections": [
            {
                "boundingBox":{
                    "pts": [[1213,400],[205,400],[205,535],[1213,535]],
                    "score":0.998
                },
                "value": {
                    "name": "xxx",
                    "score":0.567,
                    "review": true
                },
                "sample": {
                    "url": "",
                    "pts": [[1213,400],[205,400],[205,535],[1213,535]]
                }
            },
            {
                "boundingBox":{
                    "pts": [[1109,500],[205,500],[205,535],[1109,535]],
                    "score":0.98
                },
                "value": {
                    "score":0.987,
                    "review": false
                }
            }
        ]
    }
}

审核文件适用规格

可处理的图片文件：

1. 图片大小不超过10M
2. 图片尺寸大于等于60x60，小于5000x5000，图片过小则无法正确进行人脸识别。
3. RGB通道数为3和3以内的图片，不能包含alpha通道
4. 图片格式支持 png、jpg、jpeg、bmp、webp、tif 和 gif，多帧图片格式将会取首帧进行审核

服务价格

• 每月提供账单，按当月的使用量进行阶梯收费。

• 内容审核产品的新用户会获得一次性18万免费额度，其中鉴黄、鉴暴恐和政治人物识别各6万。如果是本月15号（包括15号）之前开始使用内容审核，免费额度会在本月生效，如果是本月15号之后开始使用内容审核，免费额度会在下月生效。免费额度的周期为月，当月结束后会清零。每个用户最多只能获得一次免费额度，当月使用量在免费额度内，不收费；如超出免费额度，对超出部分收费。

• 内容审核计费修改为采用调用总量，不再单独以审核结果“确定”和“不确定”计费，主要原因是“不确定”的量一般比较少，并且采用调用总量的单价有大幅降低。

计费示例
用户一个月的调用量为 506 万次，扣减免费额度后，总调用量为 500 万次，账单金额约为:

300 万张 * 100 * 0.085 元／百张 +200 万张 * 100 * 0.075元／百张 = 4050元