图片智能色情识别服务v1使用文档

2016-08-31

介绍及说明

色情定义

  图像智能色情识别服务,主要面向图像和视频产品线,帮助解决色情图片识别问题。本服务对色情的定义为:男士或者女士暴露身体关键部位(女士露三点,男士露下体);以及过分暴露,色情倾向极强。本服务适用于自然场景和卡通场景。

使用策略

  输入图像后,服务返回5个分数,分别是“自然色情,自然正常,卡通色情,卡通正常,其他”,建议色情度取自然色情和卡通色情两者中的较大者,即色情度=max(自然色情,卡通色情)。具体判定阈值建议使用产品实际图片进行评估。

合作方

  目前百度个人云,图片搜索,百度贴吧等产品线已接入。其中,在个人云产品线上,随机流量测试:识别色情视频准确率为99.56%时,召回达到65%。

服务接入

接入准备

1、请在图片智能色情识别平台详情页右上角点击申请使用。

2、需要先登录百度帐号,没有百度开发者身份的需要先注册成为百度开发者。

3、选择或创建你要申请权限的应用。

4、勾选要申请的scope权限。

5、填写申请理由,请认真填写应用简介、用途信息、预估日pv,极限峰值QPS,延时要求,部署地域要求等信息,以便平台服务管理员审批权限并做好相应准备。

6、填写验证码并点击提交,等待邮件通知审批结果,一般在2个工作日内完成审批开通。

接口URI

图像色情识别服务接口采用https协议,支持单张图片作为输入。

接口:https://openapi.baidu.com/rest/2.0/vis-antiporn/v1/antiporn方法:POST

请求参数

1. 参数名:access_token

参数类型:string

是否必须:使用OAuth 2.0方式接入必选

说明:  Oauth2.0授权所获token,参考:授权说明

2. 参数名:image

参数类型:string

是否必须:是

说明:  图像数据,base64编码

返回值

1. 参数名:error_code

参数类型:uint32

是否必须:否

说明:  错误码,只在异常响应中和error_msg出现

2. 参数名:error_msg

参数类型:string

是否必须:否

说明:  错误信息,只在异常响应中和error_code出现

3. 参数名:log_id

参数类型:uint64

是否必须:是

说明:  请求标识码,随机数,唯一

4. 参数名:result_num

参数类型:uint32

是否必须:否

说明:  result数组中元素个数,成功请求返回

5. 参数名:result

参数类型:array(object)

是否必须:否

说明:  返回结果数组,每项内容对应一个分类维度的结果,成功请求返回

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

1. 参数名:class_name

参数类型:string

是否必须:是

说明:  分类结果名称

2. 参数名:probability

参数类型:double

是否必须:是

说明:  分类结果置信度

请求示例

import base64,json,urllib,urllib2

 

def test_antiporn(filename):

    file = open(filename, 'rb')

    image = file.read()

    file.close()

    postData = {

        'image': base64.b64encode(image),

    }

    strUrl = 'https://openapi.baidu.com/rest/2.0/vis-antiporn/v1/antiporn?access_token=真实token'

 

    postData = urllib.urlencode(postData)

 

    req = urllib2.Request(strUrl, postData)

    response = urllib2.urlopen(req).read()

    print response

 

test_antiporn('./test.jpg')

返回示例

result: [

    {"class_name": "一般色情", ""probability": 0.010549738071859},

    {"class_name": "一般正常", ""probability": 0.08985498547554}

    {"class_name": "卡通色情", ""probability": 0.0048787374980748}

    {"class_name": "卡通正常", ""probability": 0.89471650123596}

    {"class_name": "其他", ""probability": 0.0.010549738071859}

    ]

错误码表

error_code:error_msg

216001:模块被关闭

216100:参数错误

216101:缺失必要参数

216102:参数长度超过限制

216103:方法不支持

216110:未登录

216200:图片数据异常

216201:未上传图片或图片数据为空

216202:上传图片格式错误

216203:图片尺寸异常

216204:下载图片失败

216300:内部系统故障,比如数据库,缓存等

216400:未知错误,一般是php层问题