Compartilhar via


Person Group Operations - Add Person Group Person Face

Adicione um rosto a uma pessoa em um Grupo de Pessoas 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 "Excluir Pessoa do Grupo de Pessoas Cara", "Excluir Pessoa Do Grupo de Pessoas Pessoa" ou "Excluir Grupo de Pessoas" seja chamado.

Observe que persistedFaceId é diferente da faceId gerada por "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 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ários rostos serão considerados 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 da face detectável (36x36 - 4096x4096 pixels), pose de cabeça grande ou grandes oclusão causará 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 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Diferentes valores 'detectionModel' podem ser fornecidos. Para usar e comparar diferentes modelos de detecção, consulte https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces?_overload=addPersonGroupPersonFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
apiVersion
path True

string

Versão da API

endpoint
path True

string

uri

Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://{resource-name}.cognitiveservices.azure.com).

personGroupId
path True

string

ID do contêiner.

Padrão Regex: ^[a-z0-9-_]+$

personId
path True

string

uuid

ID da pessoa.

detectionModel
query

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'.

targetFace
query

integer[]

Um retângulo facial para especificar o rosto de destino a ser adicionado a uma pessoa, no formato 'targetFace=left,top,width,height'.

userData
query

string

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

Corpo da solicitação

Media Types: "application/octet-stream"

Nome Tipo Description
imageContent

string

A imagem a ser analisada

Respostas

Nome Tipo Description
200 OK

AddFaceResult

Uma chamada bem-sucedida retorna um novo persistedFaceId.

Other Status Codes

FaceErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta para sua assinatura de Detecção Facial de IA do Azure.

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

Nome Description
https://cognitiveservices.azure.com/.default

Exemplos

Add Face to PersonGroup Person

Solicitação de exemplo

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?_overload=addPersonGroupPersonFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

Resposta de exemplo

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

Definições

Nome Description
AddFaceResult

Corpo da resposta para adicionar 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.

AddFaceResult

Corpo da resposta para adicionar rosto.

Nome Tipo Description
persistedFaceId

string

ID de Rosto persistente do rosto adicionado, que é persistente e não expirará. Diferente de faceId, que é criada em "Detectar" e expirará em 24 horas após a chamada de detecção.

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'.

Nome Tipo Description
detection_01

string

O modelo de detecção padrão. É recomendável para detecção facial quase frontal. Para cenários com faces de ângulo excepcionalmente grandes (pose de cabeça), rostos esccluded ou orientação de imagem errada, os rostos nesses casos podem não ser detectados.

detection_02

string

Modelo de detecção lançado em maio de 2019 com precisão aprimorada especialmente em rostos pequenos, laterais e desfocados.

detection_03

string

Modelo de detecção lançado em fevereiro de 2021 com precisão aprimorada especialmente em rostos pequenos.

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.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

message

string

Uma representação legível pelo homem do erro.

FaceErrorResponse

Uma resposta que contém detalhes do erro.

Nome Tipo Description
error

FaceError

O objeto de erro.