天天看點

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 是否大臉模式 0表示檢測所有人臉, 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)