Person Directory Operations - Add Person Face From Url

Adicione um rosto a uma pessoa (consulte o Diretório de Pessoas "Criar Pessoa") para identificação ou verificação facial.
Para lidar com uma imagem que contém vários rostos, 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 os recursos de rosto extraídos serão armazenados no servidor até que o Diretório de Pessoas "Excluir Rosto da Pessoa" ou "Excluir Pessoa" seja chamado.

Observe que persistedFaceId é diferente da faceId gerada por "Detect".

• • 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 rostos.
  • Há suporte para JPEG, PNG, GIF (o primeiro quadro) e formato BMP. O tamanho do arquivo de imagem permitido é 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 de "Detectar", não haverá garantia de detectar e adicionar o rosto com êxito.
  • Fora do tamanho detectável da face (36x36 - 4096x4096 pixels), pose de cabeça grande ou grandes oclusões causarão falhas.
  • 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 1920 x 1080 pixels precisarão de um tamanho de rosto mínimo proporcionalmente maior.
  • Diferentes valores 'detectionModel' podem ser fornecidos. Para usar e comparar modelos de detecção diferentes, consulte https://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-detection-model
• • A adição/exclusão de rostos de/para uma mesma pessoa será processada sequencialmente. A adição/exclusão de rostos de/para pessoas diferentes é processada em paralelo.
  • Esta é uma operação de execução longa. Use o cabeçalho de resposta "Operation-Location" para determinar quando a operação AddFace foi propagada com êxito para solicitações futuras para "Identificar". Para obter mais informações sobre Operation-Locations consulte "Obter status da operação facial".

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces?_overload=addPersonFaceFromUrl&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

A chave secreta para sua assinatura do Azure AI Face.

Tipo: apiKey
Em: header

AADToken

O fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://api.example.com/oauth2/authorize
URL do Token: https://api.example.com/oauth2/token

Escopos

Exemplos

Add Face to PersonDirectory Person from Url

POST {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces?_overload=addPersonFaceFromUrl&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Definições

AddFaceResult

Corpo da resposta para adicionar o rosto.

DetectionModel

O 'detectionModel' associado às faceIds detectadas. Os valores 'detectionModel' com suporte incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Serviço de Detecção Facial, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Uma resposta que contém detalhes do erro.

RecognitionModel

O modelo de reconhecimento para o rosto.