Compartilhar via


API de Detecção Facial

A API de Detecção Facial dos Serviços Cognitivos da Microsoft permite detectar, identificar, analisar, organizar e marcar rostos em fotos.

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

Service Class Regions
Copilot Studio Standard Todas as regiões do Power Automate
Aplicativos Lógicos Standard Todas as regiões de Aplicativos Lógicos
Power Apps Standard Todas as regiões do Power Apps
Power Automate 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
Publicador Microsoft
Site 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ê obterá um ponto de extremidade e uma chave para autenticar seus aplicativos. Para fazer uma conexão, forneça a chave da conta, a URL do site e selecione Criar conexão. Para os custos de operação em sua conexão, saiba mais aqui.

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

Conectando-se à ID do Microsoft Entra

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

Operações sem suporte com a autenticação da ID do Microsoft Entra

Ao usar a autenticação do Microsoft Entra ID , há suporte apenas para ações V2. As ações preteridas continuarão a funcionar com Access Key a autenticação, mas falharão se forem usadas com uma conexão de ID do Microsoft Entra.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Chave de API Chave de API Todas as regiões Compartilhável
Padrão [PRETERIDO] Essa 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 de API

ID de autenticação: keyBasedAuth

Aplicável: todas as regiões

Chave de API

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

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

Padrão [PRETERIDO]

Aplicável: todas as regiões

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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
URL do site cadeia URL do site raiz (exemplo: https://westus.api.cognitive.microsoft.com ). Se a URL do site não especificada for padronizada como 'https://westus.api.cognitive.microsoft.com'.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 1200 60 segundos

Ações

Adicionar lista de detecção facial

Adicione a lista de detecção facial.

Adicionar lista de detecção facial (V2)

Adicione a lista de detecção facial.

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.

Criar um grupo de pessoas

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

Criar um grupo de pessoas (V2)

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

Criar uma lista de rostos

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

Criar uma lista de rostos (V2)

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

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.

Detectar faces (V2)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Detectar rostos

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Localizar a pessoa por meio do rosto

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

Localizar pessoa por meio 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 sua pessoa pertencenteGroupId.

Obter um rosto de pessoa (V2)

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e sua pessoa pertencenteGroupId.

Obter uma lista de rostos

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

Obter uma lista de rostos (V2)

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

Obter uma pessoa

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

Obter uma pessoa (V2)

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

Adicionar lista de detecção facial

Adicione a lista de detecção facial.

Parâmetros

Nome Chave Obrigatório Tipo Description
URL da Imagem
url string

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

Rosto de destino
targetFace string

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

Dados do usuário
userData string

Dados especificados pelo usuário sobre o rosto de destino a serem adicionados para qualquer finalidade. O comprimento máximo é de 1KB.

ID da Lista de Rostos
faceListId True string

O caractere válido é letra em minúsculas ou dígito ou '-' ou '_', o comprimento máximo é 64.

Retornos

Adicionar lista de detecção facial (V2)

Adicione a lista de detecção facial.

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

URL da Imagem
url string

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

Rosto de destino
targetFace string

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

Dados do usuário
userData string

Dados especificados pelo usuário sobre o rosto de destino a serem adicionados para qualquer finalidade. O comprimento máximo é de 1KB.

ID da Lista de Rostos
faceListId True string

O caractere válido é letra em minúsculas ou dígito ou '-' ou '_', o comprimento máximo é 64.

Retornos

Adicionar um rosto de pessoa

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

Grupo de pessoas

ID da pessoa
personId True string

Pessoa de destino à qual o rosto é adicionado.

URL da Imagem
url True string

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

Rosto de destino
targetFace string

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

Dados do usuário
userData string

Dados especificados pelo usuário sobre o rosto de destino a serem adicionados para qualquer finalidade. O comprimento máximo é de 1KB.

Retornos

Adicionar um rosto de pessoa (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

Grupo de pessoas

ID da pessoa
personId True string

Pessoa de destino à qual o rosto é adicionado.

URL da Imagem
url True string

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

Rosto de destino
targetFace string

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

Dados do usuário
userData string

Dados especificados pelo usuário sobre o rosto de destino a serem adicionados para qualquer finalidade. O comprimento máximo é de 1KB.

Retornos

Criar um grupo de pessoas

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

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

Nome
name True string

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

Dados do usuário
userData string

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

Criar um grupo de pessoas (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

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

Nome
name True string

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

Dados do usuário
userData string

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

Criar uma lista de rostos

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da Lista de Rostos
faceListId True string

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

Nome da Lista de Rostos
name True string

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

Dados do usuário
userData string

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

Criar uma lista de rostos (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID da Lista de Rostos
faceListId True string

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

Nome da Lista de Rostos
name True string

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

Dados do usuário
userData string

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

Criar uma pessoa

Crie uma nova pessoa em um grupo de pessoas especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

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

Nome
name True string

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

Dados do usuário
userData string

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

Retornos

Criar uma pessoa (V2)

Crie uma nova pessoa em um grupo de pessoas especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

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

Nome
name True string

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

Dados do usuário
userData string

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

Retornos

Detectar faces (V2)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

URL da Imagem
url True string

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

Retornos

Detectar rostos

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parâmetros

Nome Chave Obrigatório Tipo Description
URL da Imagem
url True string

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

Retornos

Localizar a pessoa por meio do rosto

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificação facial
faceId True string

FaceId exclusiva do rosto detectado. Expirará 24 horas após a chamada de detecção.

ID do Grupo de Pessoas
personGroupId True string

ID de Grupo de Pessoas criada na API de Detecção Facial – Ação Criar Grupo de Pessoas.

ID da pessoa
personId True string

ID de pessoa criada na API de Detecção Facial – ação Criar Pessoa.

Retornos

Localizar pessoa por meio do rosto (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

Identificação facial
faceId True string

FaceId exclusiva do rosto detectado. Expirará 24 horas após a chamada de detecção.

ID do Grupo de Pessoas
personGroupId True string

ID de Grupo de Pessoas criada na API de Detecção Facial – Ação Criar Grupo de Pessoas.

ID da pessoa
personId True string

ID de pessoa criada na API de Detecção Facial – ação Criar Pessoa.

Retornos

Obter um grupo de pessoas

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

ID do grupo de pessoas de destino.

Retornos

Obter um grupo de pessoas (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

ID do grupo de pessoas de destino.

Retornos

Obter um rosto de pessoa

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e sua pessoa pertencenteGroupId.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

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

ID da pessoa
personId True string

Especificando a pessoa de destino à qual o rosto pertence.

ID do rosto persistente
persistedFaceId True string

O persistedFaceId do rosto persistente de destino da pessoa.

Retornos

Obter um rosto de pessoa (V2)

Recupere informações sobre um rosto persistente especificado por persistedFaceId, personId e sua pessoa pertencenteGroupId.

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

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

ID da pessoa
personId True string

Especificando a pessoa de destino à qual o rosto pertence.

ID do rosto persistente
persistedFaceId True string

O persistedFaceId do rosto persistente de destino da pessoa.

Retornos

Obter uma lista de rostos

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da Lista de Rostos
faceListId True string

faceListId da lista de rostos de destino.

Retornos

Obter uma lista de rostos (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID da Lista de Rostos
faceListId True string

faceListId da lista de rostos de destino.

Retornos

Obter uma pessoa

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Grupo de Pessoas
personGroupId True string

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

ID da pessoa
personId True string

Especificando a pessoa de destino.

Retornos

Obter uma pessoa (V2)

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Subdomínio de Recurso ou Região
subdomain True string

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

ID do Grupo de Pessoas
personGroupId True string

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

ID da pessoa
personId True string

Especificando a pessoa de destino.

Retornos

Definições

DetectResponse

Nome Caminho Tipo Description
Identificação facial
faceId string

FaceId exclusiva do rosto detectado. Expirará 24 horas após a chamada de detecção.

TOP
faceRectangle.top integer

Parâmetros de uma área de retângulo para o local do rosto na imagem.

Left
faceRectangle.left integer

Parâmetros de uma área de retângulo para o local do rosto na imagem.

Largura
faceRectangle.width integer

Parâmetros de uma área de retângulo para o local do rosto na imagem.

Altura
faceRectangle.height integer

Parâmetros de uma área de retângulo para o local 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 direita.

Pupila Direita Y
faceLandmarks.pupilRight.y float

A coordenada y da pupila direita.

Ponta X do Nariz
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 externa esquerda X
faceLandmarks.eyebrowLeftOuter.x float

A coordenada x para o lado externo da sobrancelha esquerda.

Sobrancelha externa esquerda Y
faceLandmarks.eyebrowLeftOuter.y float

A coordenada y para o lado externo da sobrancelha esquerda.

Eybrow X interno esquerdo
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 Esquerdo Externo X
faceLandmarks.eyeLeftOuter.x float

A coordenada x para o lado externo do olho esquerdo.

Olho esquerdo externo Y
faceLandmarks.eyeLeftOuter.y float

A coordenada y para o lado externo do olho esquerdo.

Parte superior do olho esquerdo X
faceLandmarks.eyeLeftTop.x float

A coordenada x para a parte superior do olho esquerdo.

Parte superior do olho esquerdo Y
faceLandmarks.eyeLeftTop.y float

A coordenada y para a parte superior 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 interno X
faceLandmarks.eyeLeftInner.x float

A coordenada x para o lado interno do olho esquerdo.

Olho esquerdo interno Y
faceLandmarks.eyeLeftInner.y float

A coordenada y para o lado interno do olho esquerdo.

Eybrow X interno direito
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.

Parte superior do olho direito X
faceLandmarks.eyeRightTop.x float

A coordenada x para a parte superior do olho direito.

Parte superior do olho direito Y
faceLandmarks.eyeRightTop.y float

A coordenada y para a parte superior 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 direito externo X
faceLandmarks.eyeRightOuter.x float

A coordenada x para o lado externo do olho direito.

Olho direito externo 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 Altar X do Nariz Esquerdo
faceLandmarks.noseLeftAlarTop.x float

A coordenada x para a parte superior do altar do nariz esquerdo.

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

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

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

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

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

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

Ponta do Altar do Nariz Esquerdo Para Fora X
faceLandmarks.noseLeftAlarOutTip.x float

A coordenada x da ponta do altar do nariz esquerdo.

Ponta do Altar do Nariz Esquerdo Para Fora Y
faceLandmarks.noseLeftAlarOutTip.y float

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

Ponta do Altar do Nariz Direito Para Fora X
faceLandmarks.noseRightAlarOutTip.x float

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

Ponta do Altar do Nariz Direito Para Fora 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 a parte superior 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 de Under Lip X
faceLandmarks.underLipTop.x float

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

Parte superior de Under Lip Y
faceLandmarks.underLipTop.y float

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

Inferior de Under Lip X
faceLandmarks.underLipBottom.x float

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

Inferior de Under Lip Y
faceLandmarks.underLipBottom.y float

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

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

Campo reservado, sempre retorna 0.

Rolo de Pose da Cabeça
faceAttributes.headPose.roll float

Rolo da cabeça pose.

Cabeça Pose Yaw
faceAttributes.headPose.yaw float

Yaw da pose de cabeça.

Óculos
faceAttributes.glasses string

Tipo de óculos.

AddPersonFaceResponse

Nome Caminho Tipo Description
ID do rosto persistente
persistedFaceId string

GetPersonGroupResponse

Nome Caminho Tipo Description
ID do Grupo de Pessoas
personGroupId string
Nome
name string
dados do usuário
userData string

GetFaceListResponse

Nome Caminho Tipo Description
Rostos persistentes
persistedFaces array of object
ID do rosto persistente
persistedFaces.persistedFaceId string

Id do rosto.

Dados do usuário
persistedFaces.userData string

Dados fornecidos pelo usuário 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 usuário
userData string

Dados fornecidos pelo usuário anexados à lista de rostos.

GetPersonFaceResponse

Nome Caminho Tipo Description
ID do rosto persistente
persistedFaceId string
dados do usuário
userData string

CreatePersonResponse

Nome Caminho Tipo Description
ID da pessoa
personId string

GetPersonResponse

Nome Caminho Tipo Description
ID da pessoa
personId string
IDs de rosto persistentes
persistedFaceIds array of object
ID do rosto persistente
persistedFaceIds.persistedFaceId string
Nome
name string
Dados do usuário
userData string

VerifyResponse

Nome Caminho Tipo Description
É idêntico
isIdentical boolean

Verdadeiro se as duas faces pertencerem à mesma pessoa ou se o rosto pertencer à pessoa, caso contrário, falso.

Confiança
confidence float

Um número indica a confiança de similaridade de se dois rostos pertencem à mesma pessoa ou se o rosto pertence à pessoa.