Person Group Operations - Add Large Person Group Person Face

얼굴 식별 또는 확인을 위해 큰 사람 그룹에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. "큰 사람 그룹 사람 얼굴 삭제", "큰 사람 그룹 사람 삭제" 또는 "큰 사람 그룹 삭제"가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.

persistedFaceId는 "Detect"에서 생성된 faceId와 다릅니다.

• • 얼굴 이미지 품질이 높을수록 인식 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 전면, 투명 및 얼굴 크기는 200x200 픽셀(눈 사이의 100픽셀) 이상입니다.
  • 각 사람 항목은 최대 248개의 얼굴을 보유할 수 있습니다.
  • JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
  • "targetFace" 사각형은 하나의 얼굴을 포함해야 합니다. 0개 또는 여러 얼굴이 오류로 간주됩니다. 제공된 "targetFace" 사각형이 "Detect"에서 반환되지 않는 경우 얼굴을 감지하고 성공적으로 추가할 수 있습니다.
  • 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
  • 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
  • 다른 'detectionModel' 값을 제공할 수 있습니다. 다른 검색 모델을 사용하고 비교하려면 https://zcusa.951200.xyz/azure/ai-services/computer-vision/how-to/specify-detection-model 참조하세요.

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?_overload=addLargePersonGroupPersonFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

URI 매개 변수

요청 본문

Media Types: "application/octet-stream"

응답

보안

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

범위

예제

Add Face in LargePersonGroup Person

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?_overload=addLargePersonGroupPersonFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

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

정의

AddFaceResult

얼굴을 추가하기 위한 응답 본문입니다.

DetectionModel

검색된 faceId와 연결된 'detectionModel'입니다. 지원되는 'detectionModel' 값에는 'detection_01', 'detection_02' 및 'detection_03'이 포함됩니다. 기본값은 'detection_01'입니다.

FaceError

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

FaceErrorResponse

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