java sdk for 腾讯云智能优图服务 & 腾讯优图开放平台
AppId
平台添加应用后分配的AppIdSecretId
平台添加应用后分配的SecretIdSecretKey
平台添加应用后分配的SecretKey签名
接口鉴权凭证,由AppId、SecretId、SecretKey等生成,详见http://open.youtu.qq.com/welcome/authentication
- 下载sdk到您的目录 git clone https://github.com/TencentYouTu/java_sdk.git
- 在你的项目里引入本项目dist目录下的json.jar和youtu-java-sdk.jar包或者直接引入源码
- 导入包并创建Youtu对象,然后调用相应方法
import org.json.JSONObject;
import com.youtu.*;
public static final String APP_ID = "your appid";
public static final String SECRET_ID = "your secretId ";
public static final String SECRET_KEY = "your secretKey ";
public static final String USER_ID = "your qq ";
- 优图开放平台初始化
Youtu faceYoutu = new Youtu(APP_ID, SECRET_ID, SECRET_KEY,Youtu.API_YOUTU_END_POINT,USER_ID);
- 优图开放平台核身服务初始化(核身服务目前仅支持核身专有接口,需要联系商务开通)
Youtu faceYoutu = new Youtu(APP_ID, SECRET_ID, SECRET_KEY,Youtu.API_YOUTU_CHARGE_END_POINT,USER_ID);
- 腾讯云初始化方式
Youtu faceYoutu = new Youtu(APP_ID, SECRET_ID, SECRET_KEY,Youtu.API_TENCENTYUN_END_POINT,USER_ID);
- 人脸检测调用示例
JSONObject response = faceYoutu.DetectFace("test.jpg");
- 获取详细信息
if(response.getInt("errorcode")==0){
System.out.println(response.get("image_height"));
System.out.println(response.get("face"));
System.out.println(response.getJSONArray("face").getJSONObject(0).get("yaw"));
System.out.println(response.getInt("errorcode"));
System.out.println(response.get("errormsg"));
}
Api分为开放平台API和核身API,核身API访问权限需要联系商务开通;开放平台API访问域名为https://api.youtu.qq.com/, 核身API访问域名为https://vip-api.youtu.qq.com/
优图开放平台相关核身API封装,均为同步函数,需要联系商务开通 接口调用统一返回值说明
- 返回值类型为
JSONObject
,具体字段参考API文档
- 接口
JSONObject LiveGetFour()
- 参数
- 无
- 接口
JSONObject LiveDetectFour(String validate_data,String video_path,String card_path,boolean compare_card)
- 参数
validate_data
LiveGetFour获取的四字唇语video_path
视频的路径card_path
对比照片的路径compare_card
视频与照片是否进行对比,true 对比 false不对比
- 接口
JSONObject IdcardLiveDetectfour(String idcard_number,String idcard_name,String validate_data,String video_path)
- 参数
idcard_number
身份证号码idcard_name
身份证姓名validate_data
LiveGetFour获取的四字唇语video_path
视频的路径
- 接口
JSONObject IdcardFaceCompare(String idcard_number,String idcard_name,String image_path)
- 参数
idcard_number
身份证号码idcard_name
身份证姓名image_path
照片的路径
- 接口
JSONObject FaceCompare(String image_path_a, String image_path_b)
JSONObject FaceCompareUrl(String urlA, String urlB)
- 参数
image_path_a
待检测的图片A路径image_path_b
待检测的图片B路径urlA
待检测的图片A的urlurlB
待检测的图片B的url
- 接口
JSONObject IdCardOcr(String image_path, int card_type)
JSONObject IdCardOcrUrl(String url, int card_type)
- 参数
image_path
待检测图片路径url
待检测图片的urlcard_type
0 代表输入图像是身份证正面, 1代表输入是身份证反面
优图开放平台相关API封装,均为同步函数 接口调用统一返回值说明
- 返回值类型为
JSONObject
,具体字段参考API文档
- 接口
JSONObject DetectFace(String image_path,int mode)
JSONObject DetectFaceUrl(String url, int mode)
- 参数
image_path
待检测的图片路径url
待检测的图片urlmode
是否大脸模式,1为大脸、0为非大脸
- 接口
JSONObject FaceShape(String image_path,int mode)
JSONObject FaceShapeUrl(String url,int mode)
- 参数
image_path
待检测的图片路径mode
是否大脸模式,1为大脸、0为非大脸
- 接口
JSONObject FaceCompare(String image_path_a, String image_path_b)
JSONObject FaceCompareUrl(String urlA, String urlB)
- 参数
image_path_a
待检测的图片A路径image_path_b
待检测的图片B路径urlA
待检测的图片A的urlurlB
待检测的图片B的url
- 接口
JSONObject FaceVerify(String image_path, String person_id)
JSONObject FaceVerifyUrl(String url, String person_id)
- 参数
person_id
待验证的人脸idurl
待检测的图片urlimage_path
待验证的图片路径
- 接口
JSONObject FaceIdentify(String image_path, String group_id)
JSONObject FaceIdentifyUrl(String url, String group_id)
- 参数
group_id
待识别的组idurl
待检测的图片urlimage_path
待识别的图片数据路径
- 接口
JSONObject NewPerson(String image_path, String person_id, List<String> group_ids)
JSONObject NewPersonUrl(String url, String person_id,List<String> group_ids)
- 参数
person_id
新建的个体id,用户指定,需要保证app_id下的唯一性person_name
新建的个体名称group_ids
新建的个体存放的组id,可以指定多个组id,用户指定(组默认创建)url
待检测的图片urlimage_path
包含个体人脸的图片路径tag
备注信息,用户自解释字段
- 接口
JSONObject DelPerson(String person_id)
- 参数
person_id
待删除的个体id
- 接口
JSONObject AddFace(String person_id, List<String> image_path_arr)
JSONObject AddFaceUrl(String person_id, List<String> url_arr)
- 参数
person_id
新增人脸的个体身份idurl_arr
待检测的图片url构成的数组image_path_arr
待增加的包含人脸的图片数据的路径,可加入多张(总包体大小<2m)
- 接口
JSONObject DelFace(String person_id, List<String> face_id_arr)
- 参数
person_id
待删除人脸的个体身份idface_id_arr
待删除的人脸id集合
- 接口
JSONObject GetInfo(String person_id)
- 参数
person_id
待查询的个体身份id
- 接口
JSONObject SetInfo(String person_name, String person_id)
- 参数
person_id
待设置的个体身份idperson_name
新设置的个体名字
- 接口
JSONObject GetGroupIds()
- 参数
- 无
- 接口
JSONObject GetPersonIds(String group_id)
- 参数
group_id
待查询的组id
- 接口
JSONObject GetFaceIds(String person_id)
- 参数
person_id
待查询的个体id
- 接口
JSONObject GetFaceInfo(String face_id)
- 参数
face_id
待查询人脸的id
- 接口
JSONObject FuzzyDetect(String image_path)
JSONObject FuzzyDetectUrl(String url)
- 参数
url
待检测的图片urlimage_path
待识别的图片数据路径
- 接口
JSONObject FoodDetect(String image_path)
JSONObject FoodDetectUrl(String url)
- 参数
url
待检测的图片urlimage_path
待识别的图片数据路径
- 接口
JSONObject ImageTag(String image_path)
JSONObject ImageTagUrl(String url)
- 参数
url
待检测的图片urlimage_path
待识别的图片数据路径
- 接口
JSONObject ImagePorn(String image_path)
JSONObject ImagePornUrl(String url)
- 参数
image_path
待识别的图片数据路径url
待检测的图片url
- 接口
JSONObject IdCardOcr(String image_path, int card_type)
JSONObject IdCardOcrUrl(String url, int card_type)
- 参数
image_path
待检测图片路径url
待检测图片的urlcard_type
0 代表输入图像是身份证正面, 1代表输入是身份证反面
- 接口
JSONObject NameCardOcr(String image_path,boolean retimage)
JSONObject NameCardOcr(String url,boolean retimage)
- 参数
image_path
待检测图片路径url
待检测图片的urlretimage
false代表不需要返回识别后图像, true代表需要返回识别后图像
####更多详情和文档说明参见