tencentyun/image-python-sdk-v2.0

腾讯云万象优图（Cloud Image v2.0） SDK for Python

安装

使用pip

Python 2:

pip install qcloud_image

Python 3:

pip3 install qcloud_image

下载源码

从github下载源码装入到您的程序中，并加载qcloud_image包调用请参考sample.py

1. 在腾讯云申请业务的授权

授权包括：

APP_ID 
SECRET_ID
SECRET_KEY
BUCKET

2. 创建对应操作类的对象

如果要使用图片，需要创建图片操作类对象

from qcloud_image import Client
from qcloud_image import CIUrl, CIFile, CIBuffer, CIUrls, CIFiles, CIBuffers

appid = 'APP_ID'
secret_id = 'SECRET_ID'
secret_key = 'SECRET_KEY'
bucket = 'BUCKET'

client = Client(appid, secret_id, secret_key, bucket)
client.use_http()
client.set_timeout(30)

3. 调用对应的方法

在创建完对象后，根据实际需求，调用对应的操作方法就可以了。sdk提供的方法包括：图片识别、人脸识别及人脸核身等。

3.1 图片识别

图片识别包括：图片鉴黄、图片标签、OCR-身份证识别及OCR-名片识别。

图片鉴黄

    #单个或多个图片Url
    print (client.porn_detect(CIUrls(['YOUR URL A','YOUR URL B'])))
    #单个或多个图片File
    print (client.porn_detect(CIFiles(['./test.jpg',])))

图片标签

    #单个图片url
    print (client.tag_detect(CIUrl('YOUR URL')))
    #单个图片file
    print (client.tag_detect(CIFile('./hot2.jpg')))

OCR-身份证识别

    #单个或多个图片Url,识别身份证正面
    print (client.idcard_detect(CIUrls(['YOUR URL']), 0))
    #单个或多个图片file,识别身份证正面
    print (client.idcard_detect(CIFiles(['./id4_zheng.jpg','./id1_zheng.jpg']), 0))
    #单个或多个图片Url,识别身份证反面
    print (client.idcard_detect(CIUrls(['YOUR URL A', 'YOUR URL B']), 1))
    #单个或多个图片file,识别身份证反面
    print (client.idcard_detect(CIFiles(['./id5_fan.jpg']), 1))

OCR-名片识别

    #单个或多个图片Url
    print (client.namecard_detect(CIUrls(['YOUR URL A', 'YOUR URL B'])))
    #单个或多个图片file
    print (client.namecard_detect(CIFiles(['./name1.jpg'])))

3.2 人脸识别

人脸识别包括：人脸检测、五官定位、个体信息管理、人脸验证、人脸对比及人脸检索。

人脸检测

    #单个图片Url, mode:1为检测最大的人脸 , 0为检测所有人脸
    print (client.face_detect(CIUrl('YOUR URL')))
    #单个图片file,mode:1为检测最大的人脸 , 0为检测所有人脸
    print (client.face_detect(CIFile('./hot2.jpg')))

五官定位

    #单个图片Url,mode:1为检测最大的人脸 , 0为检测所有人脸
    print (client.face_shape(CIUrl('YOUR URL'),1))
    #单个图片file,mode:1为检测最大的人脸 , 0为检测所有人脸
    print (client.face_shape(CIFile('./hot2.jpg'),1))

个体信息管理

    //个体创建,创建一个Person，并将Person放置到group_ids指定的组当中，不存在的group_id会自动创建。
    #创建一个Person, 使用图片url
    print (client.face_newperson('person111', ['group2',], CIUrl('YOUR URL'), 'xiaoxin'))
    #创建一个Person, 使用图片file
    print (client.face_newperson('person211', ['group2',], CIFile('./hot2.jpg')))

    //增加人脸,将一组Face加入到一个Person中。注意，一个Face只能被加入到一个Person中。 
    #将单个或者多个Face的url加入到一个Person中
    print (client.face_addface('person111', CIUrls(['YOUR URL A','YOUR URL B'])))
    #将单个或者多个Face的file加入到一个Person中
    print (client.face_addface('person211', CIFiles(['./test.jpg',])))

    #删除人脸,删除一个person下的face
    print (client.face_delface('person111', ['person111',]))

    #设置信息
    print (client.face_setinfo('person111', 'hello'))

    #获取信息
    print (client.face_getinfo('person111'))

    #获取组列表
    print (client.face_getgroupids())

    #获取人列表
    print (client.face_getpersonids('group2'))

    #获取人脸列表
    print (client.face_getfaceids('person211'))

    #获取人脸信息
    print (client.face_getfaceinfo('1820307972625034938'))

    #删除个人
    print (client.face_delperson('person11'))

人脸验证

给定一个Face和一个Person，返回是否是同一个人的判断以及置信度

    #人脸验证,单个图片Url
    print (client.face_verify('person111', CIUrl('YOUR URL')))
    #人脸验证,单个图片file
    print (client.face_verify('person111', CIFile('./test.jpg')))

人脸检索

对于一个待识别的人脸图片，在一个Group中识别出最相似的Top5 Person作为其身份返回，返回的Top5中按照相似度从大到小排列。

    #人脸检索,单个文件url
    print (client.face_identify('group1', CIUrl('YOUR URL')))
    ##人脸检索,单个文件file
    print (client.face_identify('group2', CIFile('./test.jpg')))

人脸对比

    #两个对比图片的文件url
    print (client.face_compare(CIFile('./zhao1.jpg'), CIFile('./zhao2.jpg')))
    #两个对比图片的文件file
    print (client.face_compare(CIUrl('YOUR URL A'), CIUrl('YOUR URL B')))
    #一个是图片的文件url， 一个是对比图片的文件file
    print (client.face_compare(CIFile('./zhao1.jpg'), CIUrl('YOUR URL C')))

3.3 人脸核身

身份证识别对比

    #身份证url
    print (client.face_idcardcompare('ID CARD NUM', 'NAME', CIUrl('YOUR URL')))
    #身份证文件file
    print (client.face_idcardcompare('ID CARD NUM', 'NAME', CIFile('./id4_zheng.jpg')))

活体检测—获取唇语验证码

    obj = client.face_livegetfour()
    print (obj)
    #验证码
    validate_data = obj['data']['validate_data']

活体检测-视频与身份证高清照片的比对

    print (client.face_livedetectfour(validate_data, CIFile('../dn.qlv'), False, CIFile('../wxb.jpg')))

活体检测-视频与用户照片的比对

    print (client.face_idcardlivedetectfour(validate_data, CIFile('../dnn.qlv'), 'ID CARD NUM', 'NAME'))

tencentyun / image-python-sdk-v2.0

readme