python如何使用sdk_Python_sdk首页、文档和下载 - 优图人脸识别sdk - OSCHINA - 中文开源技术交流社区...

Python_sdk是一款用于腾讯优图人脸识别服务的sdk文件，优图人脸识别(Face Recognition), 是由腾讯优图团队研发的，基于人的脸部特征信息进行身份识别的一种生物识别技术。它提供了"人脸检测与分析"、"人脸比对"、"人脸验证"、"人脸识别"等一整套技术方案。

安装

依赖性

- 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

使用示例# -*- 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::AppSignappid业务中的应用标识AppId

secret_id秘钥SecretId

secret_key秘钥SecretKey

userid用户id

end_point服务后台路径，默认是优图开放平台，支持腾讯云

接口说明

接口调用统一返回值说明返回值Json格式的返回结果，具体字段参考API文档

人脸检测接口DetectFace(self, image_path, mode = 0, data_type = 0)

参数image_path待检测的图片路径

mode是否大脸模式，默认非大脸模式

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

人脸配准接口FaceShape(self, image_path, mode = 0, data_type = 0)

参数image_path待检测的图片路径

mode是否大脸模式，默认非大脸模式

data_type用于表示image是图片还是url, 0代表图片，1代表url

人脸比对接口FaceCompare(self, image_pathA, image_pathB, data_type = 0):

参数image_pathA待比对的A图片路径

image_pathB待比对的B图片路径

data_type用于表示image_pathA, image_pathB是图片还是url, 0代表图片，1代表url

人脸验证接口FaceVerify(self, person_id, image_path, data_type = 0)

参数person_id待验证的个体id

image_path待验证的图片路径

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

人脸识别接口FaceIdentify(self, group_id, image_path, data_type = 0)

参数group_id识别的组id

image_path待识别的图片路径

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

新建个体接口NewPerson(self, person_id, image_path, group_ids, person_name= '', tag='', data_type = 0)

参数person_id新建的个体id，用户指定，需要保证app_id下的唯一性

person_name个体对应的姓名

group_ids数组类型，用户指定（组默认创建）的个体存放的组id，可以指定多个组id

image_path包含个体人脸的图片路径

tag备注信息，用户自解释字段

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

删除个体接口DelPerson(self, person_id)

参数person_id待删除的个体id

增加人脸接口AddFace(self, person_id, images, tag='', data_type = 0)

参数person_id新增人脸的个体身份id

images数组类型，待增加的包含人脸的图片路径，可加入多张（包体大小<2m）

tag人脸备注信息，用户自解释字段

data_type用于表示images是图片还是url, 0代表图片，1代表url

删除人脸接口DelFace(self, person_id, face_ids)

参数person_id待删除人脸的个体身份id

face_ids数组类型，待删除的人脸id

获取信息接口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

获取人脸信息接口GetFaceInfo(self, face_id)

参数face_id待查询的人脸id

模糊验证

fuzzydetect(self, image_path, data_type = 0, seq = '')参数image_path标识图片信息

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

美食检测

fooddetect(self, image_path, data_type = 0, seq = '')参数image_path标识图片信息

data_type用于表示image_path是图片还是url, 0代表图片，1代表url

图片分类

imagetag(self, image_path, data_type = 0, seq = '')参数image_path标识图片信息

data_type用于表示image_path是图片还是url, 0代表图片，1代表url