Face class
Face를 나타내는 클래스입니다.
생성자
Face(Face |
Face를 만듭니다. |
메서드
detect |
이미지에서 사람의 얼굴을 검색하고, 얼굴 사각형을 반환하고, 선택적으로 faceId, 랜드마크 및 특성을 함께 반환합니다.
|
detect |
|
detect |
|
detect |
이미지에서 사람의 얼굴을 검색하고, 얼굴 사각형을 반환하고, 선택적으로 faceId, 랜드마크 및 특성을 함께 반환합니다.
|
detect |
|
detect |
|
find |
쿼리 얼굴의 faceId에 따라 faceId 배열, 얼굴 목록 또는 대규모 얼굴 목록에서 유사한 모습의 얼굴을 검색합니다. faceId 배열에는 Face - Url을 사용하여 검색 또는 얼굴 - 스트림을 사용하여 검색에서 만든 얼굴이 포함되며, 생성 후 faceIdTimeToLive에 지정된 시간에 만료됩니다. "faceListId"는 FaceList - 만료되지 않는 persistedFaceIds를 포함하는 만들기에 의해 만들어집니다. 또한 "largeFaceListId"는 LargeFaceList - 만료되지 않는 persistedFaceId를 포함하는 만들기를 통해 만들어집니다. 입력에 따라 반환된 유사한 얼굴 목록에는 유사성에 따라 순위가 지정된 faceId 또는 persistedFaceIds가 포함됩니다.
|
find |
|
find |
|
group(string[], Request |
얼굴 유사성을 기준으로 후보 얼굴을 그룹으로 나눕니다.
|
group(string[], Request |
|
group(string[], Service |
|
identify(string[], Face |
일대다 식별을 통해 사람 그룹 또는 대규모 사람 그룹에서 특정 쿼리 사람 얼굴과 가장 가까운 일치를 찾습니다.
설명:
|
identify(string[], Face |
|
identify(string[], Service |
|
verify |
두 얼굴이 동일한 사람인지 또는 하나의 얼굴이 한 사람에게 속하는지 여부를 확인합니다.
|
verify |
|
verify |
|
verify |
두 얼굴이 같은 사람에 속하는지 확인합니다. 얼굴 ID와 사람 ID 비교 |
verify |
|
verify |
생성자 세부 정보
Face(FaceClientContext)
메서드 세부 정보
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)
이미지에서 사람의 얼굴을 검색하고, 얼굴 사각형을 반환하고, 선택적으로 faceId, 랜드마크 및 특성을 함께 반환합니다.
- 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 서버에 저장됩니다. faceId는 얼굴 기능의 식별자이며 얼굴 - 식별, 얼굴 - 확인 및 얼굴 - 유사 항목 찾기에서 사용됩니다. 저장된 얼굴 기능은 만료되고 원래 검색 호출 후 faceIdTimeToLive에 지정된 시간에 삭제됩니다.
- 선택적 매개 변수에는 faceId, 랜드마크 및 특성이 포함됩니다. 특성에는 연령, 성별, 헤드포즈, 미소, 페이셜헤어, 안경, 감정, 머리카락, 메이크업, 폐색, 액세서리, 흐림, 노출, 노이즈, 마스크 및 품질ForRecognition이 포함됩니다. 특정 특성에 대해 반환된 결과 중 일부는 매우 정확하지 않을 수 있습니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- 이미지에 대해 최대 100명의 얼굴을 반환할 수 있습니다. 얼굴은 얼굴 사각형 크기를 기준으로 큰 것부터 작은 것까지 순위가 매겨집니다.
- Face - 식별, 얼굴 - 확인 및 얼굴 - 유사 항목 찾기('returnFaceId'는 true)를 쿼리할 때 최적의 결과를 보려면 정면, 지우기 및 최소 크기가 200x200픽셀(눈 사이의 100픽셀)인 얼굴을 사용하세요.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
- 다른 'recognitionModel' 값이 제공됩니다. 확인, 식별, 유사 항목 찾기와 같은 후속 작업이 필요한 경우 'recognitionModel' 매개 변수를 사용하여 인식 모델을 지정하세요. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 지정되면 검색된 faceId가 지정된 인식 모델과 연결됩니다. 자세한 내용은 인식 모델 지정을 참조하세요.
function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>
매개 변수
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
반환
Promise<FaceDetectWithStreamResponse>
Promise<Models.FaceDetectWithStreamResponse>
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, options: FaceDetectWithStreamOptionalParams, callback: ServiceCallback<DetectedFace[]>)
매개 변수
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
- callback
콜백
detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, callback: ServiceCallback<DetectedFace[]>)
매개 변수
- image
- HttpRequestBody
이미지 스트림입니다.
- callback
콜백
detectWithUrl(string, FaceDetectWithUrlOptionalParams)
이미지에서 사람의 얼굴을 검색하고, 얼굴 사각형을 반환하고, 선택적으로 faceId, 랜드마크 및 특성을 함께 반환합니다.
이미지가 저장되지 않습니다. 추출된 얼굴 기능만 서버에 저장됩니다. faceId는 얼굴 기능의 식별자이며 얼굴 - 식별, 얼굴 - 확인 및 얼굴 - 유사 항목 찾기에서 사용됩니다. 저장된 얼굴 기능은 만료되고 원래 검색 호출 후 faceIdTimeToLive에 지정된 시간에 삭제됩니다.
선택적 매개 변수에는 faceId, 랜드마크 및 특성이 포함됩니다. 특성에는 연령, 성별, 헤드포즈, 미소, 페이셜헤어, 안경, 감정, 머리카락, 메이크업, 폐색, 액세서리, 흐림, 노출, 노이즈, 마스크 및 품질ForRecognition이 포함됩니다. 특정 특성에 대해 반환된 결과 중 일부는 매우 정확하지 않을 수 있습니다.
JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
이미지에 대해 최대 100명의 얼굴을 반환할 수 있습니다. 얼굴은 얼굴 사각형 크기를 기준으로 큰 것부터 작은 것까지 순위가 매겨집니다.
Face - 식별, 얼굴 - 확인 및 얼굴 - 유사 항목 찾기('returnFaceId'는 true)를 쿼리할 때 최적의 결과를 보려면 정면, 지우기 및 최소 크기가 200x200픽셀(눈 사이의 100픽셀)인 얼굴을 사용하세요.
감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
다른 'recognitionModel' 값이 제공됩니다. 확인, 식별, 유사 항목 찾기와 같은 후속 작업이 필요한 경우 'recognitionModel' 매개 변수를 사용하여 인식 모델을 지정하세요. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 지정되면 검색된 faceId가 지정된 인식 모델과 연결됩니다. 자세한 내용은 인식 모델 지정을 참조하세요.
function detectWithUrl(url: string, options?: FaceDetectWithUrlOptionalParams): Promise<FaceDetectWithUrlResponse>
매개 변수
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
- options
- FaceDetectWithUrlOptionalParams
선택적 매개 변수
반환
Promise<FaceDetectWithUrlResponse>
Promise<Models.FaceDetectWithUrlResponse>
detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, options: FaceDetectWithUrlOptionalParams, callback: ServiceCallback<DetectedFace[]>)
매개 변수
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
- options
- FaceDetectWithUrlOptionalParams
선택적 매개 변수
- callback
콜백
detectWithUrl(string, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, callback: ServiceCallback<DetectedFace[]>)
매개 변수
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
- callback
콜백
findSimilar(string, FaceFindSimilarOptionalParams)
쿼리 얼굴의 faceId에 따라 faceId 배열, 얼굴 목록 또는 대규모 얼굴 목록에서 유사한 모습의 얼굴을 검색합니다. faceId 배열에는 Face - Url을 사용하여 검색 또는 얼굴 - 스트림을 사용하여 검색에서 만든 얼굴이 포함되며, 생성 후 faceIdTimeToLive에 지정된 시간에 만료됩니다. "faceListId"는 FaceList - 만료되지 않는 persistedFaceIds를 포함하는 만들기에 의해 만들어집니다. 또한 "largeFaceListId"는 LargeFaceList - 만료되지 않는 persistedFaceId를 포함하는 만들기를 통해 만들어집니다. 입력에 따라 반환된 유사한 얼굴 목록에는 유사성에 따라 순위가 지정된 faceId 또는 persistedFaceIds가 포함됩니다.
유사 항목 찾기에는 "matchPerson" 및 "matchFace"라는 두 가지 작업 모드가 있습니다. "matchPerson"은 내부 동일인 임계값을 사용하여 가능한 한 동일한 사람의 얼굴을 찾으려고 시도하는 기본 모드입니다. 알려진 사람의 다른 사진을 찾는 것이 유용합니다. 내부 임계값을 통과하는 얼굴이 없으면 빈 목록이 반환됩니다. "matchFace" 모드는 동일한 사람 임계값을 무시하고 유사성이 낮더라도 순위가 비슷한 얼굴을 반환합니다. 유명인의 얼굴을 검색하는 것과 같은 경우에 사용할 수 있습니다.
쿼리 얼굴의 faceId와 연결된 'recognitionModel'은 대상 faceId 배열, 얼굴 목록 또는 큰 얼굴 목록에서 사용하는 'recognitionModel'과 동일해야 합니다.
function findSimilar(faceId: string, options?: FaceFindSimilarOptionalParams): Promise<FaceFindSimilarResponse>
매개 변수
- faceId
-
string
쿼리 얼굴의 FaceId입니다. 사용자가 Face - Detect를 먼저 호출하여 유효한 faceId를 가져와야 합니다. 이 faceId는 유지되지 않으며 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.
- options
- FaceFindSimilarOptionalParams
선택적 매개 변수
반환
Promise<FaceFindSimilarResponse>
Promise<Models.FaceFindSimilarResponse>
findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, options: FaceFindSimilarOptionalParams, callback: ServiceCallback<SimilarFace[]>)
매개 변수
- faceId
-
string
쿼리 얼굴의 FaceId입니다. 사용자가 Face - Detect를 먼저 호출하여 유효한 faceId를 가져와야 합니다. 이 faceId는 유지되지 않으며 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.
- options
- FaceFindSimilarOptionalParams
선택적 매개 변수
- callback
콜백
findSimilar(string, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, callback: ServiceCallback<SimilarFace[]>)
매개 변수
- faceId
-
string
쿼리 얼굴의 FaceId입니다. 사용자가 Face - Detect를 먼저 호출하여 유효한 faceId를 가져와야 합니다. 이 faceId는 유지되지 않으며 검색 호출 후 faceIdTimeToLive에 지정된 시간에 만료됩니다.
- callback
콜백
group(string[], RequestOptionsBase)
얼굴 유사성을 기준으로 후보 얼굴을 그룹으로 나눕니다.
- 출력은 하나 이상의 연결되지 않은 얼굴 그룹 및 messyGroup입니다. 얼굴 그룹에는 비슷한 얼굴을 가진 얼굴(종종 같은 사람)이 포함됩니다. 얼굴 그룹은 그룹 크기(예: 얼굴 수)에 따라 순위가 매겨집니다. 동일한 사람에 속한 얼굴이 결과의 여러 그룹으로 분할될 수 있습니다.
- MessyGroup은 원래 얼굴에서 비슷한 얼굴을 찾을 수 없는 얼굴을 포함하는 특별한 얼굴 그룹입니다. 모든 얼굴이 해당 얼굴을 찾은 경우 messyGroup은 결과에 나타나지 않습니다.
- 그룹 API에는 최소 2명의 후보 얼굴과 1,000명 이상의 후보가 필요합니다. 얼굴 - 2명의 후보 얼굴만 있는 경우 를 확인하는 것이 좋습니다.
- 쿼리 얼굴의 faceId와 연결된 'recognitionModel'은 동일해야 합니다.
function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 후보 faceId의 배열입니다. 최대 얼굴은 1,000자입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<FaceGroupResponse>
Promise<Models.FaceGroupResponse>
group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)
function group(faceIds: string[], options: RequestOptionsBase, callback: ServiceCallback<GroupResult>)
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 후보 faceId의 배열입니다. 최대 얼굴은 1,000자입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
콜백
group(string[], ServiceCallback<GroupResult>)
function group(faceIds: string[], callback: ServiceCallback<GroupResult>)
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 후보 faceId의 배열입니다. 최대 얼굴은 1,000자입니다.
- callback
콜백
identify(string[], FaceIdentifyOptionalParams)
일대다 식별을 통해 사람 그룹 또는 대규모 사람 그룹에서 특정 쿼리 사람 얼굴과 가장 가까운 일치를 찾습니다.
faceIds 배열의 각 얼굴에 대해 Face Identify는 쿼리 얼굴과 사람 그룹의 모든 얼굴(personGroupId로 제공) 또는 큰 사람 그룹(largePersonGroupId에서 제공됨)의 모든 얼굴 간의 유사성을 계산하고 유사성 신뢰도에 따라 순위가 지정된 해당 얼굴에 대해 후보 인물을 반환합니다. 개인 그룹/큰 사람 그룹을 학습하여 식별할 수 있도록 해야 합니다. 자세한 내용은 PersonGroup - 학습 및 LargePersonGroup - 학습을 참조하세요.
설명:
- 알고리즘을 사용하면 동일한 요청에서 두 개 이상의 얼굴을 독립적으로 식별할 수 있지만 10개 이하의 얼굴을 식별할 수 있습니다.
- 사람 그룹/큰 사람 그룹의 각 사람은 두 개 이상의 얼굴을 가질 수 있지만 248개 이하의 얼굴을 가질 수 있습니다.
- 얼굴 이미지 품질이 높을수록 식별 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- 반환되는 후보 수는 maxNumOfCandidatesReturned 및 confidenceThreshold에 의해 제한됩니다. 식별된 사람이 없으면 반환된 후보는 빈 배열이 됩니다.
- 얼굴 시도 - 사람 그룹/큰 사람 그룹 대신 얼굴 목록/큰 얼굴 목록에서 비슷한 얼굴을 찾아야 할 때 유사 항목 찾기 를 시도합니다.
- 쿼리 얼굴의 faceId와 연결된 'recognitionModel'은 대상 사용자 그룹 또는 큰 사람 그룹에서 사용하는 'recognitionModel'과 동일해야 합니다.
function identify(faceIds: string[], options?: FaceIdentifyOptionalParams): Promise<FaceIdentifyResponse>
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 쿼리 얼굴 faceId의 배열입니다. 각 얼굴은 독립적으로 식별됩니다. 유효한 faceId 수는 [1, 10] 사이입니다.
- options
- FaceIdentifyOptionalParams
선택적 매개 변수
반환
Promise<FaceIdentifyResponse>
Promise<Models.FaceIdentifyResponse>
identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], options: FaceIdentifyOptionalParams, callback: ServiceCallback<IdentifyResult[]>)
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 쿼리 얼굴 faceId의 배열입니다. 각 얼굴은 독립적으로 식별됩니다. 유효한 faceId 수는 [1, 10] 사이입니다.
- options
- FaceIdentifyOptionalParams
선택적 매개 변수
- callback
콜백
identify(string[], ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], callback: ServiceCallback<IdentifyResult[]>)
매개 변수
- faceIds
-
string[]
Face - Detect에서 만든 쿼리 얼굴 faceId의 배열입니다. 각 얼굴은 독립적으로 식별됩니다. 유효한 faceId 수는 [1, 10] 사이입니다.
- callback
콜백
verifyFaceToFace(string, string, RequestOptionsBase)
두 얼굴이 동일한 사람인지 또는 하나의 얼굴이 한 사람에게 속하는지 여부를 확인합니다.
설명:
- 얼굴 이미지 품질이 높을수록 식별 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- 정확도에 민감한 시나리오의 경우 직접 판단하세요.
- 쿼리 얼굴과 연결된 'recognitionModel' faceId는 대상 얼굴, 사람 그룹 또는 큰 사람 그룹에서 사용하는 'recognitionModel'과 동일해야 합니다.
function verifyFaceToFace(faceId1: string, faceId2: string, options?: RequestOptionsBase): Promise<FaceVerifyFaceToFaceResponse>
매개 변수
- faceId1
-
string
첫 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- faceId2
-
string
두 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<FaceVerifyFaceToFaceResponse>
Promise<Models.FaceVerifyFaceToFaceResponse>
verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, options: RequestOptionsBase, callback: ServiceCallback<VerifyResult>)
매개 변수
- faceId1
-
string
첫 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- faceId2
-
string
두 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- options
- RequestOptionsBase
선택적 매개 변수
- callback
콜백
verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, callback: ServiceCallback<VerifyResult>)
매개 변수
- faceId1
-
string
첫 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- faceId2
-
string
두 번째 얼굴의 FaceId, 얼굴에서 제공 - 감지
- callback
콜백
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)
두 얼굴이 같은 사람에 속하는지 확인합니다. 얼굴 ID와 사람 ID 비교
function verifyFaceToPerson(faceId: string, personId: string, options?: FaceVerifyFaceToPersonOptionalParams): Promise<FaceVerifyFaceToPersonResponse>
매개 변수
- faceId
-
string
얼굴의 FaceId, 얼굴에서 제공 - 감지
- personId
-
string
사람 그룹 또는 큰 사람 그룹에 특정 사용자를 지정합니다. personId는 PersonGroup Person - Create 또는 LargePersonGroup Person - Create에서 만들어집니다.
선택적 매개 변수
반환
Promise<FaceVerifyFaceToPersonResponse>
Promise<Models.FaceVerifyFaceToPersonResponse>
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, options: FaceVerifyFaceToPersonOptionalParams, callback: ServiceCallback<VerifyResult>)
매개 변수
- faceId
-
string
얼굴의 FaceId, 얼굴에서 제공 - 감지
- personId
-
string
사람 그룹 또는 큰 사람 그룹에 특정 사용자를 지정합니다. personId는 PersonGroup Person - Create 또는 LargePersonGroup Person - Create에서 만들어집니다.
선택적 매개 변수
- callback
콜백
verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, callback: ServiceCallback<VerifyResult>)
매개 변수
- faceId
-
string
얼굴의 FaceId, 얼굴에서 제공 - 감지
- personId
-
string
사람 그룹 또는 큰 사람 그룹에 특정 사용자를 지정합니다. personId는 PersonGroup Person - Create 또는 LargePersonGroup Person - Create에서 만들어집니다.
- callback
콜백