1. 接口说明

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

2. 接口地址

POST http[s]://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. 调用示例