FaceListOperations 클래스

  • 참조

FaceListOperations 작업.

이 클래스를 직접 인스턴스화하지 말고 이를 만들어 특성으로 연결하는 클라이언트 instance 만듭니다.

상속
builtins.object
FaceListOperations

생성자

FaceListOperations(client, config, serializer, deserializer)

매개 변수

Name Description
client
필수

서비스 요청에 대한 클라이언트입니다.
config
필수

서비스 클라이언트의 구성입니다.
serializer
필수

개체 모델 직렬 변환기입니다.
deserializer
필수

개체 모델 역직렬 변환기입니다.

메서드

add_face_from_stream

최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
참고 persistedFaceId는 [Face)에서 생성된 faceId와 다릅니다.

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

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

최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
참고 persistedFaceId는 [Face)에서 생성된 faceId와 다릅니다.

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

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

사용자 지정 faceListId, 이름, 선택적 userData 및 recognitionModel을 사용하여 빈 얼굴 목록을 만듭니다. 한 구독에서 최대 64개의 얼굴 목록이 허용됩니다.
얼굴 목록은 최대 1,000명의 얼굴 목록이며 얼굴 - 유사 항목 찾기에서 사용됩니다.
만든 후에는 FaceList - Face 추가 를 사용하여 얼굴을 가져와야 합니다. 이미지가 저장되지 않습니다. FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
유사 항목 찾기는 유명인과 같은 얼굴 찾기, 유사한 얼굴 필터링 또는 가벼운 얼굴 식별과 같은 시나리오에 사용됩니다. 그러나 실제 사용이 사람을 식별하는 것이라면 PersonGroupLargePersonGroup / 및 Face - Identify를 사용하세요.
얼굴 번호가 큰 경우 LargeFaceList 를 고려하세요. 최대 1,000,000명의 얼굴을 지원할 수 있습니다.
이 얼굴 목록과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 얼굴 목록에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 얼굴 목록의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다. 얼굴 인식 모델 지정을 참조하세요.
delete

지정된 얼굴 목록을 삭제합니다.
delete_face

지정된 faceListId 및 persistedFaceId에 따라 얼굴 목록에서 얼굴을 삭제합니다.
동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.
get

얼굴 목록의 faceListId, name, userData, recognitionModel 및 얼굴 목록의 얼굴을 검색합니다. .
list

얼굴 목록의 faceListId, 이름, userData 및 recognitionModel을 나열합니다.
faceList 내에서 얼굴 정보를 얻으려면 FaceList - 가져오기 를 사용합니다.
update

얼굴 목록의 정보를 업데이트합니다.

add_face_from_stream

최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
참고 persistedFaceId는 [Face)에서 생성된 faceId와 다릅니다.

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

  • 얼굴 이미지 품질이 높으면 감지 및 인식 정밀도 향상을 의미합니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이에 100픽셀) 이상입니다.
  • JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
  • "targetFace" 사각형은 한 얼굴을 포함해야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face - Detect에서 반환되지 않는 경우 얼굴을 감지하고 성공적으로 추가할 수 있다는 보장은 없습니다.
  • 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
  • 동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.
  • 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 높은 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
  • 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
add_face_from_stream(face_list_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
image
필수
Generator

이미지 스트림입니다.
user_data
str

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

기본값: None
target_face
list[int]

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

기본값: None
detection_model
str 또는 DetectionModel

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

기본값: detection_01
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
callback
Callable[<xref:Bytes>, <xref:response=None>]

지정된 경우 은 스트리밍되는 데이터의 각 청크로 호출됩니다. 콜백은 현재 데이터 청크 및 응답 개체의 바이트인 두 개의 인수를 사용해야 합니다. 데이터가 업로드되는 경우 응답은 없음이 됩니다.

기본값: None
operation_config
필수

작업 구성 재정의.

반환

형식 Description
PersistedFace,
<xref:msrest.pipeline.ClientRawResponse>

PersistedFace 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

add_face_from_url

최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
참고 persistedFaceId는 [Face)에서 생성된 faceId와 다릅니다.

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

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

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
url
필수
str

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

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

기본값: None
target_face
list[int]

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

기본값: None
detection_model
str 또는 DetectionModel

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

기본값: detection_01
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
PersistedFace,
<xref:msrest.pipeline.ClientRawResponse>

PersistedFace 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

create

사용자 지정 faceListId, 이름, 선택적 userData 및 recognitionModel을 사용하여 빈 얼굴 목록을 만듭니다. 한 구독에서 최대 64개의 얼굴 목록이 허용됩니다.
얼굴 목록은 최대 1,000명의 얼굴 목록이며 얼굴 - 유사 항목 찾기에서 사용됩니다.
만든 후에는 FaceList - Face 추가 를 사용하여 얼굴을 가져와야 합니다. 이미지가 저장되지 않습니다. FaceList - Delete가 호출될 때까지 추출된 얼굴 기능만 서버에 저장됩니다.
유사 항목 찾기는 유명인과 같은 얼굴 찾기, 유사한 얼굴 필터링 또는 가벼운 얼굴 식별과 같은 시나리오에 사용됩니다. 그러나 실제 사용이 사람을 식별하는 것이라면 PersonGroupLargePersonGroup / 및 Face - Identify를 사용하세요.
얼굴 번호가 큰 경우 LargeFaceList 를 고려하세요. 최대 1,000,000명의 얼굴을 지원할 수 있습니다.
이 얼굴 목록과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 얼굴 목록에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 얼굴 목록의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다. 얼굴 인식 모델 지정을 참조하세요.

create(face_list_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
name
필수
str

사용자 정의 이름, 최대 길이는 128입니다.
user_data
str

사용자가 지정한 데이터입니다. 길이가 16KB를 초과하면 안 됩니다.

기본값: None
recognition_model
str 또는 RecognitionModel

가능한 값은 'recognition_01', 'recognition_02', 'recognition_03', 'recognition_04'입니다.

기본값: recognition_01
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
None,
<xref:msrest.pipeline.ClientRawResponse>

raw=true인 경우 None 또는 ClientRawResponse

예외

형식 Description
APIErrorException

delete

지정된 얼굴 목록을 삭제합니다.

delete(face_list_id, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
None,
<xref:msrest.pipeline.ClientRawResponse>

raw=true인 경우 None 또는 ClientRawResponse

예외

형식 Description
APIErrorException

delete_face

지정된 faceListId 및 persistedFaceId에 따라 얼굴 목록에서 얼굴을 삭제합니다.
동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.

delete_face(face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
persisted_face_id
필수
str

기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
None,
<xref:msrest.pipeline.ClientRawResponse>

raw=true인 경우 None 또는 ClientRawResponse

예외

형식 Description
APIErrorException

get

얼굴 목록의 faceListId, name, userData, recognitionModel 및 얼굴 목록의 얼굴을 검색합니다. .

get(face_list_id, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
return_recognition_model
bool

작업이 응답에서 'recognitionModel'을 반환해야 하는지 여부를 나타내는 값입니다.

기본값: False
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
FaceList,
<xref:msrest.pipeline.ClientRawResponse>

FaceList 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

list

얼굴 목록의 faceListId, 이름, userData 및 recognitionModel을 나열합니다.
faceList 내에서 얼굴 정보를 얻으려면 FaceList - 가져오기 를 사용합니다.

list(return_recognition_model=False, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
return_recognition_model
bool

작업이 응답에서 'recognitionModel'을 반환해야 하는지 여부를 나타내는 값입니다.

기본값: False
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
list[FaceList],
<xref:msrest.pipeline.ClientRawResponse>

list 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

update

얼굴 목록의 정보를 업데이트합니다.

update(face_list_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
face_list_id
필수
str

특정 얼굴 목록을 참조하는 ID입니다.
name
str

사용자 정의 이름, 최대 길이는 128입니다.

기본값: None
user_data
str

사용자가 지정한 데이터입니다. 길이가 16KB를 초과하면 안 됩니다.

기본값: None
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

는 역직렬화된 응답과 함께 직접 응답을 반환합니다.

기본값: False
operation_config
필수

작업 구성 재정의.

반환

형식 Description
None,
<xref:msrest.pipeline.ClientRawResponse>

raw=true인 경우 None 또는 ClientRawResponse

예외

형식 Description
APIErrorException

특성

models 

models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>