Face List Operations - Add Face List Face

Adicione um rosto a uma Lista de Rostos especificada, até 1.000 faces.
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 "Excluir Face da Lista de Rostos" ou "Excluir Lista facial" 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

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Parâmetros de URI

Corpo da solicitação

Media Types: "application/octet-stream"

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 FaceList

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

{
  "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.