智能多媒体 API

  • 图片敏感人物识别

    最近更新时间:2018-10-23 17:44:34

    用户通过敏感人物识别接口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
    请求语法
    GET <DownloadURI>?qpolitician HTTP/1.1
    Host: <DownloadHost>
    
    请求Header
    Header 说明
    Host 下载服务器域名,必须为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程
    请求参数
    参数 说明
    <DownloadURI> 图片 url
    请求示例

    第一步 获取图片 url

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

    第二步 调用服务

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

    调用示例代码:

    curl https://odum9helk.qnssl.com/resource/gogopher.jpg?qpolitician
    

    1.2 非七牛云 bucket 的图片

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

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

    请求方式: POST
    请求urlhttp://ai.qiniuapi.com/v1/face/search/politician
    请求Header
    字段 取值
    Content-Type application/json
    Authorization Qiniu <AccessKey>:<Sign>
    注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权,以便进行身份验证。<Sign> 的取值请参考七牛鉴权
    请求参数
    字段 类型 是否必选 说明
    uri string Y 图片资源。支持两种资源表达方式:
    1. 网络图片URL地址;
    2. 图片 base64 编码字符串,需在编码字符串前加上前缀 data:application/octet-stream;base64, 例:data:application/octet-stream;base64,xxx
    请求示例
    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://odum9helk.qnssl.com/resource/gogopher.jpg"
        }
    }
    
    

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

    返回说明


    返回参数

    参数 类别 说明
    code int 处理状态:0调用成功
    message string code对应的状态描述信息
    result.review boolean 图片是否需要人工 review,true需要 false不需要。只要有一个value.reviewtrue,则此字段为 true
    result.detections.boundingBox object 人脸边框信息
    result.detections.boundingBox.pst list 人脸边框在图片中的位置为 [左上,右上,右下,左下]
    result.detections.boundingBox.score float 人脸位置检测准确度
    result.detections.value object 人脸检索得到的敏感人物信息,未找到相似人物,则无字段
    result.detections.value.name string 检索得到的敏感人物姓名
    result.detections.value.score float 人脸检索结果的可信度
    result.detections.value.review bool 当前人脸识别结果是否需要人工 review,true需要 false不需要
    result.detections.sample object 该敏感人物的示例图片信息,未找到相似人物,没有这个字段
    result.detections.sample.url string 该敏感人物的示例图片链接
    result.detections.sample.pts list 人脸在示例图片中的边框信息

    返回示例

    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 和 gif

    服务价格


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

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

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

    每月总调用量P 机审+人审价格(单位:元/百张)
    第 0 张 至 300 万张 0.155
    第 300 万张 至 1500 万张 0.145
    第 1500 万张 至 3000 万张 0.125
    3000 万至1亿张 0.115
    1 亿张以上 0.1

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

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

    以上内容是否对您有帮助?
  • Icon free helper
    Close