Face Recognition Operations - Identify From Large Person Group

참조

서비스:: Azure AI Services

API 버전:: v1.2-preview.1

큰 사람 그룹에서 특정 쿼리 사용자 얼굴의 가장 가까운 일치 항목을 찾기 위한 1대 다 식별입니다.
Face Identify는 faceIds 배열의 각 얼굴에 대해 쿼리 얼굴과 큰 사람 그룹(largePersonGroupId에서 제공)의 모든 얼굴 간의 유사성을 계산하고 유사성 신뢰도에 따라 순위가 지정된 해당 얼굴에 대해 후보 사용자를 반환합니다. 큰 사람 그룹을 식별할 수 있도록 학습해야 합니다. "대규모 사용자 그룹 학습"에서 자세히 알아보세요.

메모

- 이 알고리즘을 사용하면 동일한 요청에서 두 개 이상의 얼굴을 독립적으로 식별할 수 있지만 10개 이하의 얼굴을 식별할 수 있습니다.
- 각 사람은 두 개 이상의 얼굴을 가질 수 있지만, 248 얼굴을 초과하지 않습니다.
- 얼굴 이미지 품질이 높을수록 식별 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 전면, 투명 및 얼굴 크기는 200x200 픽셀(눈 사이의 100픽셀) 이상입니다.
- 반환되는 후보 수는 maxNumOfCandidatesReturned 및 confidenceThreshold에 의해 제한됩니다. 식별된 사람이 없으면 반환된 후보는 빈 배열이 됩니다.
- 인물 그룹/큰 사람 그룹 대신 얼굴 목록/큰 얼굴 목록에서 비슷한 얼굴을 찾아야 하는 경우 "유사 항목 찾기"를 시도합니다.
- 쿼리 얼굴의 faceId와 연결된 'recognitionModel'은 대상 개인 그룹 또는 큰 사람 그룹에서 사용하는 'recognitionModel'과 동일해야 합니다.

POST {endpoint}/face/{apiVersion}/identify

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의 배열입니다. 각 얼굴은 독립적으로 식별됩니다. 유효한 faceId 수는 [1, 10] 사이입니다.
largePersonGroupId	True	string	"큰 사람 그룹 만들기"에서 만든 대상 큰 사람 그룹의 largePersonGroupId입니다. 매개 변수 personGroupId 및 largePersonGroupId는 동시에 제공되지 않아야 합니다.
confidenceThreshold		number	[0, 1] 범위의 사용자 지정된 ID 신뢰도 임계값입니다. 고급 사용자는 시나리오 데이터의 정밀도를 높이기 위해 이 값을 조정하여 기본 내부 임계값을 재정의할 수 있습니다. 이 임계값이 다른 데이터 및 알고리즘 업데이트 후에 작동할 수 있다는 보장은 없습니다.
maxNumOfCandidatesReturned		integer	maxNumOfCandidatesReturned 범위는 1에서 100 사이입니다. 기본값은 10입니다.

응답

Name	형식	Description
200 OK	IdentificationResult[]	성공한 호출은 각 쿼리 얼굴에 대해 식별된 후보 사용자를 반환합니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

IdentificationResult[]

성공한 호출은 각 쿼리 얼굴에 대해 식별된 후보 사용자를 반환합니다.

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

예제

Identify from LargePersonGroup

샘플 요청

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "largePersonGroupId": "your_large_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

샘플 응답

상태 코드:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
IdentificationCandidate	식별 통화 후보입니다.
IdentificationResult	결과를 식별합니다.

FaceError

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

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

FaceErrorResponse

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

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

IdentificationCandidate

식별 통화 후보입니다.

Name	형식	Description
confidence	number	후보자의 신뢰도 값입니다. 신뢰도가 높을수록 더 비슷합니다. [0,1] 사이의 범위입니다.
personId	string	personId of Candidate person.

IdentificationResult

결과를 식별합니다.

Name	형식	Description
candidates	IdentificationCandidate[]	해당 얼굴의 식별된 사람 후보(신뢰도에 따라 순위 매기기). 배열 크기는 입력 maxNumOfCandidatesReturned보다 크지 않아야 합니다. 식별된 사람이 없으면 빈 배열을 반환합니다.
faceId	string	쿼리 얼굴의 faceId입니다.

다음을 통해 공유

Face Recognition Operations - Identify From Large Person Group

URI 매개 변수

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

AADToken

범위

예제

Identify from LargePersonGroup

샘플 요청

샘플 응답

정의

FaceError

FaceErrorResponse

IdentificationCandidate

IdentificationResult

추가 리소스