腾讯云-人脸融合

人脸融合

接口地址：http://route.showapi.com/1962-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
ProjectId	String		104578	是	活动 ID，请在腾讯云人脸融合控制台查看。
ModelId	String		qc_104578_164225_2	是	素材 ID，请在腾讯云人脸融合控制台查看。
Image	String		/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ…………………………s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==	是	图片 base64 数据。请确保人脸为正脸，无旋转。若某些手机拍摄后人脸被旋转，请使用图片的 EXIF 信息对图片进行旋转处理；请勿在 base64 数据中包含头部，如“data:image/jpeg;base64,”。
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1962-1","my_appId","my_appSecret") .addTextPara("ProjectId","104578") .addTextPara("ModelId","qc_104578_164225_2") .addTextPara("Image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ…………………………s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .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
-  Image	String	https://facefusion-1254418846.cos.ap-guangzhou.myqcloud.com/qc_100646_204857_1_1543312645513131155.jpg	返回结果为图片的地址
-  RequestId	String	66676130-5588-4cdb-a81e-8bd3c99cea1f	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-  ReviewResultSet	Object[]		鉴黄鉴政结果
-  0	Object
-  Category	String	porn	对应的类别名称 porn, politics, terror
-  Code	Number	0	对应子类别状态码
-  CodeDescription	String	ok	对应子类别状态码信息描述
-  Suggestion	String	pass	此字段为保留字段，目前统一返回pass。
-  Confidence	Number	0	对应识别种类的置信度
-  DetailSet	Object[]		审核详细内容
-  0	Object
-  Field	String	porn	鉴政使用字段, 为职业属性,其他审核结果对应上一级category
-  Label	String	porn	人员名称
-  Confidence	Number	0	对应识别label的置信度
-  Suggestion	String	pass	此字段为保留字段，目前统一返回pass。
...

返回示例：{ "showapi_res_error":"", "showapi_res_id":"fcf03b4fc1f24ecdab580befbfcf2efe", "showapi_res_code":0, "showapi_res_body":{ "Response":{ "Image":"https://facefusion-1254418846.cos.ap-guangzhou.myqcloud.com/qc_100646_204857_1_1543312645513131155.jpg", "RequestId":"66676130-5588-4cdb-a81e-8bd3c99cea1f", "ReviewResultSet":[ { "Category":"porn", "Code":0, "CodeDescription":"ok", "Suggestion":"pass", "Confidence":0.000022541460566572, "DetailSet":[ { "Field":"porn", "Label":"porn", "Confidence":1.9030628184424e-9, "Suggestion":"pass" } ] }, { "Category":"politics", "Code":0, "CodeDescription":"ok", "Suggestion":"pass", "Confidence":0.71566122770309, "DetailSet":[ { "Field":"体育", "Lable":"丁俊晖", "Confidence":0.71566122770309, "Suggestion":"pass" } ] } ] } } }