# image-python-sdk-v2.0

**Repository Path**: mirrors_tencentyun/image-python-sdk-v2.0

## Basic Information

- **Project Name**: image-python-sdk-v2.0
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tencentyun/image-python-sdk-v2.0
腾讯云 [万象优图（Cloud Image v2.0）](https://www.qcloud.com/product/ci) 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-名片识别。

##### 图片鉴黄

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

##### 图片标签

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

##### OCR-身份证识别

```python
	#单个或多个图片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-名片识别	
```python
	#单个或多个图片Url
	print (client.namecard_detect(CIUrls(['YOUR URL A', 'YOUR URL B'])))
	#单个或多个图片file
	print (client.namecard_detect(CIFiles(['./name1.jpg'])))
```

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

#### 人脸检测

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

##### 五官定位

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

##### 个体信息管理
```python
    //个体创建,创建一个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，返回是否是同一个人的判断以及置信度

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

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

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

##### 人脸对比

```python
	#两个对比图片的文件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 人脸核身
##### 身份证识别对比

```python
	#身份证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')))
```

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

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

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

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

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

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