智能多媒体 API

  • 政治人物识别

    最近更新时间:2017-09-27 14:30:17

    用户通过政治人物识别接口qpolitician对存储在七牛云 bucket(目前仅支持华东 bucket)或 非七牛云 bucket 的图片进行智能识别,对识别出来的人物检索政治人物库,给出图片中是否存在政治人物的结果。

    用户可以根据返回结果中review字段的值来确定是否需要人工审核,true表示需要人工审核,false表示不需要人工审核。

    1. 使用方式

    政治人物识别接口支持对存储在七牛云 bucket(目前仅支持华东 bucket)或 非七牛云 bucket的图片进行政治人物识别和检索。目前支持的图片格式有 png、jpg 和 bmp。

    1.1 存储在七牛云 bucket 的图片

    开发者使用政治人物识别功能之前,需要先注册七牛云账号,并把图片上传到七牛云 bucket,具体操作步骤如下:

    打开七牛云官网,点击注册,个人账号或企业账号均可。注册成功后,登录七牛云开发者平台。如果已有账号,请直接登录七牛云开发者平台

    创建七牛云 bucket,如果已有 bucket,直接进入七牛云 bucket;

    在七牛云 bucket 上传图片;

    上传成功后,得到图片的URL。

    具体调用步骤

    请求语法

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

    请求头部

    头部名称 必填 说明
    Host 下载服务器域名,必须为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    {
        // ...政治人物识别返回值...
    }
    

    响应头部

    头部名称 说明
    Content-Type MIME类型,固定为application/json
    Cache-Control 缓存控制,固定为no-store,不缓存。

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    200 ok
    
    {
        "code": 0,
        "message": "",
        "result": {
            "review": True,
            "detections": [
                {
                    "boundingBox":{
                        "pts": [[1213,400],[205,400],[205,535],[1213,535]],
                        "score":0.998
                    },
                    "value": {
                        "name": "xx",
                        "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
                    }
                }
            ]
        }
    }
    

    返回字段说明:

    字段 取值 说明
    code int 0:表示正确
    message string 结果描述信息
    review boolean True或False,图片是否需要人工review, 只要有一个value.review为True,则此字段为True
    boundingBox map 人脸边框信息
    boundingBox.pst list[4] 人脸边框在图片中的位置[左上,右上,右下,左下]
    boundingBox.score float 人脸位置检测准确度
    value.name string 检索得到的政治人物姓名,未找到相似人物,没有这个字段
    value.review boolean True或False,当前人脸识别结果是否需要人工review
    value.score float 0~1,检索结果的可信度
    sample object 该政治人物的示例图片信息,未找到相似人物, 没有这个字段
    sample.url string 该政治人物的示例图片
    sample.pts list[4] 人脸在示例图片中的边框

    示例

    第一步

    获取到您存在七牛bucket里面的图片的url。 例如:https://odum9helk.qnssl.com/resource/gogopher.jpg

    第二步

    在您的图片的 url 后面加上 ?qpolitician 例如:https://odum9helk.qnssl.com/resource/gogopher.jpg?qpolitician

    返回的结果(内容经过格式化方便阅读):

    {
             "code":0,
             "message":"No valid face info detected",
             "result":
                     {
                     "detections":[],
                     "review":false,
                     }
    }
    

    1.2 非七牛云 bucket 的图片

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

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

    请求语法

    POST /v1/face/search/politician Http/1.1
    Host: argus.atlab.ai
    Content-Type: application/json
    Authorization: Qiniu <AccessKey>:<Sign>
    
    {
        "data": {
            "uri": "https://ors35x6a7.qnssl.com/atshow-face-detection-20170703/7.png"
        }
    }
    

    注意: 需要在 POST 请求的 head 部分添加七牛鉴权,以进行用户身份验证。

    响应语法

    {          "code":0,
               "message":"",
               "result":
               {"detections":[
                     {
                         "boundingBox":{
                         "pts":[[104,75],[154,75],[154,143],[104,143]],
                         "score":0.9986},
                         "value":{
                         "review":false,
                         "score":0.16160135}
                     },
                     {
                         "boundingBox":{
                         "pts":[[60,102],[114,102],[114,177],[60,177]],
                         "score":0.9975},
                         "value":{
                         "review":false,"score":0.25428465}
                     },
                     {
                         "boundingBox":{
                         "pts":[[262,77],[315,77],[315,158],[262,158]],
                         "score":0.996},
                         "value":{
                         "review":false,"score":0.2533759}
                      },
                      {
                         "boundingBox":{
                         "pts":[[203,61],[260,61],[260,138],[203,138]],
                         "score":0.999},
                         "value":{
                         "review":false,"score":0.29980028}
                       },
                       {
                       "boundingBox":{
                       "pts":[[327,83],[377,83],[377,151],[327,151]],
                       "score":0.9985},
                       "value":{
                       "review":false,"score":0.26587874}
                       }
                       ],
                       "review":false
                 }
    }
    

    返回字段说明:

    请参见上文 1.1 存储在七牛云 bucket的图片 中响应语法中的返回字段说明。

    示例

    POST /v1/face/search/politician HTTP/1.1
    Host: argus.atlab.ai
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "data": {
            "uri": "https://odum9helk.qnssl.com/resource/gogopher.jpg"
        }
    }
    

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

    返回结果(内容经过格式化以便阅读):

    {
             "code":0,
             "message":"No valid face info detected",
             "result":
                     {
                     "detections":[],
                     "review":false,
                     }
    }
    

    2. 服务价格

    政治人物识别是一项收费服务,七牛云 bucket 的图片和非七牛云 bucket 的图片调用政治人物识别的价格一样,具体价格如下。

    总调用量P 确定部分 不确定部分
    单位:万张 单价(元/百张) 单价(元/百张)
    P < = 300 1.24 0.24
    300 < P <=1500 1.22 0.22
    1500 < P <= 3000 1.20 0.20
    P > 3000 1.18 0.18

    注意:

    • 确定部分:可信度高,无需review(返回数据中review为false)。
    • 不确定部分:需要人工 review,但根据返回的参考值排序可以大大降低工作量(返回数据中review为true)。

    计费示例

    某公司2017年5月使用七牛云政治人物识别服务,共发起50万张政治人物识别请求, 其中结果确定的图片为48万张,结果不确定的图片为2万张,则当月使用七牛云政治人物识别服务产生的费用为:

    确定的结果产生费用:1.24元/百张 * 48万张 = 5952元

    不确定的结果产生费用:0.24元/百张 * 2万次 = 48元

    总计费用:5952元 + 48元 = 6000元

    以上内容是否对您有帮助?
  • 提交工单