在百度AI開放平臺使用百度的人臉識別能力,只需要三個核心步驟即可操作完成:
1、獲取接口權限 2、準備接口調用工具 3、進行接口調用,全部流程走通只需要十分鐘時間。
具體操作步驟如下:
1、 獲取接口權限
獲取接口權限是調用接口的前提,主要分爲以下幾步:
(1)進入百度雲的人臉識別控制檯
https://console.bce.baidu.com/ai/?_=1528192333418&fromai=1#/ai/face/overview/index
若沒有百度賬號,可以用手機號快速註冊一個。
(2)創建人臉識別應用
賬號登錄成功,您需要創建應用纔可正式調用AI能力。應用是您調用API服務的基本操作單元,您可以基於應用創建成功後獲取的API Key及Secret Key,進行接口調用操作,及相關配置。
創建應用,填寫【應用名稱】和【應用描述】,即可創建應用(其他選項可以不做操作,使用默認值即可)
創建完成後,點擊“返回應用列表”進行下一步操作。
(3)獲取祕鑰
在您創建完畢應用後,平臺將會分配給您此應用的相關憑證:API Key、Secret Key。使用祕鑰將可以在下一步中獲取調用接口所需的Access Token。
(2)獲取調用接口所需的Access Token
人臉識別在線接口主要針對HTTP API調用者,,調用API時必須在URL中帶上accesss_token參數,獲取Access Token的流程如下:
A、如果您使用的是mac電腦可以將此示例代碼複製到“終端”上直接獲取token。示例代碼如下:
#!/bin/bash curl -i -k'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=【API Key】&client_secret=【Seceret Key】
B、非Mac電腦操作流程如下,參考文檔:http://ai.baidu.com/docs#/Auth/top
獲取Access Token
請求URL數據格式
向授權服務地址https://aip.baidubce.com/oauth/2.0/token發送請求(推薦使用POST),並在URL中帶上以下參數:
· grant_type: 必須參數,固定爲client_credentials;
· client_id: 必須參數,應用的API Key;
· client_secret: 必須參數,應用的Secret Key;
例如:
https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq5eR3LT0vuXV4&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2&
服務器返回的JSON文本參數如下:
· access_token: 要獲取的Access Token;
· expires_in: Access Token的有效期(秒爲單位,一般爲1個月);
· 其他參數忽略,暫時不用;
例如:
{
"refresh_token": "25.b55fe1d287227ca97aab219bb249b8ab.315360000.1798284651.282335-8574074",
"expires_in": 2592000,
"scope": "public wise_adapt",
"session_key":"9mzdDZXu3dENdFZQurfg0Vz8slgSgvvOAUebNFzyzcpQ5EnbxbF+hfG9DQkpUVQdh4p6HbQcAiz5RmuBAja1JJGgIdJI",
"access_token": "24.6c5e1ff107f0e8bcef8c46d3424a0e78.2592000.1485516651.282335-8574074",
"session_secret": "dfac94a3489fe9fca7c3221cbf7525ff"
}
若請求錯誤,服務器將返回的JSON文本包含以下參數:
· error: 錯誤碼;關於錯誤碼的詳細信息請參考下方鑑權認證錯誤碼。
· error_description: 錯誤描述信息,幫助理解和解決發生的錯誤。
例如認證失敗返回:
{
"error": "invalid_client",
"error_description": "unknown client id"
}
保存獲取到的Access Token,在調用接口時會用到。
2、 準備接口調用工具
Postman是一個比較給力的Http請求模擬工具,可以快速進行接口調用。
下載地址如下:
安裝教程: Postman的安裝非常簡單,只需要雙擊安裝包,然後什麼都不需要操作,它直接就自己完成了,如下圖,在初次登錄的時候很多人都沒有賬號,所以說我們可以直接點擊圖示中的藍色字體部分,直接進入Postman的主界面:
如下圖,這就是Postman的主界面。
3、 進行調用接口
在postman上可以快速進行接口請求,調用人臉識別接口需要輸入正確的接口地址,提前準備人臉圖片,具體如下:
(1)輸入請求地址
可直接複製的請求地址:“https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/add?access_token=【在第一步中獲取的access-token】”
注:需要將請求格式切換爲“Post”
(2)修改請求頭(header)
Key欄輸入:Content-Type
Value欄輸入:application/x-www-form-urlencoded
(3)輸入請求參數(body)
先選擇“x-www-form-urlencoded”,然後參考下圖輸入參數:
image_type=BASE64
image=圖片的base64轉碼後的結果(此處要使用即將註冊到人臉庫的人臉圖片),轉碼工具:https://tool.css-js.com/base64.html(注意:在base64轉碼工具中,要取消默認選項“包含頭”)
group_id=gropu001(可自定義:由數字、字母、下劃線組成)
user_id=0001(可自定義:由數字、字母、下劃線組成)
注意:在base64轉碼工具中,要取消默認選項“包含頭”
(4)開始請求
點擊右上角的“send”,即可請求成功。
2、驗證調用結果
進入百度雲後臺的人臉庫可視化管理界面,點擊人臉庫名稱並逐級進入到人臉維度,即可看到註冊成功的人臉圖片(注:調用在線API接口添加用戶後,會延遲幾分鐘再展示到此頁面,如果沒更新,請勿着急)
人臉識別