Face Recognition Operations - Identify From Large Person Group

참조

Service:: Azure AI Services

API Version:: v1.1-preview.1

큰 사람 그룹에서 특정 쿼리 사용자 얼굴의 가장 가까운 일치 항목을 찾기 위한 1대 다 식별입니다.
faceIds 배열의 각 얼굴에 대해 Face Identify는 쿼리 얼굴과 큰 사람 그룹(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[]	쿼리 얼굴의 배열은 "검색"에 의해 만들어진 faceIds입니다. 각 얼굴은 독립적으로 식별됩니다. 유효한 faceId 수는 [1, 10] 사이입니다.
largePersonGroupId	True	string	"Create 큰 사람 그룹"에서 만든 대상 큰 사람 그룹의 largePersonGroupId입니다. personGroupId 및 largePersonGroupId 매개 변수를 동시에 제공하면 안 됩니다.
confidenceThreshold		number	[0, 1] 범위의 사용자 지정된 식별 신뢰도 임계값입니다. 고급 사용자는 시나리오 데이터의 정밀도를 높이기 위해 기본 내부 임계값을 재정의하도록 이 값을 조정할 수 있습니다. 이 임계값이 다른 데이터와 알고리즘 업데이트 후에 작동한다고 보장할 수 없습니다.
maxNumOfCandidatesReturned		integer	maxNumOfCandidatesReturned 범위는 1에서 100 사이입니다. 기본값은 10입니다.

응답

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

Name

형식

Description

200 OK

IdentificationResult[]

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

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

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

예제

Identify from LargePersonGroup

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

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

정의

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

FaceError

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

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

FaceErrorResponse

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

Name	형식	Description
error	FaceError	Error 개체.

IdentificationCandidate

식별 통화 후보입니다.

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

IdentificationResult

결과를 식별합니다.

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

다음을 통해 공유

Face Recognition Operations - Identify From Large Person Group

URI 매개 변수

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

AADToken

Scopes

예제

Identify from LargePersonGroup

Sample Request

Sample Response

정의

FaceError

FaceErrorResponse

IdentificationCandidate

IdentificationResult

추가 리소스