Face Recognition Operations - Group

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

얼굴 유사성에 따라 후보 얼굴을 그룹으로 나눕니다.

• • 출력은 하나 이상의 연결되지 않은 얼굴 그룹과 messyGroup입니다. 얼굴 그룹에는 비슷한 모양의 얼굴이 포함되어 있으며, 종종 같은 사람이 보입니다. 얼굴 그룹은 그룹 크기(예: 얼굴 수)에 따라 순위가 매겨집니다. 동일한 사람에게 속한 얼굴은 결과에서 여러 그룹으로 분할될 수 있습니다.
  • MessyGroup은 원래 얼굴에서 비슷한 얼굴을 찾을 수 없는 얼굴을 포함하는 특별한 얼굴 그룹입니다. 모든 얼굴이 해당 얼굴을 찾은 경우 messyGroup은 결과에 나타나지 않습니다.
  • 그룹 API에는 최소 2명의 후보 얼굴과 1000명 이상이 필요합니다. 2명의 후보 얼굴만 있는 경우 "얼굴을 맞대고 확인"을 시도하는 것이 좋습니다.
  • 쿼리 얼굴의 faceId와 연결된 'recognitionModel'은 동일해야 합니다.

POST {endpoint}/face/{apiVersion}/group

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).

요청 본문

Name	필수	형식	Description
faceIds	True	string[]	"Detect"에서 만든 후보 faceId의 배열입니다. 최대 얼굴은 1000입니다.

응답

Name	형식	Description
200 OK	GroupingResult	성공적인 호출은 하나 이상의 유사한 얼굴 그룹(그룹 크기별 순위)과 지저분한 그룹을 반환합니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

Name	Description
https://cognitiveservices.azure.com/.default

예제

Group Face IDs

샘플 요청

HTTP

POST {endpoint}/face/v1.2-preview.1/group

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

샘플 응답

상태 코드:

200

{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
GroupingResult	그룹 얼굴 작업에 대한 응답 본문입니다.

FaceError

오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	FaceError	오류 개체입니다.

GroupingResult

그룹 얼굴 작업에 대한 응답 본문입니다.

Name	형식	Description
groups	string[]	얼굴 유사성을 기반으로 하는 원래 얼굴의 파티션입니다. 그룹은 얼굴 수별로 순위가 매겨집니다.
messyGroup	string[]	원래 얼굴에서 유사한 얼굴을 찾을 수 없는 얼굴의 얼굴 ID 배열입니다.