Python_sdk 介绍
Python_sdk是一款用于腾讯优图人脸识别服务的sdk文件,优图人脸识别(Face Recognition),
是由腾讯优图团队研发的,基于人的脸部特征信息进行身份识别的一种生物识别技术。它提供了”人脸检测与分析”、”人脸比对”、”人脸验证”、”人脸识别”等一整套技术方案。
Python sdk for 腾讯云智能优图服务 &
腾讯优图开放平台
安装
依赖性
- Requests,获取更新版本
http://docs.python-requests.org/en/latest/
构建工程
1. 下载sdk到您的目录${python_sdk}
git clone https://github.com/TencentYouTu/python_sdk.git
2. 在您需要使用sdk的文件中import TencentYoutuyun包
名词
-
AppId 平台添加应用后分配的AppId
-
SecretId 平台添加应用后分配的SecretId
-
SecretKey 平台添加应用后分配的SecretKey
-
签名 接口鉴权凭证,由AppId、SecretId、SecretKey等生成,详见http://open.youtu.qq.com/welcome/authentication
使用示例
# -*- coding: utf-8 -*- import time import TencentYoutuyun appid = 'xxx' secret_id = 'xxxxxxx' secret_key = 'xxxxxxxx' userid= 'xxx' #end_point = TencentYoutuyun.conf.API_TENCENTYUN_END_POINT // 腾讯云 end_point = TencentYoutuyun.conf.API_YOUTU_END_POINT // 优图开放平台 youtu = TencentYoutuyun.YouTu(appid, secret_id, secret_key, userid, end_point) ret = youtu.FaceCompare('you_path_one.jpg','you_path_two.jpg') print ret
SDK内部错误码说明
IMAGE_FILE_NOT_EXISTS -1 //文件不存在 IMAGE_NETWORK_ERROR -2 //网络错误 IMAGE_ParaMS_ERROR -3 //图片参数错误 PERSON_ID_EMPTY -4 //参数person_id 为空 GROUP_ID_EMPTY -5 //参数group_id 为空 GROUP_IDS_EMPTY -6 //参数group_ids 为空 IMAGES_EMPTY -7 //参数images 集合为空 FACE_IDS_EMPTY -8 //参数face_ids 集合为空 FACE_ID_EMPTY -9 //参数face_id为空 LIST_TYPE_INVALID -10 //不是list类型 IMAGE_PATH_EMPTY -11 //传入的image_path为空
初始化
-
示例
-
youtu = TencentYoutuyun.YouTu(appid, secret_id, secret_key, userid, end_point)
-
参数ytopen_sdk::AppSign
接口说明
接口调用统一返回值说明
- 返回值Json格式的返回结果,具体字段参考api文档
人脸检测
-
接口DetectFace(self, image_path, mode = 0, data_type = 0)
-
参数
人脸配准
-
接口FaceShape(self, image_path, mode = 0, data_type = 0)
-
参数
人脸比对
-
接口FaceCompare(self, image_pathA, image_pathB, data_type = 0):
-
参数
人脸验证
-
接口FaceVerify(self, person_id, image_path, data_type = 0)
-
参数
人脸识别
-
接口FaceIdentify(self, group_id, image_path, data_type = 0)
-
参数
新建个体
-
接口NewPerson(self, person_id, image_path, group_ids, person_name= '', tag='', data_type = 0)
-
参数
删除个体
-
接口DelPerson(self, person_id)
-
参数
- person_id 待删除的个体id
-
接口AddFace(self, person_id, images, tag='', data_type = 0)
-
参数
获取信息
-
接口GetInfo(self, person_id)
-
参数
- person_id 待查询的个体身份id
设置信息
-
接口SetInfo(self, person_id, person_name='', tag='')
-
参数
-
person_id 待设置的个体身份id
-
person_name 新设置的个体名字,为空无效
-
tag 新设置的人脸备注信息,为空无效
-
获取组列表
-
接口GetGroupIds(self)
-
参数
- 无
获取个体列表
-
接口GetPersonIds(self, group_id)
-
参数
- group_id 待查询的组id
-
接口GetFaceIds(self, person_id)
-
参数
- person_id 待查询的个体id
模糊验证
fuzzydetect(self, image_path, data_type = 0, seq = '')
美食检测
fooddetect(self, image_path, data_type = 0, seq = '')
imagetag(self, image_path, data_type = 0, seq = '')