Large Person Group Person - Add Face From Url

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

  • 얼굴 이미지 품질이 높을수록 인식 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 전면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
  • 각 사람 입장은 최대 248개의 얼굴을 보유할 수 있습니다.
  • JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
  • "targetFace" 사각형은 하나의 얼굴을 포함해야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face에서 반환되지 않는 경우 - 감지하면 얼굴을 감지하고 성공적으로 추가할 수 있습니다.
  • 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
  • 같은 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다. 다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.
  • 감지 가능한 최소 얼굴 크기는 1920x1080 픽셀 이하의 이미지에서 36x36 픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
  • 다른 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI 매개 변수

Name In Required Type Description
Endpoint
path True
  • string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

특정 대규모 사용자 그룹을 참조하는 ID입니다.

Regex pattern: ^[a-z0-9-_]+$

personId
path True
  • string
uuid

특정 사용자를 참조하는 ID입니다.

detectionModel
query

검색 모델의 이름입니다. 검색 모델은 제출된 이미지에서 얼굴을 감지하는 데 사용됩니다. 얼굴 감지 또는 (큰)FaceList - 얼굴 추가 또는 (큰) PersonGroup - 얼굴 추가를 수행할 때 검색 모델 이름을 제공할 수 있습니다. 기본값은 'detection_01'입니다. 다른 모델이 필요한 경우 명시적으로 지정하세요.

targetFace
query
  • array

"targetFace=left,top,width,height" 형식으로 사람에게 추가할 대상 얼굴을 지정하는 얼굴 사각형입니다. 예: "targetFace=10,10,100,100". 이미지에 얼굴이 두 개 이상 있는 경우 추가할 얼굴을 지정하려면 targetFace가 필요합니다. targetFace가 없음은 전체 이미지에서 감지된 얼굴이 하나만 있음을 의미합니다.

userData
query
  • string

모든 용도로 얼굴에 대한 사용자 지정 데이터입니다. 최대 길이는 1KB입니다.

요청 헤더

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

요청 본문

Name Required Type Description
url True
  • string

이미지의 공개적으로 연결할 수 있는 URL

응답

Name Type Description
200 OK

호출이 성공하면 새 persistedFaceId가 반환됩니다.

Other Status Codes

오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

예제

Add Person face example

Sample Request

POST {Endpoint}/face/v1.0/largepersongroups/abc/persons/4caa25ee-3bc6-4e88-adf8-12455ce7aab0/persistedfaces?userData={customized User data}&targetFace=10,10,100,100&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Sample Response

{
  "persistedFaceId": "6e04c175-219e-42a2-9d26-0e7b790e1ef4"
}

정의

APIError

API에서 반환된 오류 정보

DetectionModel

검색 모델의 이름입니다. 검색 모델은 제출된 이미지에서 얼굴을 감지하는 데 사용됩니다. 얼굴 감지 또는 (큰)FaceList - 얼굴 추가 또는 (큰) PersonGroup - 얼굴 추가를 수행할 때 검색 모델 이름을 제공할 수 있습니다. 기본값은 'detection_01'입니다. 다른 모델이 필요한 경우 명시적으로 지정하세요.

Error

오류 본문입니다.

ImageUrl
PersistedFace

PersonFace 개체입니다.

APIError

API에서 반환된 오류 정보

Name Type Description
error

오류 본문입니다.

DetectionModel

검색 모델의 이름입니다. 검색 모델은 제출된 이미지에서 얼굴을 감지하는 데 사용됩니다. 얼굴 감지 또는 (큰)FaceList - 얼굴 추가 또는 (큰) PersonGroup - 얼굴 추가를 수행할 때 검색 모델 이름을 제공할 수 있습니다. 기본값은 'detection_01'입니다. 다른 모델이 필요한 경우 명시적으로 지정하세요.

Name Type Description
detection_01
  • string
detection_02
  • string
detection_03
  • string

Error

오류 본문입니다.

Name Type Description
code
  • string
message
  • string

ImageUrl

Name Type Description
url
  • string

이미지의 공개적으로 연결할 수 있는 URL

PersistedFace

PersonFace 개체입니다.

Name Type Description
persistedFaceId
  • string

지속되고 만료되지 않는 대상 얼굴의 persistedFaceId입니다. Face에서 만든 faceId와 다릅니다. 감지 및 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.

userData
  • string

얼굴에 연결된 사용자 제공 데이터입니다. 크기 제한은 1KB입니다.