java sdk for 腾讯云智能优图服务 & 腾讯优图开放平台

• AppId 平台添加应用后分配的AppId
• SecretId 平台添加应用后分配的SecretId
• SecretKey 平台添加应用后分配的SecretKey
• 签名 接口鉴权凭证，由AppId、SecretId、SecretKey等生成，详见http://open.youtu.qq.com/welcome/authentication

1. 下载sdk到您的目录 git clone https://github.com/TencentYouTu/java_sdk.git
2. 在你的项目里引入本项目dist目录下的json.jar和youtu-java-sdk.jar包或者直接引入源码
3. 导入包并创建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封装，均为同步函数，需要联系商务开通 接口调用统一返回值说明

• 返回值类型为 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 ValidateIdcard(String idcard_number,String idcard_name)
• 参数
  • idcard_number 身份证号码
  • idcard_name 身份证姓名

• 接口 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的url
  • urlB 待检测的图片B的url

• 接口 JSONObject IdCardOcr(String image_path, int card_type) JSONObject IdCardOcrUrl(String url, int card_type)
• 参数
  • image_path 待检测图片路径
  • url 待检测图片的url
  • card_type 0 代表输入图像是身份证正面， 1代表输入是身份证反面

优图开放平台相关API封装，均为同步函数 接口调用统一返回值说明

• 返回值类型为 JSONObject，具体字段参考API文档

• 接口 JSONObject DetectFace(String image_path,int mode) JSONObject DetectFaceUrl(String url, int mode)
• 参数
  • image_path 待检测的图片路径
  • url 待检测的图片url
  • mode 是否大脸模式，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的url
  • urlB 待检测的图片B的url

• 接口 JSONObject FaceVerify(String image_path, String person_id) JSONObject FaceVerifyUrl(String url, String person_id)
• 参数
  • person_id 待验证的人脸id
  • url 待检测的图片url
  • image_path 待验证的图片路径

• 接口 JSONObject FaceIdentify(String image_path, String group_id) JSONObject FaceIdentifyUrl(String url, String group_id)
• 参数
  • group_id 待识别的组id
  • url 待检测的图片url
  • image_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 待检测的图片url
  • image_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 新增人脸的个体身份id
  • url_arr 待检测的图片url构成的数组
  • image_path_arr 待增加的包含人脸的图片数据的路径，可加入多张（总包体大小<2m）

• 接口 JSONObject DelFace(String person_id, List<String> face_id_arr)
• 参数
  • person_id 待删除人脸的个体身份id
  • face_id_arr 待删除的人脸id集合

• 接口 JSONObject GetInfo(String person_id)
• 参数
  • person_id 待查询的个体身份id

• 接口 JSONObject SetInfo(String person_name, String person_id)
• 参数
  • person_id 待设置的个体身份id
  • person_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 待检测的图片url
  • image_path 待识别的图片数据路径

• 接口 JSONObject FoodDetect(String image_path) JSONObject FoodDetectUrl(String url)
• 参数
  • url 待检测的图片url
  • image_path 待识别的图片数据路径

• 接口 JSONObject ImageTag(String image_path) JSONObject ImageTagUrl(String url)
• 参数
  • url 待检测的图片url
  • image_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 待检测图片的url
  • card_type 0 代表输入图像是身份证正面， 1代表输入是身份证反面

• 接口 JSONObject NameCardOcr(String image_path,boolean retimage) JSONObject NameCardOcr(String url,boolean retimage)
• 参数
  • image_path 待检测图片路径
  • url 待检测图片的url
  • retimage false代表不需要返回识别后图像， true代表需要返回识别后图像

####更多详情和文档说明参见

• 腾讯云智能优图服务
• 腾讯优图开放平台