优图人脸识别sdk Python_sdk

MIT
Python 查看源码»
跨平台
腾讯
2016-03-29
诺克萨斯

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

    • appid 业务中的应用标识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

的码云指数为
超过 的项目
加载中

评论(0)

暂无评论

暂无资讯

暂无问答

python之vs2005与boost环境搭建实例---调用迅雷SDK-实现python版迅雷

python之vs2005与boost环境搭建实例---调用迅雷SDK-实现python版迅雷 python之vs2005与boost环境搭建实例---调用迅雷SDK-实现python版迅雷 在chinaunix看到的,还不错,就转过来了 python之v...

2012/04/28 16:53
185
0
1 - 初识 3ds Max Python API

### 3ds Max Python API 简介 *3ds Max Python API* 可以帮助我们扩展和定义 *3ds Max*。它在 *MAXScript* 和 *Python* 之间架起了一座桥梁,我们可以通过 *MAXScript* 和 *3ds Max* 命令行来...

2018/06/20 01:30
118
0
Pepper中级教程:第一章 如何用Python远程控制机器人

1. 目标 Python是最容易入门的语言,我们尝试写一个Python程序,来远程控制Pepper/Nao机器人说话。 网络连接方式如下图。 1- 在一台个人PC上编写这个Python程序,操作系统不限。 2- 个人PC与...

2018/10/24 16:51
175
0
Mac下 IntelliJ IDEA 12 建立python 项目时 google app e...

本文适用于 Mac 下的IntelliJ IDEA 12(需要python插件) 目前google官方提供的 Google App Engine SDK for Python Mac版,安装后得到GoogleAppEngineLauncher.app,是一个辅助程序,而真正的G...

2013/02/23 23:59
2.4K
0
使用Visual Studio,几步实现Python C++扩展,以及DLL调用

在网上搜了下Python扩展教程,很多提到第三方开源库,而官方推荐的是用setup.py。其实用Visual Studio很简单!来看一下如何一步步编写一个Python扩展,以及如何通过扩展来调用DLL。 参考原文...

2015/05/26 14:11
4.1K
0
轻松使用OpenCV Python控制Webcam,读取Barcode

虽然手机上Barcode应用已经非常流行,但是工作的时候还是用Webcam比较方便。比如需要检测Barcode,我只需要拿Webcam对着电脑屏幕或者纸张扫一下就可以了。今天分享下如何轻松使用OpenCV控制W...

2015/08/11 15:06
1K
0
基于支付宝官方 alipay-sdk-PHP-3.0.0 翻译 python 版本

翻译php版本的sdk到python版本,做一个全功能的sdk. https://github.com/weihaipy/alipay_sdk_python

2018/05/03 11:57
28
0
【阿里云产品公测】离线归档OAS,再也不用担心备份空间了

OAS低成本、高可靠,长久归档备份,提供了99.99999999%的数据可靠性,这是它的特色。免费试用期间,每个用户可以存储不超过10T的数据,可以考虑考虑喔。

2014/10/14 15:24
23
0
appium+python3.6

1.安装jdk1.8(不知道为啥只识别1.8,1.10不识别,所以为了少折腾,迁就安装1.8) http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html 配置 JAVA_HOME:...

2018/06/25 09:04
50
0

没有更多内容

加载失败,请刷新页面

返回顶部
顶部