图片鉴黄

简介

HI,您好,欢迎使用腾讯AI开放平台图片鉴黄API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述图片鉴黄能力相关的技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

接口能力

接口名称 接口描述 API地址
图片鉴黄 识别一个图像是否为色情图像 https://api.ai.qq.com/fcgi-bin/vision/vision_porn

更多更强大的接口能力正在开发中,并逐步开放,敬请期待!

协议须知

调用方集成图片鉴黄API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方法 POST
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式
接口鉴权 签名机制,详情请阅接口鉴权
图片格式 支持jpg、png、bmp

图片鉴黄接口

1. 接口描述

识别一个图像是否为色情图像。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
image string 原始图片的base64编码数据(原图大小上限1MB,支持JPG、PNG、BMP格式),image和image_url必须至少提供一个 ... 待识别图片
image_url string 如果image和image_url都提供,仅支持image_url,image和image_url必须至少提供一个 ... 待识别图片url

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ tag_list array 图像的分类标签, 如下表所示
+ + tag_name string 返回图像标签的名字
+ + tag_confidence int 图像标签的置信度,范围0-100,越大置信度越高
+ + tag_confidence_f float 图像标签的置信度,浮点数范围0-1,越大置信度越高

tag_name 示例及说明

tag_name 含义
normal 正常
hot 性感
porn 黄色图像
female-genital 女性阴部
female-breast 女性胸部
male-genital 男性阴部
pubes 阴毛
anus 肛门
sex 性行为
normal_hot_porn 图像为色情的综合值

用户可通过实际测试结合业务场景来判断图片类别,参考判断标准如下

  1. 色情图片:porn值 > 83;
  2. 性感图片:hot值 > normal值;
  3. 其他情况认为是正常图片。

4. 请求限制

单用户单接口的QPS(每秒请求次数)上限如下,如需更多请联系QQ客服反馈。

未认证用户 个人认证用户 企业认证用户
1 2 10

5. 参考示例

假设示例请求数据如下。

参数名称 参数数据 描述
app_id 1000001 仅供参考
image 实时计算base64
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf,示例图片文件存储路径为:/path/to/image

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 图片base64编码
$path   = '/path/to/image';
$data   = file_get_contents($path);
$base64 = base64_encode($data);

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'image'      => $base64,
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/vision/vision_porn';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
    "ret":0,
    "msg":"ok",
    "data":{
        "tag_list":[
            {
                "tag_confidence":91,
                "tag_confidence_f":0.914186,
                "tag_name":"normal"
            },
            {
                "tag_confidence":8,
                "tag_confidence_f":0.0858136,
                "tag_name":"hot"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":4.21048e-7,
                "tag_name":"porn"
            },
            {
                "tag_confidence":100,
                "tag_confidence_f":1,
                "tag_name":"female-breast"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":0,
                "tag_name":"female-genital"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":0,
                "tag_name":"male-genital"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":0,
                "tag_name":"pubes"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":0,
                "tag_name":"anus"
            },
            {
                "tag_confidence":0,
                "tag_confidence_f":0,
                "tag_name":"sex"
            },
            {
                "tag_confidence":2,
                "tag_confidence_f":0.0268238,
                "tag_name":"normal_hot_porn"
            }
        ]
    }
}
AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点