Py之TencentYoutuyun：Python之TencentYoutuyun的簡介、安裝、使用方法之詳細安裝攻略

TencentYoutuyun簡介

         騰訊優圖TencentYoutuyun可以用來人臉識别等功能。騰訊旗下頂級的機器學習研發團隊，專注于圖像處理、模式識别、深度學習。在人臉識别、圖像識别、醫療AI、交通、OCR等領域積累了領先的技術水準和完整的解決方案。

官網：

https://open.youtu.qq.com/#/open

TencentYoutuyun安裝方法

三種方法，選一個即可！

T1、

點選連接配接下載下傳即可

https://github.com/Tencent-YouTu/Python_sdk

，然後選擇導入的方法

T2、

pip install Python_sdk-master.zip 都可以是實作調用這個包

T3、

git clone

https://github.com/Tencent-YouTu/nodejs_sdk.git

TencentYoutuyun使用方法—API

參考文章：tencentyun-youtu-nodejs-sdk

conf

配置項相關

conf.setAppInfo(appid, secretId, secretKey, userid, domain)

初始化配置項

參數

appid AppId 字元串類型

secretId SecretId 字元串類型

secretKey SecretKey 字元串類型

userid 業務中的使用者辨別 字元串類型

domain 主機辨別，0（優圖服務），1（騰訊雲）

傳回值 無（undefined）

其它

conf.USER_AGENT 請求的UserAgent

conf.API_YOUTU_SERVER 請求的優圖伺服器位址 預設為 api.youtu.qq.com

conf.API_YOUTU_PORT 請求的優圖伺服器端口 預設為 80

auth

接口調用時 計算簽名鑒權相關邏輯。

auth.appSign(expired, userid)

擷取簽名，依賴conf中的配置項。

expired 過期時間，UNIX時間戳, 計算的簽名在過期時間之前有效.

userid 業務中的使用者辨別

傳回值 簽名（base64）

auth.AUTH_PARAMS_ERROR 參數錯誤常量（-1）

auth.AUTH_SECRET_ID_KEY_ERROR 密鑰ID或者密鑰KEY錯誤常量（-2）

youtu

優圖相關API封裝，均為異步函數，使用回調函數方式擷取結果。

注意：此處callback函數并未遵從Node.js風格的錯誤回調callback(error, data)，是以需要對傳回資料中的狀态進行判斷，隻有200時認為是請求成功。

youtu.detectface(imagePath, isbigface, callback)

人臉檢測，檢測給定圖檔(Image)中的所有人臉(Face)的位置和相應的面部屬性。位置包括(x, y, w, h)，面部屬性包括性别(gender)、年齡(age) 表情(expression)、眼鏡(glass)和姿态(pitch，roll，yaw)。

imagePath 圖檔路徑

isbigface 是否大臉模式 ０表示檢測所有人臉， 1表示隻檢測照片最大人臉　适合單人照模式

callback(data) 回調函數

其中回調函數callback的參數data是一個對象，結構如下：

httpcode HTTP狀态碼

code 狀态碼，目前和httpcode相同

message 狀态碼對應的描述文字

data 資料對象，參考API文檔

youtu.faceshape(imagePath, isbigface, callback)

人臉定位，檢測給定圖檔中人臉的五官。對請求圖檔進行人臉配準，計算構成人臉輪廓的88個點， 包括眉毛（左右各8點）、眼睛（左右各8點）、鼻子（13點）、嘴巴（22點）、臉型輪廓（21點）

youtu.facecompare(image_a, image_b, callback)

人臉對比，計算兩個Face的相似性以及五官相似度。

image_a 第一張圖檔路徑

image_b 第二張圖檔路徑

youtu.facecompare_file_url(image_file, image_url, callback)

image_file 第一張圖檔路徑

image_url 第二張圖檔url

youtu.faceverify(image_a, person_id, callback)

人臉驗證，給定一個Face和一個Person，傳回是否是同一個人的判斷以及置信度。

image_a 圖檔路徑

person_id 待驗證的Person

youtu.faceidentify(image_a, group_id, callback)

人臉識别，對于一個待識别的人臉圖檔，在一個Group中識别出最相似的Top5 Person作為其身份傳回，傳回的Top5中按照相似度從大到小排列。

group_id 需要識别的人 所在的組

youtu.multifaceidentify(image_a, group_id, group_ids, topn, min_size, callback)

上傳人臉圖檔，進行多人臉檢索。

group_ids 需要識别的人所在的組的清單（數組）

topn 候選人臉數量，一般使用預設值5

min_size 人臉檢測最小尺寸，一般使用預設值40

youtu.newperson(image_a, person_id, person_name, group_ids, persontag, callback)