次の方法で共有


Person Directory Operations - Get Person Face

人物の顔の情報を取得します。 永続化された人物の顔は、その personId によって指定されます。 recognitionModel、および persistedFaceId。

GET {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}

URI パラメーター

名前 / 必須 説明
apiVersion
path True

string

API バージョン

endpoint
path True

string

uri

サポートされている Cognitive Services エンドポイント (プロトコルとホスト名(例: https://{resource-name}.cognitiveservices.azure.com)。

persistedFaceId
path True

string

uuid

顔の顔 ID。

personId
path True

string

uuid

ユーザーのユーザー ID。

recognitionModel
path True

RecognitionModel

顔に関連付けられている 'recognitionModel'。

応答

名前 説明
200 OK

PersonDirectoryFace

呼び出しが成功すると、ターゲットの永続化された顔の情報 (persistedFaceId と userData) が返されます。

Other Status Codes

FaceErrorResponse

予期しないエラー応答。

Headers

x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

Azure AI Face サブスクリプションの秘密鍵。

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

名前 説明
https://cognitiveservices.azure.com/.default

Get Face from PersonDirectory Person

Sample Request

GET {endpoint}/face/v1.1-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Sample Response

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

定義

名前 説明
FaceError

error オブジェクト。 Face Service によって返されるエラー コードとメッセージの包括的な詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages

FaceErrorResponse

エラーの詳細を含む応答。

PersonDirectoryFace

人物ディレクトリユーザーの Face リソース。

RecognitionModel

顔の認識モデル。

FaceError

error オブジェクト。 Face Service によって返されるエラー コードとメッセージの包括的な詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

message

string

エラーの人間が判読できる表現。

FaceErrorResponse

エラーの詳細を含む応答。

名前 説明
error

FaceError

error オブジェクト。

PersonDirectoryFace

人物ディレクトリユーザーの Face リソース。

名前 説明
persistedFaceId

string

顔の顔 ID。

userData

string

顔にアタッチされたユーザー指定のデータ。 長さの制限は 1K です。

RecognitionModel

顔の認識モデル。

名前 説明
recognition_01

string

"検出" の既定の認識モデル。 2019 年 3 月より前に作成されたすべての faceId は、この認識モデルと結び付いています。

recognition_02

string

2019 年 3 月にリリースされた認識モデル。

recognition_03

string

2020 年 5 月にリリースされた認識モデル。

recognition_04

string

2021 年 2 月にリリースされた認識モデル。 認識精度を向上させるには、この認識モデルを使用することをお勧めします。