Face Recognition Operations - Identify From Person Group

참조

서비스:: Azure AI Services

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

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

메모

- 이 알고리즘을 사용하면 동일한 요청에서 두 개 이상의 얼굴을 독립적으로 식별할 수 있지만 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] 사이입니다.
personGroupId	True	string	"사용자 그룹 만들기"에서 만든 대상 개인 그룹의 personGroupId입니다. 매개 변수 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 PersonGroup

샘플 요청

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_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 Person Group

URI 매개 변수

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

AADToken

범위

예제

Identify from PersonGroup

샘플 요청

샘플 응답

정의

FaceError

FaceErrorResponse

IdentificationCandidate

IdentificationResult

추가 리소스