얼굴 API
Microsoft Cognitive Services Face API를 사용하면 사진에서 얼굴을 감지, 식별, 분석, 구성 및 태그 지정할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 모든 Power Automate 지역 |
| 논리 앱 | 스탠다드 | 모든 Logic Apps 지역 |
| Power Apps | 스탠다드 | 모든 Power Apps 지역 |
| Power Automate | 스탠다드 | 모든 Power Automate 지역 |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://azure.microsoft.com/services/cognitive-services/face/ |
이 통합을 사용하려면 Azure Portal에서 Cognitive Service 리소스 가 필요합니다. 애플리케이션을 인증하기 위한 엔드포인트와 키를 얻게 됩니다. 연결을 만들려면 계정 키, 사이트 URL을 제공하고 연결 만들기를 선택합니다. 연결에 대한 작업 비용은 여기에서 자세히 알아보세요.
이제 이 통합을 사용할 준비가 되었습니다.
Microsoft Entra ID로 연결
Microsoft Entra ID를 사용하여 연결을 만들려면 액세스할 계정에 Cognitive Services 사용자 역할을 추가해야 합니다. 이 연결을 사용하려면 Cognitive Services 리소스와 연결된 고유한 하위 도메인을 지원 작업에 입력해야 합니다.
Microsoft Entra ID 인증에서 지원되지 않는 작업
Microsoft Entra ID 인증을 사용하는 경우 V2 작업만 지원됩니다. 사용되지 않는 작업은 인증에서 Access Key 계속 작동하지만 Microsoft Entra ID 연결과 함께 사용하면 실패합니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| API 키 | API 키 | 모든 지역 | 공유 가능 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
API 키
인증 ID: keyBasedAuth
적용 가능: 모든 지역
API 키
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 계정 키 | 시큐어스트링 (보안 문자열) | Cognitive Services 계정 키 | |
| 사이트 URL | 문자열 | 루트 사이트 URL(예: https://westus.api.cognitive.microsoft.com) |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | API 키 | 진실 |
| 사이트 URL | 문자열 | 루트 사이트 URL(예: https://westus.api.cognitive.microsoft.com ). 지정하지 않은 경우 사이트 URL은 기본값이 ''https://westus.api.cognitive.microsoft.com입니다. |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 1200 | 60초 |
동작
| 개인 그룹 가져오기 |
이름 및 userData를 포함하여 개인 그룹의 정보를 검색합니다. |
| 개인 그룹 가져오기(V2) |
이름 및 userData를 포함하여 개인 그룹의 정보를 검색합니다. |
| 개인 그룹 만들기 |
지정된 personGroupId, 이름 및 사용자가 제공한 userData를 사용하여 새 사람 그룹을 만듭니다. |
| 개인 그룹 만들기(V2) |
지정된 personGroupId, 이름 및 사용자가 제공한 userData를 사용하여 새 사람 그룹을 만듭니다. |
| 사람 가져오기 |
등록된 지속형 얼굴, 이름 및 userData를 포함하여 사용자의 정보를 검색합니다. |
| 사람 가져오기(V2) |
등록된 지속형 얼굴, 이름 및 userData를 포함하여 사용자의 정보를 검색합니다. |
| 사람 얼굴 가져오기 |
persistedFaceId, personId 및 해당 소속 personGroupId로 지정된 지속형 얼굴에 대한 정보를 검색합니다. |
| 사람 얼굴 가져오기(V2) |
persistedFaceId, personId 및 해당 소속 personGroupId로 지정된 지속형 얼굴에 대한 정보를 검색합니다. |
| 사람 얼굴 추가 |
식별을 위해 담당자에게 대표 얼굴을 추가합니다. |
| 사람 얼굴 추가(V2) |
식별을 위해 담당자에게 대표 얼굴을 추가합니다. |
| 사용자 만들기 |
지정된 사용자 그룹에 새 사용자를 만듭니다. |
| 사용자 만들기(V2) |
지정된 사용자 그룹에 새 사용자를 만듭니다. |
| 얼굴 감지 |
이미지에서 사람의 얼굴을 감지하고 얼굴 위치를 반환하고 필요에 따라 faceId, 랜드마크 및 특성을 반환합니다. |
| 얼굴 감지(V2) |
이미지에서 사람의 얼굴을 감지하고 얼굴 위치를 반환하고 필요에 따라 faceId, 랜드마크 및 특성을 반환합니다. |
| 얼굴 목록 가져오기 |
얼굴 목록의 faceListId, 이름, userData 및 얼굴을 비롯한 얼굴 목록의 정보를 검색합니다. |
| 얼굴 목록 가져오기(V2) |
얼굴 목록의 faceListId, 이름, userData 및 얼굴을 비롯한 얼굴 목록의 정보를 검색합니다. |
| 얼굴 목록 만들기 |
사용자 지정 faceListId, 이름 및 선택적 userData를 사용하여 빈 얼굴 목록을 만듭니다. |
| 얼굴 목록 만들기(V2) |
사용자 지정 faceListId, 이름 및 선택적 userData를 사용하여 빈 얼굴 목록을 만듭니다. |
| 얼굴 목록 추가(V2) |
얼굴 목록에 얼굴을 추가합니다. |
| 얼굴에 얼굴 목록 추가 |
얼굴 목록에 얼굴을 추가합니다. |
| 얼굴에서 사람 찾기 |
두 얼굴이 같은 사람에 속하는지 또는 한 얼굴이 사람에 속하는지 확인합니다. |
| 얼굴에서 사람 찾기(V2) |
두 얼굴이 같은 사람에 속하는지 또는 한 얼굴이 사람에 속하는지 확인합니다. |
개인 그룹 가져오기
이름 및 userData를 포함하여 개인 그룹의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자 그룹 ID입니다. |
반환
개인 그룹 가져오기(V2)
이름 및 userData를 포함하여 개인 그룹의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자 그룹 ID입니다. |
반환
개인 그룹 만들기
지정된 personGroupId, 이름 및 사용자가 제공한 userData를 사용하여 새 사람 그룹을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
새 개인 그룹 ID(유효한 문자에는 숫자, 소문자의 영어 문자, '-' 및 '_'가 포함됨) |
|
이름
|
name | True | string |
개인 그룹 표시 이름입니다. 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
사용자 그룹에 연결된 사용자가 제공한 데이터입니다. 크기 제한은 16KB입니다. |
개인 그룹 만들기(V2)
지정된 personGroupId, 이름 및 사용자가 제공한 userData를 사용하여 새 사람 그룹을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
새 개인 그룹 ID(유효한 문자에는 숫자, 소문자의 영어 문자, '-' 및 '_'가 포함됨) |
|
이름
|
name | True | string |
개인 그룹 표시 이름입니다. 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
사용자 그룹에 연결된 사용자가 제공한 데이터입니다. 크기 제한은 16KB입니다. |
사람 가져오기
등록된 지속형 얼굴, 이름 및 userData를 포함하여 사용자의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자를 포함하는 사람 그룹 지정 |
|
개인 ID
|
personId | True | string |
대상 사용자 지정 |
반환
사람 가져오기(V2)
등록된 지속형 얼굴, 이름 및 userData를 포함하여 사용자의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자를 포함하는 사람 그룹 지정 |
|
개인 ID
|
personId | True | string |
대상 사용자 지정 |
반환
사람 얼굴 가져오기
persistedFaceId, personId 및 해당 소속 personGroupId로 지정된 지속형 얼굴에 대한 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자를 포함하는 사람 그룹 지정 |
|
개인 ID
|
personId | True | string |
얼굴이 속한 대상 사용자를 지정합니다. |
|
지속형 얼굴 ID
|
persistedFaceId | True | string |
대상의 지속형 얼굴의 persistedFaceId입니다. |
반환
사람 얼굴 가져오기(V2)
persistedFaceId, personId 및 해당 소속 personGroupId로 지정된 지속형 얼굴에 대한 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
대상 사용자를 포함하는 사람 그룹 지정 |
|
개인 ID
|
personId | True | string |
얼굴이 속한 대상 사용자를 지정합니다. |
|
지속형 얼굴 ID
|
persistedFaceId | True | string |
대상의 지속형 얼굴의 persistedFaceId입니다. |
반환
사람 얼굴 추가
식별을 위해 담당자에게 대표 얼굴을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
개인 그룹 |
|
개인 ID
|
personId | True | string |
얼굴이 추가되는 대상 사람입니다. |
|
이미지 URL
|
url | True | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
|
대상 얼굴
|
targetFace | string |
대상에 추가할 대상 얼굴을 targetFace=left,top,width,height 형식으로 지정하는 얼굴 사각형 |
|
|
사용자 데이터
|
userData | string |
어떤 용도로든 추가할 대상 면에 대한 사용자 지정 데이터입니다. 최대 길이는 1KB입니다. |
반환
사람 얼굴 추가(V2)
식별을 위해 담당자에게 대표 얼굴을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
개인 그룹 |
|
개인 ID
|
personId | True | string |
얼굴이 추가되는 대상 사람입니다. |
|
이미지 URL
|
url | True | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
|
대상 얼굴
|
targetFace | string |
대상에 추가할 대상 얼굴을 targetFace=left,top,width,height 형식으로 지정하는 얼굴 사각형 |
|
|
사용자 데이터
|
userData | string |
어떤 용도로든 추가할 대상 면에 대한 사용자 지정 데이터입니다. 최대 길이는 1KB입니다. |
반환
사용자 만들기
지정된 사용자 그룹에 새 사용자를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | True | string |
사용자를 만들 대상 사용자 그룹을 지정합니다. |
|
이름
|
name | True | string |
대상 사용자의 표시 이름입니다. 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
사용자에게 연결된 사용자 제공 데이터에 대한 선택적 필드입니다. 크기 제한은 16KB입니다. |
반환
사용자 만들기(V2)
지정된 사용자 그룹에 새 사용자를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
개인 그룹 ID
|
personGroupId | True | string |
사용자를 만들 대상 사용자 그룹을 지정합니다. |
|
이름
|
name | True | string |
대상 사용자의 표시 이름입니다. 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
사용자에게 연결된 사용자 제공 데이터에 대한 선택적 필드입니다. 크기 제한은 16KB입니다. |
반환
얼굴 감지
이미지에서 사람의 얼굴을 감지하고 얼굴 위치를 반환하고 필요에 따라 faceId, 랜드마크 및 특성을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이미지 URL
|
url | True | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
반환
- 아이템
- DetectResponse
얼굴 감지(V2)
이미지에서 사람의 얼굴을 감지하고 얼굴 위치를 반환하고 필요에 따라 faceId, 랜드마크 및 특성을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
이미지 URL
|
url | True | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
반환
- 아이템
- DetectResponse
얼굴 목록 가져오기
얼굴 목록의 faceListId, 이름, userData 및 얼굴을 비롯한 얼굴 목록의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
얼굴 목록 ID
|
faceListId | True | string |
대상 얼굴 목록의 faceListId입니다. |
반환
얼굴 목록 가져오기(V2)
얼굴 목록의 faceListId, 이름, userData 및 얼굴을 비롯한 얼굴 목록의 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
얼굴 목록 ID
|
faceListId | True | string |
대상 얼굴 목록의 faceListId입니다. |
반환
얼굴 목록 만들기
사용자 지정 faceListId, 이름 및 선택적 userData를 사용하여 빈 얼굴 목록을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
얼굴 목록 ID
|
faceListId | True | string |
유효한 문자는 소문자, 숫자 또는 '-' 또는 '_'이며 최대 길이는 64입니다. |
|
얼굴 목록 이름
|
name | True | string |
만든 얼굴 목록의 이름, 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
얼굴 목록에 대한 선택적 사용자 정의 데이터입니다. 길이는 16KB를 초과하면 안 됩니다. |
얼굴 목록 만들기(V2)
사용자 지정 faceListId, 이름 및 선택적 userData를 사용하여 빈 얼굴 목록을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
얼굴 목록 ID
|
faceListId | True | string |
유효한 문자는 소문자, 숫자 또는 '-' 또는 '_'이며 최대 길이는 64입니다. |
|
얼굴 목록 이름
|
name | True | string |
만든 얼굴 목록의 이름, 최대 길이는 128입니다. |
|
사용자 데이터
|
userData | string |
얼굴 목록에 대한 선택적 사용자 정의 데이터입니다. 길이는 16KB를 초과하면 안 됩니다. |
얼굴 목록 추가(V2)
얼굴 목록에 얼굴을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
이미지 URL
|
url | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
|
|
대상 얼굴
|
targetFace | string |
대상에 추가할 대상 얼굴을 targetFace=left,top,width,height 형식으로 지정하는 얼굴 사각형 |
|
|
사용자 데이터
|
userData | string |
어떤 용도로든 추가할 대상 면에 대한 사용자 지정 데이터입니다. 최대 길이는 1KB입니다. |
|
|
얼굴 목록 ID
|
faceListId | True | string |
유효한 문자는 소문자 또는 숫자 또는 '-' 또는 '_'이며 최대 길이는 64입니다. |
반환
얼굴에 얼굴 목록 추가
얼굴 목록에 얼굴을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이미지 URL
|
url | string |
이미지는 JPEG, PNG, GIF(첫 번째 프레임) 또는 BMP여야 합니다. |
|
|
대상 얼굴
|
targetFace | string |
대상에 추가할 대상 얼굴을 targetFace=left,top,width,height 형식으로 지정하는 얼굴 사각형 |
|
|
사용자 데이터
|
userData | string |
어떤 용도로든 추가할 대상 면에 대한 사용자 지정 데이터입니다. 최대 길이는 1KB입니다. |
|
|
얼굴 목록 ID
|
faceListId | True | string |
유효한 문자는 소문자 또는 숫자 또는 '-' 또는 '_'이며 최대 길이는 64입니다. |
반환
얼굴에서 사람 찾기
두 얼굴이 같은 사람에 속하는지 또는 한 얼굴이 사람에 속하는지 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Face Id
|
faceId | True | string |
감지된 얼굴의 고유 faceId입니다. 검색 호출 후 24시간 후에 만료됩니다. |
|
개인 그룹 ID
|
personGroupId | True | string |
Face API에서 만든 사람 그룹 ID - 사람 그룹 만들기 작업 |
|
개인 ID
|
personId | True | string |
Face API에서 만든 사람 ID - 사람 만들기 작업입니다. |
반환
얼굴에서 사람 찾기(V2)
두 얼굴이 같은 사람에 속하는지 또는 한 얼굴이 사람에 속하는지 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomain | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
Face Id
|
faceId | True | string |
감지된 얼굴의 고유 faceId입니다. 검색 호출 후 24시간 후에 만료됩니다. |
|
개인 그룹 ID
|
personGroupId | True | string |
Face API에서 만든 사람 그룹 ID - 사람 그룹 만들기 작업 |
|
개인 ID
|
personId | True | string |
Face API에서 만든 사람 ID - 사람 만들기 작업입니다. |
반환
정의
DetectResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Face Id
|
faceId | string |
감지된 얼굴의 고유 faceId입니다. 검색 호출 후 24시간 후에 만료됩니다. |
|
Top
|
faceRectangle.top | integer |
이미지의 얼굴 위치에 대한 사각형 영역의 매개 변수입니다. |
|
왼쪽
|
faceRectangle.left | integer |
이미지의 얼굴 위치에 대한 사각형 영역의 매개 변수입니다. |
|
너비
|
faceRectangle.width | integer |
이미지의 얼굴 위치에 대한 사각형 영역의 매개 변수입니다. |
|
높이
|
faceRectangle.height | integer |
이미지의 얼굴 위치에 대한 사각형 영역의 매개 변수입니다. |
|
왼쪽 학생 X
|
faceLandmarks.pupilLeft.x | float |
왼쪽 눈동자의 x 좌표입니다. |
|
왼쪽 학생 Y
|
faceLandmarks.pupilLeft.y | float |
왼쪽 동공의 y 좌표입니다. |
|
오른쪽 동공 X
|
faceLandmarks.pupilRight.x | float |
오른쪽 동공의 x 좌표입니다. |
|
오른쪽 학생 Y
|
faceLandmarks.pupilRight.y | float |
오른쪽 동공의 y 좌표입니다. |
|
노즈 팁 X
|
faceLandmarks.noseTip.x | float |
코 끝의 x 좌표입니다. |
|
코 팁 Y
|
faceLandmarks.noseTip.y | float |
코 끝의 y 좌표입니다. |
|
입 왼쪽 X
|
faceLandmarks.mouthLeft.x | float |
입의 왼쪽에 대한 x 좌표입니다. |
|
입 왼쪽 Y
|
faceLandmarks.mouthLeft.y | float |
입의 왼쪽에 대한 y 좌표입니다. |
|
마우스 오른쪽 X
|
faceLandmarks.mouthRight.x | float |
입의 오른쪽에 대한 x 좌표입니다. |
|
마우스 오른쪽 Y
|
faceLandmarks.mouthRight.y | float |
입의 오른쪽에 대한 y 좌표입니다. |
|
외부 왼쪽 눈썹 X
|
faceLandmarks.eyebrowLeftOuter.x | float |
왼쪽 눈썹의 바깥쪽에 대한 x 좌표입니다. |
|
외부 왼쪽 눈썹 Y
|
faceLandmarks.eyebrowLeftOuter.y | float |
왼쪽 눈썹의 바깥쪽에 대한 y 좌표입니다. |
|
내부 왼쪽 아이브로우 X
|
faceLandmarks.eyebrowLeftInner.x | float |
왼쪽 눈썹의 안쪽에 대한 x 좌표입니다. |
|
안쪽 왼쪽 눈썹 Y
|
faceLandmarks.eyebrowLeftInner.y | float |
왼쪽 눈썹의 안쪽에 대한 y 좌표입니다. |
|
외부 왼쪽 눈 X
|
faceLandmarks.eyeLeftOuter.x | float |
왼쪽 눈의 바깥쪽에 대한 x 좌표입니다. |
|
외부 왼쪽 눈 Y
|
faceLandmarks.eyeLeftOuter.y | float |
왼쪽 눈의 바깥쪽에 대한 y 좌표입니다. |
|
왼쪽 눈 X의 위쪽
|
faceLandmarks.eyeLeftTop.x | float |
왼쪽 눈의 위쪽에 대한 x 좌표입니다. |
|
왼쪽 눈 Y의 위쪽
|
faceLandmarks.eyeLeftTop.y | float |
왼쪽 눈의 위쪽에 대한 y 좌표입니다. |
|
왼쪽 눈 X의 아래쪽
|
faceLandmarks.eyeLeftBottom.x | float |
왼쪽 눈의 아래쪽에 대한 x 좌표입니다. |
|
왼쪽 눈 Y의 아래쪽
|
faceLandmarks.eyeLeftBottom.y | float |
왼쪽 눈의 아래쪽에 대한 y 좌표입니다. |
|
왼쪽 눈 안쪽 X
|
faceLandmarks.eyeLeftInner.x | float |
왼쪽 눈의 안쪽에 대한 x 좌표입니다. |
|
왼쪽 안쪽 눈 Y
|
faceLandmarks.eyeLeftInner.y | float |
왼쪽 눈의 안쪽에 대한 y 좌표입니다. |
|
내부 오른쪽 아이브로우 X
|
faceLandmarks.eyebrowRightInner.x | float |
오른쪽 눈썹의 안쪽에 대한 x 좌표입니다. |
|
내부 오른쪽 눈썹 Y
|
faceLandmarks.eyebrowRightInner.y | float |
오른쪽 눈썹의 안쪽에 대한 y 좌표입니다. |
|
외부 오른쪽 눈썹 X
|
faceLandmarks.eyebrowRightOuter.x | float |
오른쪽 눈썹의 바깥쪽에 대한 x 좌표입니다. |
|
외부 오른쪽 눈썹 Y
|
faceLandmarks.eyebrowRightOuter.y | float |
오른쪽 눈썹의 바깥쪽에 대한 y 좌표입니다. |
|
오른쪽 눈 안쪽 X
|
faceLandmarks.eyeRightInner.x | float |
오른쪽 눈의 안쪽에 대한 x 좌표입니다. |
|
오른쪽 안쪽 눈 Y
|
faceLandmarks.eyeRightInner.y | float |
오른쪽 눈의 안쪽에 대한 y 좌표입니다. |
|
오른쪽 눈 X의 위쪽
|
faceLandmarks.eyeRightTop.x | float |
오른쪽 눈의 위쪽에 대한 x 좌표입니다. |
|
오른쪽 눈 Y의 위쪽
|
faceLandmarks.eyeRightTop.y | float |
오른쪽 눈의 위쪽에 대한 y 좌표입니다. |
|
오른쪽 눈 X의 아래쪽
|
faceLandmarks.eyeRightBottom.x | float |
오른쪽 눈의 아래쪽에 대한 x 좌표입니다. |
|
오른쪽 눈 아래 Y
|
faceLandmarks.eyeRightBottom.y | float |
오른쪽 눈의 아래쪽에 대한 y 좌표입니다. |
|
외부 오른쪽 눈 X
|
faceLandmarks.eyeRightOuter.x | float |
오른쪽 눈의 바깥쪽에 대한 x 좌표입니다. |
|
외부 오른쪽 눈 Y
|
faceLandmarks.eyeRightOuter.y | float |
오른쪽 눈의 바깥쪽에 대한 y 좌표입니다. |
|
왼쪽 코 루트 X
|
faceLandmarks.noseRootLeft.x | float |
코 루트의 왼쪽에 대한 x 좌표입니다. |
|
왼쪽 코 루트 Y
|
faceLandmarks.noseRootLeft.y | float |
코 루트의 왼쪽에 대한 y 좌표입니다. |
|
오른쪽 코 루트 X
|
faceLandmarks.noseRootRight.x | float |
코 루트의 오른쪽에 대한 x 좌표입니다. |
|
오른쪽 코 루트 Y
|
faceLandmarks.noseRootRight.y | float |
코 뿌리의 오른쪽에 대한 y 좌표입니다. |
|
왼쪽 코 제단 X의 위쪽
|
faceLandmarks.noseLeftAlarTop.x | float |
왼쪽 코 제단의 위쪽에 대한 x 좌표입니다. |
|
왼쪽 코 제단 Y의 상단
|
faceLandmarks.noseLeftAlarTop.y | float |
왼쪽 코 제단의 위쪽에 대한 y 좌표입니다. |
|
오른쪽 코 제단 X의 상단
|
faceLandmarks.noseRightAlarTop.x | float |
오른쪽 코 제단의 위쪽에 대한 x 좌표입니다. |
|
오른쪽 코 제단 Y의 상단
|
faceLandmarks.noseRightAlarTop.y | float |
오른쪽 코 제단의 위쪽에 대한 y 좌표입니다. |
|
왼쪽 코 제단 아웃 X의 팁
|
faceLandmarks.noseLeftAlarOutTip.x | float |
왼쪽 코 제단 끝의 x 좌표입니다. |
|
왼쪽 코 제단의 끝 아웃 Y
|
faceLandmarks.noseLeftAlarOutTip.y | float |
왼쪽 코 제단 끝의 y 좌표/ |
|
오른쪽 코 제단 아웃 X의 팁
|
faceLandmarks.noseRightAlarOutTip.x | float |
오른쪽 코 제단 끝의 x 좌표입니다. |
|
오른쪽 코 제단의 팁 아웃 Y
|
faceLandmarks.noseRightAlarOutTip.y | float |
오른쪽 코 제단 끝의 y 좌표입니다. |
|
윗입술 X의 위쪽
|
faceLandmarks.upperLipTop.x | float |
윗입술의 위쪽에 대한 x 좌표입니다. |
|
윗입술 Y
|
faceLandmarks.upperLipTop.y | float |
윗입술의 위쪽에 대한 y 좌표입니다. |
|
윗입술 X의 아래쪽
|
faceLandmarks.upperLipBottom.x | float |
윗입술의 아래쪽에 대한 x 좌표입니다. |
|
윗입술 Y의 아래쪽
|
faceLandmarks.upperLipBottom.y | float |
윗입술의 아래쪽에 대한 y 좌표입니다. |
|
립 X 아래의 위쪽
|
faceLandmarks.underLipTop.x | float |
아래 입술의 위쪽에 대한 x 좌표입니다. |
|
위쪽 아래 립 Y
|
faceLandmarks.underLipTop.y | float |
밑 입술의 위쪽에 대한 y 좌표입니다. |
|
아래 립 X의 아래쪽
|
faceLandmarks.underLipBottom.x | float |
아래 입술의 아래쪽에 대한 x 좌표입니다. |
|
아래 립 Y의 아래쪽
|
faceLandmarks.underLipBottom.y | float |
아래 입술의 아래쪽에 대한 y 좌표입니다. |
|
머리 포즈 피치
|
faceAttributes.headPose.pitch | float |
예약된 필드는 항상 0을 반환합니다. |
|
머리 포즈 롤
|
faceAttributes.headPose.roll | float |
머리 포즈의 롤. |
|
머리 포즈 요
|
faceAttributes.headPose.yaw | float |
머리 포즈의 요. |
|
안경
|
faceAttributes.glasses | string |
안경 유형입니다. |
AddPersonFaceResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
지속형 얼굴 ID
|
persistedFaceId | string |
GetPersonGroupResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
개인 그룹 ID
|
personGroupId | string | |
|
이름
|
name | string | |
|
사용자 데이터
|
userData | string |
GetFaceListResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
지속형 얼굴
|
persistedFaces | array of object | |
|
지속형 얼굴 ID
|
persistedFaces.persistedFaceId | string |
얼굴의 ID입니다. |
|
사용자 데이터
|
persistedFaces.userData | string |
각 얼굴에 연결된 사용자 제공 데이터입니다. |
|
얼굴 목록 ID
|
faceListId | string |
대상 얼굴 목록의 faceListId입니다. |
|
이름
|
name | string |
얼굴 목록의 표시 이름입니다. |
|
사용자 데이터
|
userData | string |
얼굴 목록에 연결된 사용자가 제공한 데이터입니다. |
GetPersonFaceResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
지속형 얼굴 ID
|
persistedFaceId | string | |
|
사용자 데이터
|
userData | string |
CreatePersonResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
개인 ID
|
personId | string |
GetPersonResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
개인 ID
|
personId | string | |
|
지속형 얼굴 ID
|
persistedFaceIds | array of object | |
|
지속형 얼굴 ID
|
persistedFaceIds.persistedFaceId | string | |
|
이름
|
name | string | |
|
사용자 데이터
|
userData | string |
VerifyResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
같습니다.
|
isIdentical | boolean |
두 얼굴이 같은 사람에 속하거나 얼굴이 사람에 속하는 경우 True이고, 그렇지 않으면 false입니다. |
|
신뢰
|
confidence | float |
숫자는 두 얼굴이 동일한 사람에게 속하는지 또는 얼굴이 그 사람에게 속하는지 여부에 대한 유사성 신뢰도를 나타냅니다. |