TencentYoutuyun簡介
騰訊優圖TencentYoutuyun可以用來人臉識别等功能。騰訊旗下頂級的機器學習研發團隊,專注于圖像處理、模式識别、深度學習。在人臉識别、圖像識别、醫療AI、交通、OCR等領域積累了領先的技術水準和完整的解決方案。
官網:
https://open.youtu.qq.com/#/openTencentYoutuyun安裝方法
三種方法,選一個即可!
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.gitTencentYoutuyun使用方法—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)