臉部辨識數據結構

本文說明臉部服務中用於臉部辨識作業的數據結構。這些數據結構會將數據保存在臉部和人員上。

警告

臉部辨識服務存取受限於資格和使用準則，以支援我們的「負責任的 AI 原則」。臉部辨識服務僅供 Microsoft 受管理的客戶和合作夥伴使用。請使用臉部辨識受理表單以申請存取。如需詳細資訊，請參閱臉部的有限存取權頁面。

與識別搭配使用的數據結構

臉部識別 API 會使用容器數據結構，以 Person 物件的形式保存臉部辨識數據。此容器有三種類型，從最舊到最新列出。我們建議您一律使用最新的。

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 代表保存臉部的一般清單。它可以容納 1,000 張臉。

LargeFaceList 是更新版本，最多可容納 1,000,000 張臉部。

現在您已熟悉臉部數據結構，請在識別作業中撰寫使用這些結構的腳本。