TencentYoutuyun简介
腾讯优图TencentYoutuyun可以用来人脸识别等功能。腾讯旗下顶级的机器学习研发团队，专注于图像处理、模式识别、深度学习。在人脸识别、图像识别、医疗AI、交通、OCR等领域积累了领先的技术水平和完整的解决方案。
官网：https://open.youtu.qq.com/#/open
TencentYoutuyun安装方法
三种方法，选一个即可！
T1、
点击连接下载即可https://github.com/Tencent-YouTu/Python_sdk，然后选择导入的方法
T2、
pip install Python_sdk-master.zip 都可以是实现调用这个包
T3、
git clone https://github.com/Tencent-YouTu/nodejs_sdk.git
TencentYoutuyun使用方法—API
参考文章：tencentyun-youtu-nodejs-sdk
conf
配置项相关
conf.setAppInfo(appid, secretId, secretKey, userid, domain)
初始化配置项
参数
appid AppId 字符串类型
secretId SecretId 字符串类型
secretKey SecretKey 字符串类型
userid 业务中的用户标识 字符串类型
domain 主机标识，0（优图服务），1（腾讯云）
返回值 无（undefined）
其它
conf.USER_AGENT 请求的UserAgent
conf.API_YOUTU_SERVER 请求的优图服务器地址 默认为 api.youtu.qq.com
conf.API_YOUTU_PORT 请求的优图服务器端口 默认为 80
auth
接口调用时 计算签名鉴权相关逻辑。
auth.appSign(expired, userid)
获取签名，依赖conf中的配置项。
参数
expired 过期时间，UNIX时间戳, 计算的签名在过期时间之前有效.
userid 业务中的用户标识
返回值 签名（base64）
其它
auth.AUTH_PARAMS_ERROR 参数错误常量（-1）
auth.AUTH_SECRET_ID_KEY_ERROR 密钥ID或者密钥KEY错误常量（-2）
youtu
优图相关API封装，均为异步函数，使用回调函数方式获取结果。
注意：此处callback函数并未遵从Node.js风格的错误回调callback(error, data)，因此需要对返回数据中的状态进行判断，只有200时认为是请求成功。
youtu.detectface(imagePath, isbigface, callback)
人脸检测，检测给定图片(Image)中的所有人脸(Face)的位置和相应的面部属性。位置包括(x, y, w, h)，面部属性包括性别(gender)、年龄(age) 表情(expression)、眼镜(glass)和姿态(pitch，roll，yaw)。
参数
imagePath 图片路径
isbigface 是否大脸模式 ０表示检测所有人脸， 1表示只检测照片最大人脸 适合单人照模式
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.faceshape(imagePath, isbigface, callback)
人脸定位，检测给定图片中人脸的五官。对请求图片进行人脸配准，计算构成人脸轮廓的88个点， 包括眉毛（左右各8点）、眼睛（左右各8点）、鼻子（13点）、嘴巴（22点）、脸型轮廓（21点）
参数
imagePath 图片路径
isbigface 是否大脸模式 ０表示检测所有人脸， 1表示只检测照片最大人脸 适合单人照模式
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.facecompare(image_a, image_b, callback)
人脸对比，计算两个Face的相似性以及五官相似度。
参数
image_a 第一张图片路径
image_b 第二张图片路径
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.facecompare_file_url(image_file, image_url, callback)
人脸对比，计算两个Face的相似性以及五官相似度。
参数
image_file 第一张图片路径
image_url 第二张图片url
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.faceverify(image_a, person_id, callback)
人脸验证，给定一个Face和一个Person，返回是否是同一个人的判断以及置信度。
参数
image_a 图片路径
person_id 待验证的Person
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.faceidentify(image_a, group_id, callback)
人脸识别，对于一个待识别的人脸图片，在一个Group中识别出最相似的Top5 Person作为其身份返回，返回的Top5中按照相似度从大到小排列。
参数
image_a 图片路径
group_id 需要识别的人 所在的组
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.multifaceidentify(image_a, group_id, group_ids, topn, min_size, callback)
上传人脸图片，进行多人脸检索。
参数
image_a 图片路径
group_id 需要识别的人 所在的组
group_ids 需要识别的人所在的组的列表（数组）
topn 候选人脸数量，一般使用默认值5
min_size 人脸检测最小尺寸，一般使用默认值40
callback(data) 回调函数
其中回调函数callback的参数data是一个对象，结构如下：
httpcode HTTP状态码
code 状态码，目前和httpcode相同
message 状态码对应的描述文字
data 数据对象，参考API文档
youtu.newperson(image_a, person_id, person_name, group_ids, persontag, callback)
