다음을 통해 공유

LargePersonGroupPersonOperations 클래스

  • 참조

LargePersonGroupPersonOperations 작업.

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

상속
builtins.object
LargePersonGroupPersonOperations

생성자

LargePersonGroupPersonOperations(client, config, serializer, deserializer)

매개 변수

Name Description
client
필수

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

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

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

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

메서드

add_face_from_stream

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

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

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

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

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

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

지정된 대규모 사람 그룹에 새 사람을 추가합니다.
delete

대규모 사람 그룹에서 기존 사람을 삭제합니다. 개인 항목의 persistedFaceId, userData, person name 및 face 기능이 모두 삭제됩니다.
delete_face

지정된 largePersonGroupId, personId 및 persistedFaceId로 대규모 사용자 그룹에 있는 사람의 얼굴을 삭제합니다.
같은 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다. 다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.
get

사용자의 이름과 userData 및 등록된 사용자 얼굴 기능을 나타내는 지속형 faceId를 검색합니다.
get_face

지속형 얼굴(persistedFaceId, personId 및 해당 속한 largePersonGroupId로 지정됨)에 대한 정보를 검색합니다.
list

큰 사람 그룹에 있는 모든 사람을 나열하고 사람 정보(등록된 얼굴의 personId, name, userData 및 persistedFaceIds 포함)를 검색합니다.
update

사람의 name 또는 userData를 업데이트합니다.
update_face

지속형 얼굴의 userData 필드를 업데이트합니다.

add_face_from_stream

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

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

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

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_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

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

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

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

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_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

지정된 대규모 사람 그룹에 새 사람을 추가합니다.

create(large_person_group_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
name
str

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

기본값: None
user_data
str

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

기본값: None
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

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

기본값: False
operation_config
필수

작업 구성 재정의.

반환

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

person 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

delete

대규모 사람 그룹에서 기존 사람을 삭제합니다. 개인 항목의 persistedFaceId, userData, person name 및 face 기능이 모두 삭제됩니다.

delete(large_person_group_id, person_id, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_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

지정된 largePersonGroupId, personId 및 persistedFaceId로 대규모 사용자 그룹에 있는 사람의 얼굴을 삭제합니다.
같은 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다. 다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.

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

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_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

사용자의 이름과 userData 및 등록된 사용자 얼굴 기능을 나타내는 지속형 faceId를 검색합니다.

get(large_person_group_id, person_id, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_id
필수
str

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

요청에 추가될 헤더

기본값: None
raw
bool

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

기본값: False
operation_config
필수

작업 구성 재정의.

반환

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

person 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

get_face

지속형 얼굴(persistedFaceId, personId 및 해당 속한 largePersonGroupId로 지정됨)에 대한 정보를 검색합니다.

get_face(large_person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_id
필수
str

특정 사용자를 참조하는 ID입니다.
persisted_face_id
필수
str

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

요청에 추가될 헤더

기본값: None
raw
bool

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

기본값: False
operation_config
필수

작업 구성 재정의.

반환

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

PersistedFace 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

list

큰 사람 그룹에 있는 모든 사람을 나열하고 사람 정보(등록된 얼굴의 personId, name, userData 및 persistedFaceIds 포함)를 검색합니다.

list(large_person_group_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
start
str

반환할 사람 ID를 시작합니다(다양한 사람을 나열하는 데 사용됨).

기본값: None
top
int

'start' 매개 변수로 표시된 사람 ID로 시작하여 반환할 사람 수입니다.

기본값: None
custom_headers
dict

요청에 추가될 헤더

기본값: None
raw
bool

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

기본값: False
operation_config
필수

작업 구성 재정의.

반환

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

list 또는 ClientRawResponse if raw=true

예외

형식 Description
APIErrorException

update

사람의 name 또는 userData를 업데이트합니다.

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

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_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

update_face

지속형 얼굴의 userData 필드를 업데이트합니다.

update_face(large_person_group_id, person_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)

매개 변수

Name Description
large_person_group_id
필수
str

특정 큰 사용자 그룹을 참조하는 ID입니다.
person_id
필수
str

특정 사용자를 참조하는 ID입니다.
persisted_face_id
필수
str

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

사용자가 제공한 데이터가 얼굴에 연결되어 있습니다. 크기 제한은 1KB입니다.

기본값: 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'>