1. 接口说明

检测图片内容并进行分类,分类为:正常,性感,高度性感以及色情,帮助网站、APP、直播、开发者高效过滤涉黄内容。

2. 接口地址

POST http://api.xfyun.cn/v1/service/v1/image_identify/sexy_filter HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8

3. 请求参数

在 Http Request Header 中配置授权认证参数,见【接口描述-授权认证。 其中 X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串,原始 JSON 串各字段说明如下:

参数 类型 必须 说明 示例
scenario string 指定应用场景,Default:针对通用场景,Social:针对社交应用场景,默认场景为Default Social
details bool 在上传多张图片时,选择是否输出详细结果,默认为true false
image_url []string file,image_url,image_id必须选择其中的一个,采用抓取网络图片方式时选取此参数,支持的文件类型包括:静态图片或图片压缩包(jpg, jpeg, bmp, png大小不超过10M,zip大小不超过50M),url数组(数量不超过20) http://xfyun-doc.ufile.ucloud.com.cn/1532066413309446/demo.jpg
image_id []string file,image_url,image_id必须选择其中的一个,上传本站接口已生成的image_id时选取此参数,可在多个接口间共享,减少图片传输的带宽,支持的类型包括:image_id字符串或字符串数组(数量不超过20) ee93d40ad0a54ab6a78ced96daf75bcf

在 Http Request Body 中配置以下参数:

参数 类型 必须 说明
file string file,image_url,image_id必须选择其中的一个,上传本地文件进行检测时选取此参数,base64 编码后进行 urlencode,支持的文件类型包括:静态图片或图片压缩包(jpg, jpeg, bmp, png大小不超过10M,zip大小不超过50M)

4. 返回值

返回值为 json 串,各字段如下:

参数 类型 说明
code string 结果码(具体见错误码)
data object 过滤结果
desc string 描述
sid string 会话ID

其中 sid 字段主要用于追查问题,如果出现问题,可以提供 sid 给讯飞技术人员帮助确认问题。

data中结果字段说明:

字段 类型 描述
score object 四种类型的置信度
scenario string 过滤采用的场景参数
is_porn bool true表示图片确定违规(此时is_review一定为false),false表示图片可能违规(需is_review为true)或者正常(需is_review为false),当上传多张图片时,为其中最严重的图片的结果
is_review bool true表示图片可能违规(此时is_porn一定为false),false表示图片一定违规(需is_porn为true)或者正常(需is_porn为false),当上传多张图片时,为其中最严重的图片的结果
is_review bool true表示图片可能违规(此时is_porn一定为false),false表示图片一定违规(需is_porn为true)或者正常(需is_porn为false),当上传多张图片时,为其中最严重的图片的结果
illegal_confidence float 图片违规的置信度
image_id string 图片唯一标识

score结果说明:

字段 类型 描述
normal float 正常的置信度
sexy float 性感的置信度
very_sexy float 高度性感的置信度
porn float 色情的置信度

示例如下:

失败:

{
    "code": "10106",
    "desc": "invalid parameter|invalid X-Appid",
    "data": {},
    "sid": "wsr0000bb3f@dx3d5c059d83b3477200"
}

成功(单张图片):

{
"data":{
    "score":{
        "normal":0.0009853641968220472,
        "sexy":0.010902415961027145,
        "porn":0.04120225831866264,
        "very_sexy":0.9469099044799805
    },
    "scenario":"Default",
    "is_porn":true,
    "is_review":false,
    "illegal_confidence":0.9881121516227722,
    "image_id":"a213c0c7884946bd9f75b627fd0c8747"
},
"code":"0",
"desc":"success",
"sid":"wsr00000001@ll36940e324c59000100"

} 成功(多张图片):

{
"data":{
    "scenario":"Default",
    "is_porn":true,
    "is_review":false,
    "details":[
        {
            "score":{
                "normal":0.000985358259640634,
                "sexy":0.01090239267796278,
                "porn":0.04120229557156563,
                "very_sexy":0.9469099044799805
            },
            "image_name":"http://img.article.pchome.net/game/00/08/67/09/pic_lib/wm/231.jpg",
            "is_porn":true,
            "is_review":false,
            "illegal_confidence":0.988112211227417,
            "image_id":"26ac7fce3e8242799d9e56e94dbcaa06"
        },
        {
            "score":{
                "normal":0.0009853595402091742,
                "sexy":0.010902426205575466,
                "porn":0.04120216891169548,
                "very_sexy":0.9469100832939148
            },
            "image_name":"http://img.article.pchome.net/game/00/08/67/09/pic_lib/wm/231.jpg",
            "is_porn":true,
            "is_review":false,
            "illegal_confidence":0.9881122708320618,
            "image_id":"0bba10b07e0a4b519552e7861f21d94a"
        }
    ],
    "illegal_confidence":0.9881122708320618
},
"code":"0",
"desc":"success",
"sid":"wsr00000001@ll36940e324c59000100"
}

5. 调用示例

python脚本示例(python版本号 3.6)

说明:将脚本中 IMAGE_PATH, API_KEY, APPID, 换成相应的图片路径,讯飞开放平台提供的 apiKey,讯飞开放平台应用的 appid 即可,运行脚本可打印相应结果。

#!/usr/bin/python
# -*- coding: UTF-8 -*-
import requests
import time
import hashlib
import base64


def main():
    x_appid = 'APPID'
    api_key = 'API_KEY'
    url = 'http://api.xfyun.cn/v1/service/v1/image_identify/sexy_filter'
    x_time = str(int(time.time()))
    m2 = hashlib.md5()
    m2.update(str(api_key + x_time ).encode('utf-8'))
    x_checksum = m2.hexdigest()
    with open(r'IMAGE_PATH', 'rb') as f:
        f = f.read()
    f_base64 = str(base64.b64encode(f), 'utf-8')
    data = {'file': f_base64}
    x_header = {
        'X-Appid': x_appid,
        'X-CurTime': x_time,
        'X-CheckSum': x_checksum,
                }
    req = requests.post(url, data=data, headers=x_header)
    result = str(req.content, 'utf-8')
    print(result)
    return


if __name__ == '__main__':
    main() 
Copyright © iflytek.com 2018 all right reserved,powered by Gitbook该文件修订时间: 2018-11-03 10:26:45

results matching ""

    No results matching ""