Large Person Group Person - Add Face From Url

Service:

Cognitive Services - Face

API Version:

1.0

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á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 o recurso de rosto extraído será armazenado no servidor até que LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete ou LargePersonGroup - Delete seja chamado.
Observação persistedFaceId é diferente de faceId gerada por 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 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 Face – 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.
• 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.
• 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 modelos de detecção diferentes, consulte Como especificar um modelo de detecção

POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces

With optional parameters:

POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	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		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 Rosto ou (Grande)PersonGroup - Adicionar Rosto. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.
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". 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 1 KB.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
url	True	string	URL acessível publicamente de uma imagem

Respostas

Nome	Tipo	Description
200 OK	PersistedFace	Uma chamada bem-sucedida retorna o novo persistedFaceId.
Other Status Codes	APIError	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

Add Person face example

Sample Request

HTTP

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

Status code:

200

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

Definições

Nome	Description
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 Rosto 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

Nome	Tipo	Description
error	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 Rosto ou (Grande)PersonGroup - Adicionar Rosto. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.

Nome	Tipo	Description
detection_01	string
detection_02	string
detection_03	string

Error

Corpo do erro.

Nome	Tipo	Description
code	string
message	string

ImageUrl

Nome	Tipo	Description
url	string	URL acessível publicamente de uma imagem

PersistedFace

Objeto PersonFace.

Nome	Tipo	Description
persistedFaceId	string	O persistedFaceId da face de destino, que é persistente e não expirará. Diferente de faceId criada por Face – Detecte 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.