Partilhar via


API de rosto

A API Face dos Serviços Cognitivos da Microsoft permite detetar, identificar, analisar, organizar e marcar rostos em fotos.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automate
Aplicações Lógicas Standard Todas as regiões do Logic Apps
Aplicações Power Standard Todas as regiões do Power Apps
Automatize o poder Standard Todas as regiões do Power Automate
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Suporte do Microsoft Power Automate
Suporte do Microsoft Power Apps
Metadados do conector
Editora Microsoft
Sítio Web https://azure.microsoft.com/services/cognitive-services/face/

Para usar essa integração, você precisará de um recurso do Serviço Cognitivo no portal do Azure. Você receberá um ponto de extremidade e uma chave para autenticar seus aplicativos. Para estabelecer uma ligação, forneça a chave da conta, o URL do site e selecione Criar ligação. Para saber mais sobre os custos de operação da sua conexão, saiba mais aqui.

Agora você está pronto para começar a usar essa integração.

Conectando-se com o Microsoft Entra ID

Para criar conexões com o Microsoft Entra ID, você deve adicionar a função Usuário de Serviços Cognitivos à sua conta para acessar. Para usar essa conexão, você deve inserir o subdomínio exclusivo associado ao seu recurso de Serviços Cognitivos nas operações de suporte.

Operações não suportadas com a autenticação do Microsoft Entra ID

Ao usar a autenticação do Microsoft Entra ID , apenas as ações V2 são suportadas. As ações preteridas continuarão a funcionar com Access Key autenticação, mas falharão se usadas com uma conexão de ID do Microsoft Entra.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Chave Api Chave Api Todas as regiões Compartilhável
Padrão [DEPRECATED] Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Chave Api

ID de autenticação: keyBasedAuth

Aplicável: Todas as regiões

Chave Api

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome Tipo Description Obrigatório
Chave da conta securestring Chave de Conta dos Serviços Cognitivos
Site URL cadeia (de caracteres) URL do site raiz (exemplo: https://westus.api.cognitive.microsoft.com)

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API securestring Chave de API Verdade
Site URL cadeia (de caracteres) URL do site raiz (Exemplo: https://westus.api.cognitive.microsoft.com ). Se não for especificado, o URL do site será padronizado para 'https://westus.api.cognitive.microsoft.com'.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 1200 60 segundos

Ações

Adicionar lista cara a cara

Adicionar lista cara a cara.

Adicionar lista face a face (V2)

Adicionar lista cara a cara.

Adicionar um rosto de pessoa

Adicione um rosto representativo a uma pessoa para identificação.

Adicionar um rosto de pessoa (V2)

Adicione um rosto representativo a uma pessoa para identificação.

Conseguir uma pessoa

Recupere as informações de uma pessoa, incluindo rostos persistentes registrados, nome e userData.

Criar um grupo de pessoas

Crie um novo grupo de pessoas com personGroupId especificado, nome e userData fornecidos pelo usuário.

Criar um grupo de pessoas (V2)

Crie um novo grupo de pessoas com personGroupId especificado, nome e userData fornecidos pelo usuário.

Criar uma lista de rostos

Crie uma lista de rostos vazia com faceListId especificado pelo usuário, nome e um userData opcional.

Criar uma lista de rostos (V2)

Crie uma lista de rostos vazia com faceListId especificado pelo usuário, nome e um userData opcional.

Criar uma pessoa

Crie uma nova pessoa em um grupo de pessoas especificado.

Criar uma pessoa (V2)

Crie uma nova pessoa em um grupo de pessoas especificado.

Detetar rostos

Detete rostos humanos em uma imagem e retorna localizações de rostos e, opcionalmente, com faceIds, pontos de referência e atributos.

Detetar rostos (V2)

Detete rostos humanos em uma imagem e retorna localizações de rostos e, opcionalmente, com faceIds, pontos de referência e atributos.

Encontrar pessoa do rosto

Verifique se dois rostos pertencem a uma mesma pessoa ou se um rosto pertence a uma pessoa.

Encontrar pessoa do rosto (V2)

Verifique se dois rostos pertencem a uma mesma pessoa ou se um rosto pertence a uma pessoa.

Obter um grupo de pessoas

Recupere as informações de um grupo de pessoas, incluindo seu nome e userData.

Obter um grupo de pessoas (V2)

Recupere as informações de um grupo de pessoas, incluindo seu nome e userData.

Obter um rosto de pessoa

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e seu personGroupId pertença.

Obter um rosto de pessoa (V2)

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e seu personGroupId pertença.

Obter uma lista de rostos

Recupere as informações de uma lista de rostos, incluindo faceListId, nome, userData e rostos na lista de rostos.

Obter uma lista de rostos (V2)

Recupere as informações de uma lista de rostos, incluindo faceListId, nome, userData e rostos na lista de rostos.

Obter uma pessoa (V2)

Recupere as informações de uma pessoa, incluindo rostos persistentes registrados, nome e userData.

Adicionar lista cara a cara

Adicionar lista cara a cara.

Parâmetros

Name Chave Necessário Tipo Description
URL da imagem
url string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Rosto alvo
targetFace string

Um retângulo facial para especificar a face alvo a ser adicionada a uma pessoa, no formato de targetFace=left,top,width,height

Dados do Utilizador
userData string

Dados especificados pelo usuário sobre a face de destino a ser adicionada para qualquer finalidade. O comprimento máximo é de 1KB.

Id da lista de rostos
faceListId True string

Caractere válido é letra em minúscula ou dígito ou '-' ou '_', comprimento máximo é 64.

Devoluções

Adicionar lista face a face (V2)

Adicionar lista cara a cara.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

URL da imagem
url string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Rosto alvo
targetFace string

Um retângulo facial para especificar a face alvo a ser adicionada a uma pessoa, no formato de targetFace=left,top,width,height

Dados do Utilizador
userData string

Dados especificados pelo usuário sobre a face de destino a ser adicionada para qualquer finalidade. O comprimento máximo é de 1KB.

Id da lista de rostos
faceListId True string

Caractere válido é letra em minúscula ou dígito ou '-' ou '_', comprimento máximo é 64.

Devoluções

Adicionar um rosto de pessoa

Adicione um rosto representativo a uma pessoa para identificação.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Grupo de pessoas

Identificação da pessoa
personId True string

Pessoa alvo à qual o rosto é adicionado.

URL da imagem
url True string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Rosto alvo
targetFace string

Um retângulo facial para especificar a face alvo a ser adicionada a uma pessoa, no formato de targetFace=left,top,width,height

Dados do Utilizador
userData string

Dados especificados pelo usuário sobre a face de destino a ser adicionada para qualquer finalidade. O comprimento máximo é de 1KB.

Devoluções

Adicionar um rosto de pessoa (V2)

Adicione um rosto representativo a uma pessoa para identificação.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

Grupo de pessoas

Identificação da pessoa
personId True string

Pessoa alvo à qual o rosto é adicionado.

URL da imagem
url True string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Rosto alvo
targetFace string

Um retângulo facial para especificar a face alvo a ser adicionada a uma pessoa, no formato de targetFace=left,top,width,height

Dados do Utilizador
userData string

Dados especificados pelo usuário sobre a face de destino a ser adicionada para qualquer finalidade. O comprimento máximo é de 1KB.

Devoluções

Conseguir uma pessoa

Recupere as informações de uma pessoa, incluindo rostos persistentes registrados, nome e userData.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas que contém a pessoa de destino.

Identificação da pessoa
personId True string

Especificar a pessoa alvo.

Devoluções

Criar um grupo de pessoas

Crie um novo grupo de pessoas com personGroupId especificado, nome e userData fornecidos pelo usuário.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Nova ID do Grupo de Pessoas (os caracteres válidos incluem números, letras inglesas em minúsculas, '-' e '_')

Nome
name True string

Nome de exibição do grupo de pessoas. O comprimento máximo é 128.

Dados do Utilizador
userData string

Dados fornecidos pelo usuário anexados ao grupo de pessoas. O limite de tamanho é de 16KB.

Criar um grupo de pessoas (V2)

Crie um novo grupo de pessoas com personGroupId especificado, nome e userData fornecidos pelo usuário.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

Nova ID do Grupo de Pessoas (os caracteres válidos incluem números, letras inglesas em minúsculas, '-' e '_')

Nome
name True string

Nome de exibição do grupo de pessoas. O comprimento máximo é 128.

Dados do Utilizador
userData string

Dados fornecidos pelo usuário anexados ao grupo de pessoas. O limite de tamanho é de 16KB.

Criar uma lista de rostos

Crie uma lista de rostos vazia com faceListId especificado pelo usuário, nome e um userData opcional.

Parâmetros

Name Chave Necessário Tipo Description
Id da lista de rostos
faceListId True string

Caractere válido é letra em minúscula ou dígito ou '-' ou '_', comprimento máximo é 64

Nome da lista de rostos
name True string

Nome da lista de rostos criada, comprimento máximo é 128.

Dados do Utilizador
userData string

Dados opcionais definidos pelo usuário para a lista de rostos. O comprimento não deve exceder 16KB.

Criar uma lista de rostos (V2)

Crie uma lista de rostos vazia com faceListId especificado pelo usuário, nome e um userData opcional.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

Id da lista de rostos
faceListId True string

Caractere válido é letra em minúscula ou dígito ou '-' ou '_', comprimento máximo é 64

Nome da lista de rostos
name True string

Nome da lista de rostos criada, comprimento máximo é 128.

Dados do Utilizador
userData string

Dados opcionais definidos pelo usuário para a lista de rostos. O comprimento não deve exceder 16KB.

Criar uma pessoa

Crie uma nova pessoa em um grupo de pessoas especificado.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas de destino para criar a pessoa.

Nome
name True string

Nome para exibição da pessoa de destino. O comprimento máximo é 128.

Dados do Utilizador
userData string

Campos opcionais para dados fornecidos pelo utilizador anexados a uma pessoa. O limite de tamanho é de 16KB.

Devoluções

Criar uma pessoa (V2)

Crie uma nova pessoa em um grupo de pessoas especificado.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas de destino para criar a pessoa.

Nome
name True string

Nome para exibição da pessoa de destino. O comprimento máximo é 128.

Dados do Utilizador
userData string

Campos opcionais para dados fornecidos pelo utilizador anexados a uma pessoa. O limite de tamanho é de 16KB.

Devoluções

Detetar rostos

Detete rostos humanos em uma imagem e retorna localizações de rostos e, opcionalmente, com faceIds, pontos de referência e atributos.

Parâmetros

Name Chave Necessário Tipo Description
URL da imagem
url True string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Devoluções

Detetar rostos (V2)

Detete rostos humanos em uma imagem e retorna localizações de rostos e, opcionalmente, com faceIds, pontos de referência e atributos.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

URL da imagem
url True string

A imagem deve ser JPEG, PNG, GIF (o primeiro quadro) ou BMP

Devoluções

Encontrar pessoa do rosto

Verifique se dois rostos pertencem a uma mesma pessoa ou se um rosto pertence a uma pessoa.

Parâmetros

Name Chave Necessário Tipo Description
Identificação do rosto
faceId True string

FaceId exclusivo do rosto detetado. Expirará 24 horas após a chamada de deteção.

ID do Grupo de Pessoas
personGroupId True string

ID do Grupo de Pessoas criado na API do Face - Ação Criar Grupo de Pessoas.

Identificação da pessoa
personId True string

ID da pessoa criada na API do Face - Ação Criar pessoa.

Devoluções

Encontrar pessoa do rosto (V2)

Verifique se dois rostos pertencem a uma mesma pessoa ou se um rosto pertence a uma pessoa.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

Identificação do rosto
faceId True string

FaceId exclusivo do rosto detetado. Expirará 24 horas após a chamada de deteção.

ID do Grupo de Pessoas
personGroupId True string

ID do Grupo de Pessoas criado na API do Face - Ação Criar Grupo de Pessoas.

Identificação da pessoa
personId True string

ID da pessoa criada na API do Face - Ação Criar pessoa.

Devoluções

Obter um grupo de pessoas

Recupere as informações de um grupo de pessoas, incluindo seu nome e userData.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

ID do Grupo da Pessoa Alvo.

Devoluções

Obter um grupo de pessoas (V2)

Recupere as informações de um grupo de pessoas, incluindo seu nome e userData.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

ID do Grupo da Pessoa Alvo.

Devoluções

Obter um rosto de pessoa

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e seu personGroupId pertença.

Parâmetros

Name Chave Necessário Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas que contém a pessoa de destino.

Identificação da pessoa
personId True string

Especificar a pessoa alvo a que o rosto pertence.

ID de rosto persistente
persistedFaceId True string

O FaceId persistente do rosto persistente do alvo da pessoa.

Devoluções

Obter um rosto de pessoa (V2)

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e seu personGroupId pertença.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas que contém a pessoa de destino.

Identificação da pessoa
personId True string

Especificar a pessoa alvo a que o rosto pertence.

ID de rosto persistente
persistedFaceId True string

O FaceId persistente do rosto persistente do alvo da pessoa.

Devoluções

Obter uma lista de rostos

Recupere as informações de uma lista de rostos, incluindo faceListId, nome, userData e rostos na lista de rostos.

Parâmetros

Name Chave Necessário Tipo Description
Id da lista de rostos
faceListId True string

faceListId da lista de rostos de destino.

Devoluções

Obter uma lista de rostos (V2)

Recupere as informações de uma lista de rostos, incluindo faceListId, nome, userData e rostos na lista de rostos.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

Id da lista de rostos
faceListId True string

faceListId da lista de rostos de destino.

Devoluções

Obter uma pessoa (V2)

Recupere as informações de uma pessoa, incluindo rostos persistentes registrados, nome e userData.

Parâmetros

Name Chave Necessário Tipo Description
Subdomínio ou Região de Recursos
subdomain True string

Subdomínio ou região geográfica do Azure (por exemplo, westus)

ID do Grupo de Pessoas
personGroupId True string

Especificar o grupo de pessoas que contém a pessoa de destino.

Identificação da pessoa
personId True string

Especificar a pessoa alvo.

Devoluções

Definições

DetectResponse

Name Caminho Tipo Description
Identificação do rosto
faceId string

FaceId exclusivo do rosto detetado. Expirará 24 horas após a chamada de deteção.

Início
faceRectangle.top integer

Parâmetros de uma área de retângulo para a localização do rosto na imagem.

Esquerda
faceRectangle.left integer

Parâmetros de uma área de retângulo para a localização do rosto na imagem.

Largura
faceRectangle.width integer

Parâmetros de uma área de retângulo para a localização do rosto na imagem.

Altura
faceRectangle.height integer

Parâmetros de uma área de retângulo para a localização do rosto na imagem.

Pupila Esquerda X
faceLandmarks.pupilLeft.x float

A coordenada x da pupila esquerda.

Pupila Esquerda Y
faceLandmarks.pupilLeft.y float

A coordenada y da pupila esquerda.

Pupila direita X
faceLandmarks.pupilRight.x float

A coordenada x da pupila certa.

Aluno direito Y
faceLandmarks.pupilRight.y float

A coordenada y do aluno certo.

Ponta do Nariz X
faceLandmarks.noseTip.x float

A coordenada x da ponta do nariz.

Ponta do Nariz Y
faceLandmarks.noseTip.y float

A coordenada y da ponta do nariz.

Boca Esquerda X
faceLandmarks.mouthLeft.x float

A coordenada x para o lado esquerdo da boca.

Boca esquerda Y
faceLandmarks.mouthLeft.y float

A coordenada y para o lado esquerdo da boca.

Boca direita X
faceLandmarks.mouthRight.x float

A coordenada x para o lado direito da boca.

Boca direita Y
faceLandmarks.mouthRight.y float

A coordenada y para o lado direito da boca.

Sobrancelha Exterior Esquerda X
faceLandmarks.eyebrowLeftOuter.x float

A coordenada x para o lado externo da sobrancelha esquerda.

Sobrancelha Exterior Esquerda Y
faceLandmarks.eyebrowLeftOuter.y float

A coordenada y para o lado externo da sobrancelha esquerda.

Sobrancelha interna esquerda X
faceLandmarks.eyebrowLeftInner.x float

A coordenada x para o lado interno da sobrancelha esquerda.

Sobrancelha interna esquerda Y
faceLandmarks.eyebrowLeftInner.y float

A coordenada y para o lado interno da sobrancelha esquerda.

Olho Externo Esquerdo X
faceLandmarks.eyeLeftOuter.x float

A coordenada x para o lado externo do olho esquerdo.

Olho Exterior Esquerdo Y
faceLandmarks.eyeLeftOuter.y float

A coordenada y para o lado externo do olho esquerdo.

Topo do Olho Esquerdo X
faceLandmarks.eyeLeftTop.x float

A coordenada x para o topo do olho esquerdo.

Topo do olho esquerdo Y
faceLandmarks.eyeLeftTop.y float

A coordenada y para o topo do olho esquerdo.

Parte inferior do olho esquerdo X
faceLandmarks.eyeLeftBottom.x float

A coordenada x para a parte inferior do olho esquerdo.

Parte inferior do olho esquerdo Y
faceLandmarks.eyeLeftBottom.y float

A coordenada y para a parte inferior do olho esquerdo.

Olho Esquerdo Interior X
faceLandmarks.eyeLeftInner.x float

A coordenada x para o lado interno do olho esquerdo.

Olho interno esquerdo Y
faceLandmarks.eyeLeftInner.y float

A coordenada y para o lado interno do olho esquerdo.

Sobrancelha Direita Interior X
faceLandmarks.eyebrowRightInner.x float

A coordenada x para o lado interno da sobrancelha direita.

Sobrancelha interna direita Y
faceLandmarks.eyebrowRightInner.y float

A coordenada y para o lado interno da sobrancelha direita.

Sobrancelha Externa Direita X
faceLandmarks.eyebrowRightOuter.x float

A coordenada x para o lado externo da sobrancelha direita.

Sobrancelha externa direita Y
faceLandmarks.eyebrowRightOuter.y float

A coordenada y para o lado externo da sobrancelha direita.

Olho direito interno X
faceLandmarks.eyeRightInner.x float

A coordenada x para o lado interno do olho direito.

Olho direito interno Y
faceLandmarks.eyeRightInner.y float

A coordenada y para o lado interno do olho direito.

Topo do olho direito X
faceLandmarks.eyeRightTop.x float

A coordenada x para o topo do olho direito.

Topo do olho direito Y
faceLandmarks.eyeRightTop.y float

A coordenada y para o topo do olho direito.

Parte inferior do olho direito X
faceLandmarks.eyeRightBottom.x float

A coordenada x para a parte inferior do olho direito.

Parte inferior do olho direito Y
faceLandmarks.eyeRightBottom.y float

A coordenada y para a parte inferior do olho direito.

Olho Externo Direito X
faceLandmarks.eyeRightOuter.x float

A coordenada x para o lado externo do olho direito.

Olho externo direito Y
faceLandmarks.eyeRightOuter.y float

A coordenada y para o lado externo do olho direito.

Raiz do nariz esquerdo X
faceLandmarks.noseRootLeft.x float

A coordenada x para o lado esquerdo da raiz do nariz.

Raiz do nariz esquerdo Y
faceLandmarks.noseRootLeft.y float

A coordenada y para o lado esquerdo da raiz do nariz.

Raiz do Nariz Direito X
faceLandmarks.noseRootRight.x float

A coordenada x para o lado direito da raiz do nariz.

Raiz do nariz direito Y
faceLandmarks.noseRootRight.y float

A coordenada y para o lado direito da raiz do nariz.

Topo do Nariz Esquerdo Altar X
faceLandmarks.noseLeftAlarTop.x float

A coordenada x para o topo do altar do nariz esquerdo.

Topo do Nariz Esquerdo Altar Y
faceLandmarks.noseLeftAlarTop.y float

A coordenada y para o topo do altar do nariz esquerdo.

Topo do Nariz Direito Altar X
faceLandmarks.noseRightAlarTop.x float

A coordenada x para o topo do altar do nariz direito.

Topo do Nariz Direito Altar Y
faceLandmarks.noseRightAlarTop.y float

A coordenada y para o topo do altar do nariz direito.

Ponta do Nariz Esquerdo Altar out X
faceLandmarks.noseLeftAlarOutTip.x float

A coordenada x para a ponta do altar do nariz esquerdo.

Ponta do Nariz Esquerdo Altar out Y
faceLandmarks.noseLeftAlarOutTip.y float

A coordenada y para a ponta do altar do nariz esquerdo/

Ponta do Nariz Direito Altar out X
faceLandmarks.noseRightAlarOutTip.x float

A coordenada x para a ponta do altar do nariz direito.

Ponta do Nariz Direito Altar out Y
faceLandmarks.noseRightAlarOutTip.y float

A coordenada y para a ponta do altar do nariz direito.

Parte superior do lábio superior X
faceLandmarks.upperLipTop.x float

A coordenada x para a parte superior do lábio superior.

Parte superior do lábio superior Y
faceLandmarks.upperLipTop.y float

A coordenada y para o topo do lábio superior.

Parte inferior do lábio superior X
faceLandmarks.upperLipBottom.x float

A coordenada x para a parte inferior do lábio superior.

Parte inferior do lábio superior Y
faceLandmarks.upperLipBottom.y float

A coordenada y para a parte inferior do lábio superior.

Parte superior do Lábio X
faceLandmarks.underLipTop.x float

A coordenada x para a parte superior do lábio inferior.

Top de Under Lip Y
faceLandmarks.underLipTop.y float

A coordenada y para o topo do lábio inferior.

Parte inferior do lábio X
faceLandmarks.underLipBottom.x float

A coordenada x para a parte inferior do lábio.

Parte inferior do Lábio Y
faceLandmarks.underLipBottom.y float

A coordenada y para a parte inferior do lábio.

Pitch de Pose de Cabeça
faceAttributes.headPose.pitch float

Campo reservado, sempre retorna 0.

Rolo de pose de cabeça
faceAttributes.headPose.roll float

Rolo da cabeça pose.

Cabeça Pose Yaw
faceAttributes.headPose.yaw float

Bocejo da cabeça posa.

Óculos
faceAttributes.glasses string

Tipo de óculos.

AddPersonFaceResponse

Name Caminho Tipo Description
ID de rosto persistente
persistedFaceId string

GetPersonGroupResponse

Name Caminho Tipo Description
ID do Grupo de Pessoas
personGroupId string
Nome
name string
userData
userData string

GetFaceListResponse

Name Caminho Tipo Description
Rostos persistentes
persistedFaces array of object
ID de rosto persistente
persistedFaces.persistedFaceId string

Id do rosto.

Dados do Utilizador
persistedFaces.userData string

Dados fornecidos pelo utilizador anexados a cada rosto.

Id da lista de rostos
faceListId string

faceListId da lista de rostos de destino.

Nome
name string

Nome de exibição da lista de rostos.

Dados do Utilizador
userData string

Dados fornecidos pelo utilizador anexados à lista de rostos.

GetPersonFaceResponse

Name Caminho Tipo Description
ID de rosto persistente
persistedFaceId string
userData
userData string

CreatePersonResponse

Name Caminho Tipo Description
Identificação da pessoa
personId string

GetPersonResponse

Name Caminho Tipo Description
Identificação da pessoa
personId string
Ids de rosto persistentes
persistedFaceIds array of object
ID de rosto persistente
persistedFaceIds.persistedFaceId string
Nome
name string
Dados do Utilizador
userData string

VerifyResponse

Name Caminho Tipo Description
É idêntico
isIdentical boolean

Verdadeiro se os dois rostos pertencem à mesma pessoa ou o rosto pertence à pessoa, caso contrário, falso.

Confiança
confidence float

Um número indica a semelhança entre se dois rostos pertencem à mesma pessoa, ou se o rosto pertence à pessoa.