Face List Operations - Add Face List Face

지정된 얼굴 목록에 최대 1,000개의 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 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}/facelists/{faceListId}/persistedfaces

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&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 to FaceList

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&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

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