FaceListOperations Classe
Operações FaceListOperations.
Não deve instanciar diretamente esta classe, mas criar uma instância de Cliente que irá criá-la e anexá-la como atributo.
- Herança
-
builtins.objectFaceListOperations
Construtor
FaceListOperations(client, config, serializer, deserializer)
Parâmetros
Name | Description |
---|---|
client
Necessário
|
Cliente para pedidos de serviço. |
config
Necessário
|
Configuração do cliente de serviço. |
serializer
Necessário
|
Um serializador de modelo de objeto. |
deserializer
Necessário
|
Um desserializador de modelo de objeto. |
Métodos
add_face_from_stream |
Adicione um rosto a uma lista de rostos especificada, até 1000 rostos.
|
add_face_from_url |
Adicione um rosto a uma lista de rostos especificada, até 1000 rostos.
|
create |
Crie uma lista de rostos vazios com faceListId especificado pelo utilizador, nome, um userData opcional e recognitionModel. São permitidas até 64 listas faciais numa subscrição.
|
delete |
Eliminar uma lista de rostos especificada. |
delete_face |
Elimine um rosto de uma lista de rostos por faceListId especificado e persistedFaceId.
|
get |
Obtenha o faceListId, nome, userData, recognitionModel e rostos de uma lista de rostos na lista de rostos. . |
list |
Listar faceListId, nome, userData e recognitionModel das listas de rostos. |
update |
Atualize as informações de uma lista de rostos. |
add_face_from_stream
Adicione um rosto a uma lista de rostos especificada, até 1000 rostos.
Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Nenhuma imagem será armazenada.
Apenas a funcionalidade face extraída será armazenada no servidor até a opção FaceList - Eliminar Rosto ou FaceList - Eliminar ser chamada.
Nota persistedFaceId é diferente do faceId gerado por [Face)
Detetar](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Uma maior qualidade da imagem facial significa uma melhor deteção e precisão de reconhecimento. Considere rostos de alta qualidade: frontal, claro e tamanho do rosto é 200x200 pixels (100 pixels entre os olhos) ou maior.
- O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1KB a 6 MB.
- O retângulo "targetFace" deve conter um rosto. Zero ou vários rostos serão considerados como um erro. Se o retângulo "targetFace" fornecido não for devolvido de Face – Detetar, não há garantias para detetar e adicionar o rosto com êxito.
- O tamanho do rosto detetável (36x36 - 4096x4096 pixels), uma pose de cabeça grande ou grandes oclusões causarão falhas.
- A adição/eliminação de rostos de/para uma mesma lista de rostos é processada sequencialmente e de/para listas faciais diferentes estão em paralelo.
- O tamanho mínimo de rosto detetável é de 36x36 píxeis numa imagem não superior a 1920x1080 píxeis. As imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho facial proporcionalmente maior.
- Podem ser fornecidos diferentes valores "detectionModel". Para utilizar e comparar diferentes modelos de deteção, veja Como especificar um modelo de deteção.
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)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
image
Necessário
|
Um fluxo de imagens. |
user_data
|
Dados especificados pelo utilizador sobre o rosto para qualquer finalidade. O comprimento máximo é de 1 KB. valor predefinido: None
|
target_face
|
Um retângulo facial para especificar o rosto de destino a adicionar a uma pessoa no formato "targetFace=left,top,width,height". Por exemplo, "targetFace=10,10,100,100". Se existir mais do que um rosto na imagem, é necessário targetFace para especificar o rosto a adicionar. Sem targetFace significa que só é detetado um rosto em toda a imagem. valor predefinido: None
|
detection_model
|
Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao executar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente. Os valores possíveis incluem: "detection_01", "detection_02", "detection_03" valor predefinido: detection_01
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
callback
|
Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos, os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma. valor predefinido: None
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
PersistedFace ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
add_face_from_url
Adicione um rosto a uma lista de rostos especificada, até 1000 rostos.
Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Nenhuma imagem será armazenada.
Apenas a funcionalidade face extraída será armazenada no servidor até a opção FaceList - Eliminar Rosto ou FaceList - Eliminar ser chamada.
Nota persistedFaceId é diferente do faceId gerado por [Face)
Detetar](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Uma maior qualidade da imagem facial significa uma melhor deteção e precisão de reconhecimento. Considere rostos de alta qualidade: frontal, claro e tamanho do rosto é 200x200 pixels (100 pixels entre os olhos) ou maior.
- O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1KB a 6 MB.
- O retângulo "targetFace" deve conter um rosto. Zero ou vários rostos serão considerados como um erro. Se o retângulo "targetFace" fornecido não for devolvido de Face – Detetar, não há garantias para detetar e adicionar o rosto com êxito.
- O tamanho do rosto detetável (36x36 - 4096x4096 pixels), uma pose de cabeça grande ou grandes oclusões causarão falhas.
- A adição/eliminação de rostos de/para uma mesma lista de rostos é processada sequencialmente e de/para listas faciais diferentes estão em paralelo.
- O tamanho mínimo de rosto detetável é de 36x36 píxeis numa imagem não superior a 1920x1080 píxeis. As imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho facial proporcionalmente maior.
- Podem ser fornecidos diferentes valores "detectionModel". Para utilizar e comparar diferentes modelos de deteção, veja Como especificar um modelo de deteção.
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)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
url
Necessário
|
URL acessível publicamente de uma imagem |
user_data
|
Dados especificados pelo utilizador sobre o rosto para qualquer finalidade. O comprimento máximo é de 1 KB. valor predefinido: None
|
target_face
|
Um retângulo facial para especificar o rosto de destino a adicionar a uma pessoa no formato "targetFace=left,top,width,height". Por exemplo, "targetFace=10,10,100,100". Se existir mais do que um rosto na imagem, é necessário targetFace para especificar o rosto a adicionar. Sem targetFace significa que só é detetado um rosto em toda a imagem. valor predefinido: None
|
detection_model
|
Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao executar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente. Os valores possíveis incluem: "detection_01", "detection_02", "detection_03" valor predefinido: detection_01
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
PersistedFace ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
create
Crie uma lista de rostos vazios com faceListId especificado pelo utilizador, nome, um userData opcional e recognitionModel. São permitidas até 64 listas faciais numa subscrição.
A Lista de rostos é uma lista de rostos, até 1000 rostos, e utilizada por Face – Localizar Semelhante.
Após a criação, o utilizador deve utilizar FaceList – Adicionar Rosto para importar os rostos. Nenhuma imagem será armazenada. Apenas as funcionalidades faciais extraídas são armazenadas no servidor até que FaceList - Delete seja chamado.
Localizar Semelhante é utilizado para cenários como encontrar rostos semelhantes a celebridades, filtragem de rostos semelhantes ou como uma identificação de rosto leve.
No entanto, se a utilização real for para identificar uma pessoa, utilize PersonGroup
/
LargePersonGroup e Face - Identifique.
Considere LargeFaceList quando o número do rosto for grande. Pode suportar até 1.000.000 rostos.
"recognitionModel" deve ser especificado para associar a esta lista de rostos. O valor predefinido para "recognitionModel" é "recognition_01", se for necessário o modelo mais recente, especifique explicitamente o modelo de que precisa neste parâmetro. Os novos rostos adicionados a uma lista facial existente utilizarão o modelo de reconhecimento que já está associado à coleção. As funcionalidades faciais existentes numa lista de rostos não podem ser atualizadas para funcionalidades extraídas por outra versão do modelo de reconhecimento.
Veja Especificar um modelo de reconhecimento facial.
create(face_list_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
name
Necessário
|
Nome definido pelo utilizador, o comprimento máximo é 128. |
user_data
|
Dados especificados pelo utilizador. O comprimento não deve exceder os 16 KB. valor predefinido: None
|
recognition_model
|
Os valores possíveis incluem: "recognition_01", "recognition_02", "recognition_03", "recognition_04" valor predefinido: recognition_01
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
Nenhum ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
delete
Eliminar uma lista de rostos especificada.
delete(face_list_id, custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
Nenhum ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
delete_face
Elimine um rosto de uma lista de rostos por faceListId especificado e persistedFaceId.
A adição/eliminação de rostos de/para uma mesma lista de rostos é processada sequencialmente e de/para listas faciais diferentes estão em paralelo.
delete_face(face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
persisted_face_id
Necessário
|
ID que referencia umFaceId específico persistente de um rosto existente. |
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
Nenhum ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
get
Obtenha o faceListId, nome, userData, recognitionModel e rostos de uma lista de rostos na lista de rostos. .
get(face_list_id, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
return_recognition_model
|
Um valor que indica se a operação deve devolver "recognitionModel" em resposta. valor predefinido: False
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
FaceList ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
list
Listar faceListId, nome, userData e recognitionModel das listas de rostos.
Para obter informações de rosto dentro do faceList, utilize FaceList – Obter .
list(return_recognition_model=False, custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
return_recognition_model
|
Um valor que indica se a operação deve devolver "recognitionModel" em resposta. valor predefinido: False
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
list ou ClientRawResponse if raw=true |
Exceções
Tipo | Description |
---|---|
update
Atualize as informações de uma lista de rostos.
update(face_list_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
Parâmetros
Name | Description |
---|---|
face_list_id
Necessário
|
ID referente a uma lista de rostos específica. |
name
|
Nome definido pelo utilizador, o comprimento máximo é 128. valor predefinido: None
|
user_data
|
Dados especificados pelo utilizador. O comprimento não deve exceder os 16 KB. valor predefinido: None
|
custom_headers
|
cabeçalhos que serão adicionados ao pedido valor predefinido: None
|
raw
|
devolve a resposta direta juntamente com a resposta desserializada valor predefinido: False
|
operation_config
Necessário
|
Substituições da configuração da operação. |
Devoluções
Tipo | Description |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
Nenhum ou ClientRawResponse se raw=true |
Exceções
Tipo | Description |
---|---|
Atributos
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'>
Azure SDK for Python
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários