Compartir a través de


API de Reconocimiento Facial

Face API de Microsoft Cognitive Services permite detectar, identificar, analizar, organizar y etiquetar caras en fotos.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones de Power Automate
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps
Power Apps Estándar Todas las regiones de Power Apps
Power Automate Estándar Todas las regiones de Power Automate
Contacto
Nombre Microsoft
URL Compatibilidad con Microsoft LogicApps
Soporte técnico de Microsoft Power Automate
Soporte técnico de Microsoft Power Apps
Metadatos del conector
Publicador Microsoft
Sitio web https://azure.microsoft.com/services/cognitive-services/face/

Para usar esta integración, necesitará un recurso de Cognitive Service en Azure Portal. Obtendrá un punto de conexión y una clave para autenticar las aplicaciones. Para establecer una conexión, proporcione la clave de cuenta, la dirección URL del sitio y seleccione Crear conexión. Para los costos de operación en la conexión, obtenga más información aquí.

Ya está listo para empezar a usar esta integración.

Conexión con el identificador de Entra de Microsoft

Para crear conexiones con el identificador de Entra de Microsoft, debe agregar el rol de usuario de Cognitive Services a su cuenta para acceder. Para usar esta conexión, debe escribir el subdominio único asociado wih el recurso de Cognitive Services en las operaciones auxiliares.

Operaciones no compatibles con la autenticación de Id. de Microsoft Entra

Cuando se usa la autenticación de id. de Microsoft Entra , solo se admiten las acciones V2. Las acciones en desuso seguirán funcionando con Access Key la autenticación, pero se producirá un error si se usa con una conexión de Id. de Entra de Microsoft.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Clave de API Clave de API Todas las regiones Compartible
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Clave de API

Identificador de autenticación: keyBasedAuth

Aplicable: Todas las regiones

Clave de API

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre Tipo Description Obligatorio
Clave de cuenta securestring Clave de cuenta de Cognitive Services
Dirección URL del sitio cuerda / cadena Dirección URL del sitio raíz (ejemplo: https://westus.api.cognitive.microsoft.com)

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring Clave de API Cierto
Dirección URL del sitio cuerda / cadena Dirección URL del sitio raíz (ejemplo: https://westus.api.cognitive.microsoft.com ). Si no se especifica la dirección URL del sitio, el valor predeterminado es "https://westus.api.cognitive.microsoft.com".

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 1200 60 segundos

Acciones

Agregar cara a lista de caras

Agregar cara a lista de caras.

Agregar cara a lista de caras (V2)

Agregar cara a lista de caras.

Agregar una cara de persona

Agregue una cara representativa a una persona para su identificación.

Agregar una cara de persona (V2)

Agregue una cara representativa a una persona para su identificación.

Buscar persona desde la cara

Compruebe si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Buscar persona desde la cara (V2)

Compruebe si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Creación de un grupo de personas

Cree un nuevo grupo de personas con personGroupId, nombre y userData proporcionados por el usuario especificados.

Crear un grupo de personas (V2)

Cree un nuevo grupo de personas con personGroupId, nombre y userData proporcionados por el usuario especificados.

Crear una lista de caras

Cree una lista de caras vacía con faceListId, name y opcional userData especificados por el usuario.

Crear una lista de caras (V2)

Cree una lista de caras vacía con faceListId, name y opcional userData especificados por el usuario.

Crear una persona

Cree una nueva persona en un grupo de personas especificado.

Crear una persona (V2)

Cree una nueva persona en un grupo de personas especificado.

Detección de caras

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Detección de caras (V2)

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Obtener un grupo de personas

Recupere la información de un grupo de personas, incluido su nombre y userData.

Obtener un grupo de personas (V2)

Recupere la información de un grupo de personas, incluido su nombre y userData.

Obtener una cara de persona

Recupere información sobre una cara persistente especificada por persistedFaceId, personId y su personGroupId perteneciente.

Obtener una cara de persona (V2)

Recupere información sobre una cara persistente especificada por persistedFaceId, personId y su personGroupId perteneciente.

Obtener una lista de caras

Recupere la información de una lista de caras, incluidos faceListId, name, userData y faces en la lista de caras.

Obtener una lista de caras (V2)

Recupere la información de una lista de caras, incluidos faceListId, name, userData y faces en la lista de caras.

Obtener una persona

Recupere la información de una persona, incluidas las caras persistentes registradas, el nombre y userData.

Obtener una persona (V2)

Recupere la información de una persona, incluidas las caras persistentes registradas, el nombre y userData.

Agregar cara a lista de caras

Agregar cara a lista de caras.

Parámetros

Nombre Clave Requerido Tipo Description
Dirección URL de la imagen
url string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Cara de destino
targetFace string

Rectángulo facial para especificar la cara de destino que se va a agregar a una persona, en el formato targetFace=left,top,width,height

Datos de usuario
userData string

Datos especificados por el usuario sobre la cara de destino que se van a agregar para cualquier propósito. La longitud máxima es de 1 KB.

Id. de lista de caras
faceListId True string

El carácter válido es una letra en minúsculas o un dígito o '-' o '_', la longitud máxima es 64.

Devoluciones

Agregar cara a lista de caras (V2)

Agregar cara a lista de caras.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Dirección URL de la imagen
url string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Cara de destino
targetFace string

Rectángulo facial para especificar la cara de destino que se va a agregar a una persona, en el formato targetFace=left,top,width,height

Datos de usuario
userData string

Datos especificados por el usuario sobre la cara de destino que se van a agregar para cualquier propósito. La longitud máxima es de 1 KB.

Id. de lista de caras
faceListId True string

El carácter válido es una letra en minúsculas o un dígito o '-' o '_', la longitud máxima es 64.

Devoluciones

Agregar una cara de persona

Agregue una cara representativa a una persona para su identificación.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Grupo de personas

Id. de persona
personId True string

Persona de destino a la que se agrega la cara.

Dirección URL de la imagen
url True string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Cara de destino
targetFace string

Rectángulo facial para especificar la cara de destino que se va a agregar a una persona, en el formato targetFace=left,top,width,height

Datos de usuario
userData string

Datos especificados por el usuario sobre la cara de destino que se van a agregar para cualquier propósito. La longitud máxima es de 1 KB.

Devoluciones

Agregar una cara de persona (V2)

Agregue una cara representativa a una persona para su identificación.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Grupo de personas

Id. de persona
personId True string

Persona de destino a la que se agrega la cara.

Dirección URL de la imagen
url True string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Cara de destino
targetFace string

Rectángulo facial para especificar la cara de destino que se va a agregar a una persona, en el formato targetFace=left,top,width,height

Datos de usuario
userData string

Datos especificados por el usuario sobre la cara de destino que se van a agregar para cualquier propósito. La longitud máxima es de 1 KB.

Devoluciones

Buscar persona desde la cara

Compruebe si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de cara
faceId True string

FaceId único de la cara detectada. Expirará 24 horas después de la llamada de detección.

Id. de grupo de personas
personGroupId True string

Identificador de grupo de personas creado en Face API: acción Crear grupo de personas.

Id. de persona
personId True string

Id. de persona creado en Face API: acción Crear persona.

Devoluciones

Buscar persona desde la cara (V2)

Compruebe si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de cara
faceId True string

FaceId único de la cara detectada. Expirará 24 horas después de la llamada de detección.

Id. de grupo de personas
personGroupId True string

Identificador de grupo de personas creado en Face API: acción Crear grupo de personas.

Id. de persona
personId True string

Id. de persona creado en Face API: acción Crear persona.

Devoluciones

Creación de un grupo de personas

Cree un nuevo grupo de personas con personGroupId, nombre y userData proporcionados por el usuario especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Nuevo identificador de grupo de personas (los caracteres válidos incluyen números, letras en inglés en minúsculas, "-" y "_")

Nombre
name True string

Nombre para mostrar del grupo de personas. La longitud máxima es 128.

Datos de usuario
userData string

Datos proporcionados por el usuario adjuntos al grupo de personas. El límite de tamaño es de 16 KB.

Crear un grupo de personas (V2)

Cree un nuevo grupo de personas con personGroupId, nombre y userData proporcionados por el usuario especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Nuevo identificador de grupo de personas (los caracteres válidos incluyen números, letras en inglés en minúsculas, "-" y "_")

Nombre
name True string

Nombre para mostrar del grupo de personas. La longitud máxima es 128.

Datos de usuario
userData string

Datos proporcionados por el usuario adjuntos al grupo de personas. El límite de tamaño es de 16 KB.

Crear una lista de caras

Cree una lista de caras vacía con faceListId, name y opcional userData especificados por el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de lista de caras
faceListId True string

El carácter válido es letra en minúsculas o dígitos o "-" o "_", la longitud máxima es 64.

Nombre de la lista de caras
name True string

Nombre de la lista de caras creada, la longitud máxima es 128.

Datos de usuario
userData string

Datos opcionales definidos por el usuario para la lista de caras. La longitud no debe superar los 16 KB.

Crear una lista de caras (V2)

Cree una lista de caras vacía con faceListId, name y opcional userData especificados por el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de lista de caras
faceListId True string

El carácter válido es letra en minúsculas o dígitos o "-" o "_", la longitud máxima es 64.

Nombre de la lista de caras
name True string

Nombre de la lista de caras creada, la longitud máxima es 128.

Datos de usuario
userData string

Datos opcionales definidos por el usuario para la lista de caras. La longitud no debe superar los 16 KB.

Crear una persona

Cree una nueva persona en un grupo de personas especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas de destino para crear la persona.

Nombre
name True string

Nombre para mostrar de la persona de destino. La longitud máxima es 128.

Datos de usuario
userData string

Campos opcionales para los datos proporcionados por el usuario adjuntos a una persona. El límite de tamaño es de 16 KB.

Devoluciones

Crear una persona (V2)

Cree una nueva persona en un grupo de personas especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas de destino para crear la persona.

Nombre
name True string

Nombre para mostrar de la persona de destino. La longitud máxima es 128.

Datos de usuario
userData string

Campos opcionales para los datos proporcionados por el usuario adjuntos a una persona. El límite de tamaño es de 16 KB.

Devoluciones

Detección de caras

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parámetros

Nombre Clave Requerido Tipo Description
Dirección URL de la imagen
url True string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Devoluciones

Productos
DetectResponse

Detección de caras (V2)

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Dirección URL de la imagen
url True string

La imagen debe ser JPEG, PNG, GIF (el primer fotograma) o BMP

Devoluciones

Productos
DetectResponse

Obtener un grupo de personas

Recupere la información de un grupo de personas, incluido su nombre y userData.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Id. de grupo de personas de destino.

Devoluciones

Obtener un grupo de personas (V2)

Recupere la información de un grupo de personas, incluido su nombre y userData.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Id. de grupo de personas de destino.

Devoluciones

Obtener una cara de persona

Recupere información sobre una cara persistente especificada por persistedFaceId, personId y su personGroupId perteneciente.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas que contiene la persona de destino.

Id. de persona
personId True string

Especificar la persona de destino a la que pertenece la cara.

Identificador de cara persistente
persistedFaceId True string

PersistedFaceId de la cara persistente de destino de la persona.

Devoluciones

Obtener una cara de persona (V2)

Recupere información sobre una cara persistente especificada por persistedFaceId, personId y su personGroupId perteneciente.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas que contiene la persona de destino.

Id. de persona
personId True string

Especificar la persona de destino a la que pertenece la cara.

Identificador de cara persistente
persistedFaceId True string

PersistedFaceId de la cara persistente de destino de la persona.

Devoluciones

Obtener una lista de caras

Recupere la información de una lista de caras, incluidos faceListId, name, userData y faces en la lista de caras.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de lista de caras
faceListId True string

faceListId de la lista de caras de destino.

Devoluciones

Obtener una lista de caras (V2)

Recupere la información de una lista de caras, incluidos faceListId, name, userData y faces en la lista de caras.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de lista de caras
faceListId True string

faceListId de la lista de caras de destino.

Devoluciones

Obtener una persona

Recupere la información de una persona, incluidas las caras persistentes registradas, el nombre y userData.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas que contiene la persona de destino.

Id. de persona
personId True string

Especificar la persona de destino.

Devoluciones

Obtener una persona (V2)

Recupere la información de una persona, incluidas las caras persistentes registradas, el nombre y userData.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio de recursos o región
subdomain True string

Subdominio de Azure o región geográfica (por ejemplo, westus)

Id. de grupo de personas
personGroupId True string

Especificar el grupo de personas que contiene la persona de destino.

Id. de persona
personId True string

Especificar la persona de destino.

Devoluciones

Definiciones

DetectResponse

Nombre Ruta de acceso Tipo Description
Id. de cara
faceId string

FaceId único de la cara detectada. Expirará 24 horas después de la llamada de detección.

Arriba
faceRectangle.top integer

Parámetros de un área de rectángulo para la ubicación de la cara en la imagen.

Left
faceRectangle.left integer

Parámetros de un área de rectángulo para la ubicación de la cara en la imagen.

Ancho
faceRectangle.width integer

Parámetros de un área de rectángulo para la ubicación de la cara en la imagen.

Altura
faceRectangle.height integer

Parámetros de un área de rectángulo para la ubicación de la cara en la imagen.

Pupila izquierda X
faceLandmarks.pupilLeft.x float

Coordenada x del alumno izquierdo.

Pupila izquierda Y
faceLandmarks.pupilLeft.y float

Coordenada y del alumno izquierdo.

Pupila derecha X
faceLandmarks.pupilRight.x float

Coordenada x del alumno derecho.

Pupila derecha Y
faceLandmarks.pupilRight.y float

Coordenada y del alumno derecho.

Punta de nariz X
faceLandmarks.noseTip.x float

Coordenada x de la punta de la nariz.

Punta de nariz Y
faceLandmarks.noseTip.y float

Coordenada y de la punta de la nariz.

Boca izquierda X
faceLandmarks.mouthLeft.x float

Coordenada x del lado izquierdo de la boca.

Boca izquierda Y
faceLandmarks.mouthLeft.y float

Coordenada y del lado izquierdo de la boca.

Boca derecha X
faceLandmarks.mouthRight.x float

Coordenada x para el lado derecho de la boca.

Boca derecha Y
faceLandmarks.mouthRight.y float

Coordenada y para el lado derecho de la boca.

Ceja izquierda externa X
faceLandmarks.eyebrowLeftOuter.x float

Coordenada x para el lado exterior de la ceja izquierda.

Ceja izquierda exterior Y
faceLandmarks.eyebrowLeftOuter.y float

Coordenada y para el lado exterior de la ceja izquierda.

Eybrow X interno izquierdo
faceLandmarks.eyebrowLeftInner.x float

Coordenada x para el lado interior de la ceja izquierda.

Ceja interna izquierda Y
faceLandmarks.eyebrowLeftInner.y float

Coordenada y para el lado interior de la ceja izquierda.

Ojo izquierdo exterior X
faceLandmarks.eyeLeftOuter.x float

Coordenada x del lado exterior del ojo izquierdo.

Ojo izquierdo exterior Y
faceLandmarks.eyeLeftOuter.y float

Coordenada y para el lado exterior del ojo izquierdo.

Parte superior del ojo izquierdo X
faceLandmarks.eyeLeftTop.x float

Coordenada x para la parte superior del ojo izquierdo.

Arriba del ojo izquierdo Y
faceLandmarks.eyeLeftTop.y float

Coordenada Y para la parte superior del ojo izquierdo.

Parte inferior del ojo izquierdo X
faceLandmarks.eyeLeftBottom.x float

Coordenada x para la parte inferior del ojo izquierdo.

Parte inferior del ojo izquierdo Y
faceLandmarks.eyeLeftBottom.y float

Coordenada Y para la parte inferior del ojo izquierdo.

Ojo izquierdo interno X
faceLandmarks.eyeLeftInner.x float

Coordenada x del lado interno del ojo izquierdo.

Ojo izquierdo interno Y
faceLandmarks.eyeLeftInner.y float

Coordenada Y para el lado interno del ojo izquierdo.

Eybrow X interno derecho
faceLandmarks.eyebrowRightInner.x float

Coordenada x para el lado interior de la ceja derecha.

Ceja interna derecha Y
faceLandmarks.eyebrowRightInner.y float

Coordenada y para el lado interior de la ceja derecha.

Ceja externa derecha X
faceLandmarks.eyebrowRightOuter.x float

Coordenada x para el lado exterior de la ceja derecha.

Ceja externa derecha Y
faceLandmarks.eyebrowRightOuter.y float

Coordenada y para el lado exterior de la ceja derecha.

Ojo derecho interno X
faceLandmarks.eyeRightInner.x float

Coordenada x del lado interno del ojo derecho.

Ojo derecho interno Y
faceLandmarks.eyeRightInner.y float

Coordenada y del lado interno del ojo derecho.

Parte superior del ojo derecho X
faceLandmarks.eyeRightTop.x float

Coordenada x para la parte superior del ojo derecho.

Arriba del ojo derecho Y
faceLandmarks.eyeRightTop.y float

Coordenada Y para la parte superior del ojo derecho.

Parte inferior del ojo derecho X
faceLandmarks.eyeRightBottom.x float

Coordenada x para la parte inferior del ojo derecho.

Abajo del ojo derecho Y
faceLandmarks.eyeRightBottom.y float

Coordenada y para la parte inferior del ojo derecho.

Ojo derecho exterior X
faceLandmarks.eyeRightOuter.x float

Coordenada x para el lado exterior del ojo derecho.

Ojo derecho exterior Y
faceLandmarks.eyeRightOuter.y float

Coordenada y para el lado exterior del ojo derecho.

Raíz izquierda de la nariz X
faceLandmarks.noseRootLeft.x float

Coordenada x para el lado izquierdo de la raíz de la nariz.

Raíz izquierda de la nariz Y
faceLandmarks.noseRootLeft.y float

Coordenada y del lado izquierdo de la raíz de la nariz.

Raíz derecha de la nariz X
faceLandmarks.noseRootRight.x float

Coordenada x para el lado derecho de la raíz de la nariz.

Raíz derecha de la nariz Y
faceLandmarks.noseRootRight.y float

Coordenada y para el lado derecho de la raíz de la nariz.

Top of Left Nose Altar X
faceLandmarks.noseLeftAlarTop.x float

Coordenada x para la parte superior del altar izquierdo de la nariz.

Arriba de la nariz izquierda Altar Y
faceLandmarks.noseLeftAlarTop.y float

Coordenada y para la parte superior del altar izquierdo de la nariz.

Parte superior del altar de la nariz derecha X
faceLandmarks.noseRightAlarTop.x float

Coordenada x para la parte superior del altar de la nariz derecha.

Arriba del altar de la nariz derecha Y
faceLandmarks.noseRightAlarTop.y float

Coordenada y para la parte superior del altar de la nariz derecha.

Punta del altar izquierdo de la nariz hacia fuera X
faceLandmarks.noseLeftAlarOutTip.x float

Coordenada x para punta del altar izquierdo de la nariz.

Punta del altar izquierdo de la nariz hacia fuera Y
faceLandmarks.noseLeftAlarOutTip.y float

Coordenada y para la punta del altar izquierdo de la nariz/

Punta del altar de la nariz derecha fuera X
faceLandmarks.noseRightAlarOutTip.x float

Coordenada x para punta del altar de la nariz derecha.

Punta del altar de la nariz derecha fuera Y
faceLandmarks.noseRightAlarOutTip.y float

Coordenada y para punta del altar de la nariz derecha.

Parte superior del labio superior X
faceLandmarks.upperLipTop.x float

Coordenada x para la parte superior del labio superior.

Parte superior del labio superior Y
faceLandmarks.upperLipTop.y float

Coordenada y para la parte superior del labio superior.

Parte inferior del labio superior X
faceLandmarks.upperLipBottom.x float

Coordenada x para la parte inferior del labio superior.

Parte inferior del labio superior Y
faceLandmarks.upperLipBottom.y float

Coordenada y para la parte inferior del labio superior.

Parte superior debajo del labio X
faceLandmarks.underLipTop.x float

Coordenada x para la parte superior del labio inferior.

Parte superior de bajo labio Y
faceLandmarks.underLipTop.y float

Coordenada y para la parte superior del labio inferior.

Parte inferior debajo del labio X
faceLandmarks.underLipBottom.x float

Coordenada x para la parte inferior del labio inferior.

Parte inferior de bajo labio Y
faceLandmarks.underLipBottom.y float

Coordenada y para la parte inferior del labio.

Inclinación de la posición de la cabeza
faceAttributes.headPose.pitch float

Campo reservado, siempre devuelve 0.

Rollo de posición de la cabeza
faceAttributes.headPose.roll float

Rollo de la posición de la cabeza.

Posición de la cabeza Yaw
faceAttributes.headPose.yaw float

Guiñada de la posición de la cabeza.

Gafas
faceAttributes.glasses string

Tipo de gafas.

AddPersonFaceResponse

Nombre Ruta de acceso Tipo Description
Identificador de cara persistente
persistedFaceId string

GetPersonGroupResponse

Nombre Ruta de acceso Tipo Description
Id. de grupo de personas
personGroupId string
Nombre
name string
userData
userData string

GetFaceListResponse

Nombre Ruta de acceso Tipo Description
Caras persistentes
persistedFaces array of object
Identificador de cara persistente
persistedFaces.persistedFaceId string

Id. de la cara.

Datos de usuario
persistedFaces.userData string

Datos proporcionados por el usuario adjuntos a cada cara.

Id. de lista de caras
faceListId string

faceListId de la lista de caras de destino.

Nombre
name string

Nombre para mostrar de la lista de caras.

Datos de usuario
userData string

Datos proporcionados por el usuario adjuntos a la lista de caras.

GetPersonFaceResponse

Nombre Ruta de acceso Tipo Description
Identificador de cara persistente
persistedFaceId string
userData
userData string

CreatePersonResponse

Nombre Ruta de acceso Tipo Description
Id. de persona
personId string

GetPersonResponse

Nombre Ruta de acceso Tipo Description
Id. de persona
personId string
Identificadores de caras persistentes
persistedFaceIds array of object
Identificador de cara persistente
persistedFaceIds.persistedFaceId string
Nombre
name string
Datos de usuario
userData string

VerifyResponse

Nombre Ruta de acceso Tipo Description
Es idéntico
isIdentical boolean

Verdadero si las dos caras pertenecen a la misma persona o la cara pertenece a la persona, de lo contrario falso.

Confianza
confidence float

Un número indica la confianza de similitud de si dos caras pertenecen a la misma persona o si la cara pertenece a la persona.