腾讯云-智能鉴黄

图像内容审核

接口地址：http://route.showapi.com/1946-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称	类型	默认值	示例值	必须	描述
ImageUrl	String		https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/aaa.jpg	否	图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边
ImageBase64	String		/9j/4AAQSkZJRgABAQEAZABkAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAB5AHkDAREAAhEBAxEB/8QAHgAAAQUBAQEBAQAAAAAAAAAABgAFBwgJBAMCAQr/xABREAABAwIEAwMGCA……………………………………………………………………………………………………aUP8HOe+gmj/A4H2jX3haW5aqTcbUiVCFh2jCFBPqtjOSz92HI0maZKAO6EqRGJo2d49R0PXDapzqFy+UN+g447QqPmcs46j+8n/5SftGNHarqi/nM8CpHh/7sZ9qfsxWuTMP1nfrmsT+O/wD4x9Sv7Wy/2hjVcI/pkP8AaFlnEn9cqP7lEXzvZixVEvRH4hHtP24Q5pyPmutH4hH88Ptx8+6nKr6v66L3rX8I6p/SXv2jjg7BM031R4D4LSvK/wCRuB/Vzf7GAp328r0JTf0tngPgFRTW38vUb+fb/awYR/ZViHEH2yTwPwKtrod+/wB3+Uf7tOBqt2WhcEf0eL+0/Eo+l/vpz+kf4YrRsi9uwTdp1+VvOX9jVf3L+Hq7+TF/ePiExS/baj/1j4OXd+54v4fZ/wD6vhf3zmGeP/s8Hi75IK4G+zVPi35rUqm/lUH9FR9mMu/wPNG//bj4qT0/jFfyxhk7qgK+cRk4v//Z	否	图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1946-1","my_appId","my_appSecret") .addTextPara("ImageUrl"," https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/aaa.jpg") .addTextPara("ImageBase64","/9j/4AAQSkZJRgABAQEAZABkAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAB5AHkDAREAAhEBAxEB/8QAHgAAAQUBAQEBAQAAAAAAAAAABgAFBwgJBAMCAQr/xABREAABAwIEAwMGCA……………………………………………………………………………………………………aUP8HOe+gmj/A4H2jX3haW5aqTcbUiVCFh2jCFBPqtjOSz92HI0maZKAO6EqRGJo2d49R0PXDapzqFy+UN+g447QqPmcs46j+8n/5SftGNHarqi/nM8CpHh/7sZ9qfsxWuTMP1nfrmsT+O/wD4x9Sv7Wy/2hjVcI/pkP8AaFlnEn9cqP7lEXzvZixVEvRH4hHtP24Q5pyPmutH4hH88Ptx8+6nKr6v66L3rX8I6p/SXv2jjg7BM031R4D4LSvK/wCRuB/Vzf7GAp328r0JTf0tngPgFRTW38vUb+fb/awYR/ZViHEH2yTwPwKtrod+/wB3+Uf7tOBqt2WhcEf0eL+0/Eo+l/vpz+kf4YrRsi9uwTdp1+VvOX9jVf3L+Hq7+TF/ePiExS/baj/1j4OXd+54v4fZ/wD6vhf3zmGeP/s8Hi75IK4G+zVPi35rUqm/lUH9FR9mMu/wPNG//bj4qT0/jFfyxhk7qgK+cRk4v//Z") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
Response	Object
-  DisgustResult	Object		恶心内容识别结果。 注意：此字段可能返回 null，表示取不到有效值。
-  Extra	String		透传字段，透传简单信息。
-  PoliticsResult	Object		政治敏感识别结果。 注意：此字段可能返回 null，表示取不到有效值。
-  AdvancedInfo	String		鉴政识别返回的详细标签后期开放。
-  Code	Number	0	该识别场景的错误码： 0表示成功， -1表示系统错误， -2表示引擎错误， -1400表示图片解码失败， -1401表示图片不符合规范。
-  Confidence	Number	33	图像涉政的分数，0-100之间，分数越高涉政几率越大。 Type为DNA时： 0到75，Suggestion建议为PASS 75到90，Suggestion建议为REVIEW 90到100，Suggestion建议为BLOCK Type为FACE时： 0到55，Suggestion建议为PASS 55到60，Suggestion建议为REVIEW 60到100，Suggestion建议为BLOCK
-  FaceResults	Object[]		Type取值为‘FACE’时，人脸识别的结果列表。基于图片中实际检测到的人脸数，返回数组最大值不超过5个。
-  0	Object
-  Candidates	Object[]		候选人列表。当前返回相似度最高的候选人。
-  0	Object
-  Confidence	Number	33	相似度，0-100之间。
-  Name	String	肖杰	识别出人脸对应的候选人数组。当前返回相似度最高的候选人。
-  FaceRect	Object		检测出的人脸框位置。
-  Height	Number	284	人脸区域高度。
-  Width	Number	284	人脸区域宽度。
-  X	Number	51	人脸区域左上角横坐标。
-  Y	Number	123	人脸区域左上角纵坐标。
-  Msg	String	OK	错误码描述信息。
-  Suggestion	String	PASS	识别场景的审核结论： PASS：正常 REVIEW：疑似 BLOCK：违规
-  Type	String	FACE	取值'DNA' 或‘FACE’。DNA表示结论和置信度来自图像指纹，FACE表示结论和置信度来自人脸识别。
-  PornResult	Object		色情识别结果。 注意：此字段可能返回 null，表示取不到有效值。
-  AdvancedInfo	String		预留字段，后期用于展示更多识别信息。
-  Code	Number	0	该识别场景的错误码： 0表示成功， -1表示系统错误， -2表示引擎错误， -1400表示图片解码失败。
-  Confidence	Number	82	算法对于Suggestion的置信度，0-100之间，值越高，表示对于Suggestion越确定。
-  Msg	String	OK	错误码描述信息。
-  Suggestion	String	PASS	识别场景的审核结论： PASS：正常 REVIEW：疑似 BLOCK：违规
-  Type	String	NORMAL	取值'LABEL‘，LABEL表示结论和置信度来自标签分类。
-  RequestId	String	c949ca16-7bbb-4627-80cf-3a415b0cecae	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-  Suggestion	String	PASS	识别场景的审核结论： PASS：正常 REVIEW：疑似 BLOCK：违规
-  TerrorismResult	Object		暴恐识别结果。 注意：此字段可能返回 null，表示取不到有效值。
-  AdvancedInfo	String		暴恐识别返回的详细标签后期开放。
-  Code	Number	0	该识别场景的错误码： 0表示成功， -1表示系统错误， -2表示引擎错误， -1400表示图片解码失败。
-  Confidence	Number	0	图像涉恐的分数，0-100之间，分数越高涉恐几率越大。 Type为LABEL时： 0到86，Suggestion建议为PASS 86到91，Suggestion建议为REVIEW 91到100，Suggestion建议为BLOCK Type为FACE时： 0到55，Suggestion建议为PASS 55到60，Suggestion建议为REVIEW 60到100，Suggestion建议为BLOCK
-  FaceResults	String[]	[]	Type取值为‘FACE’时，人脸识别的结果列表。基于图片中实际检测到的人脸数，返回数组最大值不超过5个。
-  Msg	String	OK	错误码描述信息。
-  Suggestion	String	PASS	识别场景的审核结论： PASS：正常 REVIEW：疑似 BLOCK：违规
-  Type	String	LABEL	取值'LABEL' 或‘FACE’，LABEL表示结论和置信度来自标签分类，FACE表示结论和置信度来自人脸识别。
remark	String	查询成功！	返回说明
ret_code	Number	0	返回标识，0为成功，其余为失败！
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "c258c1dac5024ef68267491cda2d7af9", "showapi_res_code": 0, "showapi_res_body": { "Response": { "DisgustResult": null, "Extra": "", "PoliticsResult": { "AdvancedInfo": "", "Code": 0, "Confidence": 33, "FaceResults": [ { "Candidates": [ { "Confidence": 33, "Name": "肖杰" } ], "FaceRect": { "Height": 284, "Width": 284, "X": 51, "Y": 123 } } ], "Msg": "OK", "Suggestion": "PASS", "Type": "FACE" }, "PornResult": { "AdvancedInfo": "", "Code": 0, "Confidence": 82, "Msg": "OK", "Suggestion": "PASS", "Type": "NORMAL" }, "RequestId": "c949ca16-7bbb-4627-80cf-3a415b0cecae", "Suggestion": "PASS", "TerrorismResult": { "AdvancedInfo": "", "Code": 0, "Confidence": 0, "FaceResults": [], "Msg": "OK", "Suggestion": "PASS", "Type": "LABEL" } }, "remark": "查询成功！", "ret_code": 0 } }