臉部辨識數據結構
本文說明臉部服務中用於臉部辨識作業的數據結構。 這些數據結構會將數據保存在臉部和人員上。
警告
臉部辨識服務存取受限於資格和使用準則,以支援我們的「負責任的 AI 原則」。 臉部辨識服務僅供 Microsoft 受管理的客戶和合作夥伴使用。 請使用臉部辨識受理表單以申請存取。 如需詳細資訊,請參閱臉部的有限存取權頁面。
與識別搭配使用的數據結構
臉部識別 API 會使用容器數據結構,以 Person 物件的形式保存臉部辨識數據。 此容器有三種類型,從最舊到最新列出。 我們建議您一律使用最新的。
PersonGroup
PersonGroup 是最小的容器數據結構。
- 當您建立 PersonGroup 時,您必須指定辨識模型。 當任何臉部新增至該 PersonGroup 時,它會使用該模型來處理它們。 此模型必須符合模型版本與偵測 API 中的臉部標識碼。
- 您必須呼叫定型 API,讓任何新的臉部數據反映在識別 API 結果中。 這包括新增/移除臉部和新增/移除人員。
- 針對免費層訂用帳戶,最多可以容納 1000 人。 針對 S0 付費訂用帳戶,最多可以有 10,000 人。
PersonGroupPerson 代表要識別的人員。 最多可以容納 248 張臉。
大型人員群組
LargePersonGroup 是稍後引進的數據結構,可支援最多 100 萬個實體(適用於 S0 層訂用帳戶)。 它已優化以支援大規模數據。 它共用大部分 PersonGroup 功能:必須在建立時指定辨識模型,而且必須在使用之前呼叫定型 API。
人員目錄
PersonDirectory 是這種最新數據結構。 它支援較大的規模和更高的精確度。 每個 Azure 臉部資源都有單一預設 PersonDirectory 數據結構。 這是 PersonDirectoryPerson 物件的一般清單,最多可以容納 7500 萬個物件。
PersonDirectoryPerson 代表要識別的人員。 從 PersonGroupPerson 模型更新,可讓您將不同辨識模型的臉部新增至相同人員。 不過,識別作業只能比對使用相同的辨識模型取得的臉部。
DynamicPersonGroup 是輕量型數據結構,可讓您動態參考 PersonGroupPerson。 它不需要定型作業:一旦更新數據,就可以與識別 API 搭配使用。
您也可以針對識別作業使用 就地人員標識碼清單 。 這可讓您指定要從中識別的較窄群組。 您可以手動執行此動作,以改善大型群組中的識別效能。
上述數據結構可以一起使用。 例如:
- 在訪問控制系統中, PersonDirectory 可能代表公司的所有員工,但較小的 DynamicPersonGroup 可能只代表可存取大樓單層的員工。
- 在上架系統中, PersonDirectory 可以代表航空公司的所有客戶,但 DynamicPersonGroup 只代表特定航班上的乘客。 就地人員標識符清單可以代表最後一分鐘變更的乘客。
如需詳細資訊,請參閱 PersonDirectory 操作指南。
與尋找相似專案搭配使用的數據結構
與識別 API 不同,「尋找類似 API」的設計目的是要用於難以設定人員註冊的應用程式(例如,從影片分析擷取的臉部影像,或從相簿分析中擷取)。
FaceList
FaceList 代表保存臉部的一般清單。 它可以容納 1,000 張臉。
LargeFaceList
LargeFaceList 是更新版本,最多可容納 1,000,000 張臉部。
下一步
現在您已熟悉臉部數據結構,請在識別作業中撰寫使用這些結構的腳本。
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: