Partilhar via


Face List - Add Face From Stream

Adicione um rosto a uma lista de rostos especificada, até 1000 rostos.
Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem. Apenas a funcionalidade de rosto extraído será armazenada no servidor até a opção FaceList – Eliminar Rosto ou FaceList – Eliminar ser chamada.
Nota persistedFaceId é diferente do faceId gerado por Face – Detect.

  • Uma maior qualidade de imagem facial significa uma melhor deteção e precisão de reconhecimento. Considere rostos de alta qualidade: o tamanho frontal, claro e facial é de 200x200 píxeis (100 píxeis entre os olhos) ou superior.
  • O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1 KB 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 devolvido de Face – Detetar, não é garantido detetar e adicionar o rosto com êxito.
  • O tamanho do rosto detetável (36x36 - 4096x4096 píxeis), a pose de cabeça grande ou as grandes oclusões causarão falhas.
  • A adição/eliminação de rostos de/para uma mesma lista de rostos são processadas sequencialmente e de/para listas de rostos diferentes estão em paralelo.
  • O tamanho mínimo de rosto detetável é de 36x36 píxeis numa imagem não superior a 1920x1080 píxeis. As imagens com dimensões superiores a 1920x1080 pixéis precisarão de um tamanho facial mínimo proporcionalmente maior.
  • Podem ser fornecidos valores "detectionModel" diferentes. Para utilizar e comparar diferentes modelos de deteção, veja Como especificar um modelo de deteção.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parâmetros do URI

Name Em Necessário Tipo Description
Endpoint
path True

string

Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://westus.api.cognitive.microsoft.com).

faceListId
path True

string

ID que referencia uma lista de rostos específica.

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

detectionModel
query

DetectionModel

Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao efetuar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente.

targetFace
query

integer[]

Um retângulo de rosto para especificar o rosto de destino a adicionar a uma pessoa no formato "targetFace=left,top,width,height". Por exemplo, "targetFace=10,10,100,100". Se existir mais do que um rosto na imagem, é necessário targetFace para especificar o rosto a adicionar. Nenhum targetFace significa que só é detetado um rosto em toda a imagem.

userData
query

string

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

Cabeçalho do Pedido

Media Types: "application/octet-stream"

Name Necessário Tipo Description
Ocp-Apim-Subscription-Key True

string

Corpo do Pedido

Media Types: "application/octet-stream"

Name Tipo Description
Image

object

Um fluxo de imagens.

Respostas

Name Tipo Description
200 OK

PersistedFace

Uma chamada bem-sucedida devolve um novo persistedFaceId.

Other Status Codes

APIError

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Add face to face list from stream example

Pedido de amostra

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Resposta da amostra

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Definições

Name Description
APIError

Informações de erro devolvidas pela API

DetectionModel

Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao efetuar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente.

Error

Corpo do erro.

PersistedFace

Objeto PersonFace.

APIError

Informações de erro devolvidas pela API

Name Tipo Description
error

Error

Corpo do erro.

DetectionModel

Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao efetuar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente.

Name Tipo Description
detection_01

string

detection_02

string

detection_03

string

Error

Corpo do erro.

Name Tipo Description
code

string

message

string

PersistedFace

Objeto PersonFace.

Name Tipo Description
persistedFaceId

string

O persistedFaceId do rosto de destino, que é persistente e não expira. Diferente do faceId criado por Face – Detetar e irá expirar no momento especificado por faceIdTimeToLive após a chamada de deteção.

userData

string

Dados fornecidos pelo utilizador anexados ao rosto. O limite de tamanho é de 1 KB.