Large Person Group Person - Add Face From Url

Adicione um rosto a uma pessoa em um grande grupo de pessoas para identificação ou verificação facial. Para lidar com uma imagem que contém várias faces, a face de entrada pode ser especificada como uma imagem com um retângulo targetFace. Ele retorna um PersistedFaceId que representa o rosto adicionado. Nenhuma imagem será armazenada. Somente o recurso de rosto extraído será armazenado no servidor até que LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete ou LargePersonGroup - Delete seja chamado.
Observe que persistedFaceId é diferente da faceId gerada pelo Face – Detectar.

  • Maior qualidade de imagem facial significa melhor precisão de reconhecimento. Considere rostos de alta qualidade: o tamanho frontal, claro e facial é de 200 x 200 pixels (100 pixels entre os olhos) ou maior.
  • Cada entrada de pessoa pode conter até 248 faces.
  • Há suporte para JPEG, PNG, GIF (o primeiro quadro) e formato BMP. O tamanho permitido do arquivo de imagem é de 1KB a 6 MB.
  • O retângulo "targetFace" deve conter um rosto. Zero ou várias faces serão consideradas como um erro. Se o retângulo "targetFace" fornecido não for retornado do Face – Detecte, não há garantia de detectar e adicionar o rosto com êxito.
  • Do tamanho da face detectável (36x36 - 4096 x 4096 pixels), pose de cabeça grande ou grandes oclusãos causarão falhas.
  • A adição/exclusão de faces de/para uma mesma pessoa será processada sequencialmente. A adição/exclusão de faces de/para pessoas diferentes é processada em paralelo.
  • O tamanho mínimo detectável da face é de 36 x 36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo proporcionalmente maior de rosto.
  • Diferentes valores 'detectionModel' podem ser fornecidos. Para usar e comparar modelos de detecção diferentes, consulte Como especificar um modelo de detecção
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parâmetros de URI

Name In Required Type Description
Endpoint
path True
  • string

Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Id referenciando um grupo de pessoas grandes específico.

Regex pattern: ^[a-z0-9-_]+$

personId
path True
  • string
uuid

Id referenciando uma pessoa em particular.

detectionModel
query

Nome do modelo de detecção. O modelo de detecção é usado para detectar rostos na imagem enviada. Um nome de modelo de detecção pode ser fornecido ao executar Face – Detectar ou (Grande)FaceList – Adicionar Face ou (Grande)PersonGroup – Adicionar Rosto. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.

targetFace
query
  • array

Um retângulo facial para especificar a face de destino a ser adicionada a uma pessoa no formato "targetFace=left, top, width, height". Por exemplo, "targetFace=10,10,100,100". Se houver mais de um rosto na imagem, targetFace será necessário para especificar qual rosto adicionar. Nenhum targetFace significa que há apenas um rosto detectado em toda a imagem.

userData
query
  • string

Dados especificados pelo usuário sobre o rosto para qualquer finalidade. O comprimento máximo é de 1KB.

Cabeçalho da solicitação

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Corpo da solicitação

Name Required Type Description
url True
  • string

URL acessível publicamente de uma imagem

Respostas

Name Type Description
200 OK

Uma chamada bem-sucedida retorna o novo persistedFaceId.

Other Status Codes

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

Add Person face example

Sample Request

POST {Endpoint}/face/v1.0/largepersongroups/abc/persons/4caa25ee-3bc6-4e88-adf8-12455ce7aab0/persistedfaces?userData={customized User data}&targetFace=10,10,100,100&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Sample Response

{
  "persistedFaceId": "6e04c175-219e-42a2-9d26-0e7b790e1ef4"
}

Definições

APIError

Informações de erro retornadas pela API

DetectionModel

Nome do modelo de detecção. O modelo de detecção é usado para detectar rostos na imagem enviada. Um nome de modelo de detecção pode ser fornecido ao executar Face – Detectar ou (Grande)FaceList – Adicionar Face ou (Grande)PersonGroup – Adicionar Rosto. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.

Error

Corpo do erro.

ImageUrl
PersistedFace

Objeto PersonFace.

APIError

Informações de erro retornadas pela API

Name Type Description
error

Corpo do erro.

DetectionModel

Nome do modelo de detecção. O modelo de detecção é usado para detectar rostos na imagem enviada. Um nome de modelo de detecção pode ser fornecido ao executar Face – Detectar ou (Grande)FaceList – Adicionar Face ou (Grande)PersonGroup – Adicionar Rosto. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.

Name Type Description
detection_01
  • string
detection_02
  • string
detection_03
  • string

Error

Corpo do erro.

Name Type Description
code
  • string
message
  • string

ImageUrl

Name Type Description
url
  • string

URL acessível publicamente de uma imagem

PersistedFace

Objeto PersonFace.

Name Type Description
persistedFaceId
  • string

O persistedFaceId do rosto de destino, que é persistente e não expirará. Diferente da faceId criada por Face – Detectar e expirará no momento especificado por faceIdTimeToLive após a chamada de detecção.

userData
  • string

Dados fornecidos pelo usuário anexados ao rosto. O limite de tamanho é 1KB.