Todos los productos
Search
Centro de documentos

ID Verification:FACE_LIVENESS_MIN_PRO.

Última actualización: Oct 23, 2026

FACE_LIVENESS_MIN_PRO es un servicio de detección de vitalidad (detección de persona real) que se invoca mediante una API. Acepta imágenes faciales capturadas previamente y utiliza el modelo grande Qwen-VL para analizar el riesgo de deepfake. De esta forma, determina con precisión si la imagen de entrada corresponde a una persona real.

Aviso sobre el nivel de seguridad: los SDK para aplicaciones y web ofrecen una protección más sólida contra ataques del lado del cliente. Si su escenario de negocio exige un alto nivel de seguridad en la verificación facial de personas reales, priorice la integración del SDK. Esta solución de API está diseñada para escenarios que requieren gran flexibilidad de integración y control sobre la captura de imágenes en el frontend.

Rendimiento de la solución: antes de usar esta solución de API, evalúe a fondo la experiencia esperada del usuario final. Con base en ello, defina las políticas correspondientes de captura de imágenes y de respaldo.

  • Diferencias en la tasa de interrupción: la solución de API no cuenta con la guía en tiempo real, la coordinación de acciones ni la adaptación al entorno que ofrece el SDK del lado del cliente. Por ello, tolera menos la mala calidad de imagen y su tasa de interrupción suele ser mayor que la de la solución con SDK. La tasa de interrupción es la probabilidad de que se solicite al usuario tomar otra fotografía o de que se rechace la verificación. Esta diferencia obedece a su arquitectura técnica.

  • Recomendaciones de captura en el frontend: agregue lógica básica de recorte, detección facial y guía para la toma de fotografías en el frontend de su aplicación. Oriente a los usuarios para que capturen o carguen fotografías que cumplan con las especificaciones de entrada de imagen. Esto ayuda a reducir la tasa de interrupción desde el origen.

  • Soporte de optimización: comuníquese con su gerente de cuenta si la tasa de interrupción no cumple con sus requisitos de negocio, o si su escenario necesita tipos de imagen específicos, como ciertas capturas o fotografías tomadas a una distancia determinada. Su gerente de cuenta puede coordinar un entrenamiento personalizado del modelo con datos reales de su escenario de negocio. Este entrenamiento aumenta la tasa de aprobación del reconocimiento y reduce la tasa de interrupción sin comprometer la seguridad.

Referencia de la API

  • Nombre de la API: FaceLivenessV2

  • Método de solicitud: HTTPS POST

  • Detecta la vitalidad en imágenes faciales.

  • Límite de QPS: cada API tiene su propio límite de QPS. Para obtener más información, consulte QPS limits of ID Verification server-side APIs.

  • Endpoint del servicio:

    Nota
    • Ventajas del acceso por red interna: una red interna es una red de comunicación privada que conecta los productos de Alibaba Cloud dentro de la misma región. Si su servidor de aplicaciones está desplegado en la misma región, use el endpoint interno para acceder al servicio ID Verification. Así obtendrá mayor seguridad y estabilidad.

    • Optimización del acceso desde el extranjero: los entornos de red internacionales pueden ser complejos. Consulte Optimize server network latency para ajustar su integración y reducir la latencia de red y los errores en las solicitudes.

    Asia Pacific SE 1 (Singapore)

    • Endpoint público: cloudauth-intl.ap-southeast-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    Asia Pacific SE 5 (Jakarta)

    • Endpoint público: cloudauth-intl.ap-southeast-5.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    China (Hong Kong)

    • Endpoint público: cloudauth-intl.cn-hongkong.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    Asia Pacific SE 3 (Kuala Lumpur)

    • Endpoint público: cloudauth-intl.ap-southeast-3.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para conocer cómo invocar API en la plataforma OpenAPI y obtener el SDK.

Ejecute esta API en OpenAPI Explorer para depurarla y generar SDK Code Examples.

Requisitos de formato de la imagen facial

  • Envíe las imágenes faciales mediante uno de estos tres métodos:

    • Modo Base64: FacePictureBase64

    • Modo URL: FacePictureUrl

    • Modo flujo de archivo: FacePictureFile

  • Formato de imagen: JPG, JPEG, PNG.

  • Tamaño de imagen: se recomiendan entre 50 y 100 KB; el máximo es 1 MB.

  • Resolución de imagen: máximo 1920*1080 (alto × ancho) y mínimo 640*480 (alto × ancho). Escale el lado más corto a 720 px con una relación de compresión > 0.9. El alto debe superar al ancho, ya que la orientación horizontal puede reducir la precisión.

    Nota

    La codificación Base64 incrementa el tamaño del archivo. Mantenga la imagen original por debajo de 0.6 MB para respetar el límite de transferencia de 1 MB.

  • Especificaciones de entrada de imagen

    Este producto funciona únicamente mediante llamadas a la API. La precisión de la detección depende de la calidad y la composición de la imagen de entrada. Asegúrese de que las fotografías faciales de entrada cumplan con los siguientes requisitos.

    Tipos de imagen recomendados

    • Primeros planos o fotografías de medio cuerpo: utilice imágenes con un tamaño y una relación de aspecto similares a las fotografías faciales estándar capturadas en modo SDK. Se prefieren las imágenes tomadas con la cámara frontal.

    • Proporción adecuada entre el rostro y la imagen: el rostro debe ocupar más del 60 % del área total de la imagen. Los rasgos faciales deben verse con claridad y sin obstrucciones importantes.

    • Iluminación uniforme: evite imágenes sobreexpuestas, subexpuestas o con iluminación visiblemente desigual.

    Tipos de imagen no admitidos o problemáticos

    No envíe directamente a la API los siguientes tipos de imagen, ya que pueden reducir la precisión de la detección o impedir una evaluación válida.

    • Fotografías de cuerpo completo: el rostro resulta demasiado pequeño en la imagen y aporta información insuficiente sobre los rasgos faciales.

    • Fotografías de una persona sosteniendo una identificación: la imagen contiene un fondo complejo y otros objetos que pueden interferir con la evaluación de amenazas de falsificación.

    • Fotografías de un documento de identidad: los retratos estáticos de documentos, como credenciales o pasaportes, son imágenes secundarias. Estas imágenes pueden provocar detecciones incorrectas o con errores.

    • Fotografías grupales: la imagen contiene varios rostros, lo que impide definir un objetivo de detección claro.

Parámetros de solicitud

Nombre

Tipo

Obligatorio

Descripción

Ejemplo

ProductCode

String

Sí

Código de la solución del producto. Valor fijo: FACE_LIVENESS_MIN_PRO.

FACE_LIVENESS_MIN_PRO

MerchantBizId

String

Sí

Identificador de negocio personalizado para seguimiento. Letras y dígitos, máximo 32 caracteres. Debe ser único.

Nota

La unicidad no se valida en el servidor. Asegúrese de usar valores únicos para garantizar un seguimiento preciso.

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

Sí

Identificador de usuario personalizado (por ejemplo, número de celular o correo electrónico). Aplique un hash a este valor antes de enviarlo.

123456789

FacePictureBase64

String

No

Imagen facial codificada en Base64. Compruebe el tamaño antes de enviarla para no exceder el límite de 1 MB.

base64

FacePictureUrl

String

No

URL de acceso público de la imagen facial.

https://***

FacePictureFile

InputStream

No

Imagen facial como flujo de archivo.

Objeto InputStream de la imagen facial.

FaceQualityCheck

String

No

Habilita la inspección de calidad facial. Deshabilitada de forma predeterminada. Valores válidos:

  • N: deshabilitada (predeterminado).

  • Y: habilitada.

Cuando está habilitada, el sistema bloquea las fotografías de baja calidad (borrosas u ocluidas) para que no se incluyan en la comparación. Recomendado cuando se requiere mayor precisión o para reducir solicitudes no válidas. Devuelve 401 (UnqualifiedPhoto) para las imágenes bloqueadas.

N

FaceAttributeCheck

String

No

Configuración de reconocimiento facial: indica si se devuelven atributos faciales adicionales.

  • N: no (predeterminado)

  • Y: sí se devuelven.

El resultado se devuelve en Checkresult, dentro de Result.ExtFaceInfo.faceAttributeInfo.

N

Datos de respuesta

Nombre

Tipo

Descripción

Ejemplo

HTTP Status Code

Integer

Código de estado HTTP.

200

HTTP Body

RequestId

String

ID de la solicitud.

130A2C10-B9EE-4D84-88E3-5384FF0****

Result.TransactionId

String

ID único del proceso de verificación.

hksb7ba1b28130d24e015d694361****

Code

String

Código de retorno. Para obtener más información, consulte Server-side HTTP status codes.

Success

Message

String

Esta sección proporciona descripciones detalladas de los códigos de retorno.

Success

Result.Passed

String

Resultado de la autenticación:

  • Y: aprobada.

  • N: con errores.

Y

Result.SubCode

String

Descripción del resultado de la autenticación. Para obtener más información, consulte ResultObject.SubCode error codes.

200

Result.ExtFaceInfo

Object

Detalles de la detección de vitalidad silenciosa en formato JSON. Campos: ExtFaceInfo Fields.

{
  "FaceQualityScore": 76.69,
  "OcclusionResult": "N",
  "FaceAttack": "Y",
  "SharpnessScore": 60.78,
  "KaOcclusionScore": 100,
  "FaceGender": "M",
  "OcclusionScore": 99.99,
  "FaceAge": 28,
  "IlluminationScore": 97.43
}

Códigos de error de ResultObject.SubCode

Código de error

Facturado

Descripción y sugerencia

200

Sí

La autenticación se aprobó.

205

Sí

Se detectó un riesgo durante la detección de vitalidad.

ExtFaceInfo

Nombre

Tipo

Descripción

Ejemplo

FaceQualityScore

Double

Puntuación de calidad facial. Rango: de 0 a 100. Un valor más alto indica mejor calidad.

88.62

OcclusionScore

Double

Subpuntuación de oclusión. Rango: de 0 a 100. Un valor más alto indica mejor calidad.

99.99

KaOcclusionScore

Double

Subpuntuación de oclusión en áreas clave. Rango: de 0 a 100. Un valor más alto indica mejor calidad.

100

IlluminationScore

Double

Subpuntuación de iluminación. Rango: de 0 a 100. Un valor más alto indica mejor calidad.

97.43

SharpnessScore

Double

Subpuntuación de nitidez. Rango: de 0 a 100. Un valor más alto indica mejor calidad.

60.78

FaceAttack

String

Indica si se detectó un ataque de suplantación de vitalidad.

  • Y: se detectó un ataque.

  • N: no se detectó ningún ataque.

N

FaceAttributeInfo

String

Detecta los atributos faciales del rostro principal en una imagen de entrada. El rostro principal es el más grande, nítido y cercano a la cámara. Los resultados de la detección se devuelven como una cadena. Puede usar esta cadena para tomar decisiones sobre el contenido.

Los campos devueltos se definen de la siguiente manera:

  • gender: el género de la entidad principal. Un valor de 1 indica masculino y 0 indica femenino.

  • glasses: indica si la entidad principal usa lentes. Un valor de 1 indica que se detectaron lentes y 0 que no.

  • hat: indica si la entidad principal usa sombrero o gorra. Incluye pañoletas o velos. Un valor de 1 indica que se detectó un sombrero o gorra y 0 que no.

  • mask: indica si la entidad principal usa cubrebocas. Un valor de 1 indica que se detectó un cubrebocas y 0 que no.

  • tattoo: indica si la entidad principal tiene un tatuaje visible. Un valor de 1 indica que se detectó un tatuaje y 0 que no.

  • smoking: indica si la entidad principal está fumando. Un valor de 1 indica que se detectó que está fumando y 0 que no.

  • others: indica si hay personas distintas a la entidad principal. Un valor de 1 indica que se detectaron otras personas y 0 que no.

  • env: el entorno de la entidad principal, como una oficina, fábrica, hospital o vehículo. Actualmente, el sistema admite devolver office, hospital, factory, vehicle u other.

  • expression: indica si la entidad principal muestra una expresión exagerada. Una expresión exagerada es un gesto facial intenso que difiere de un estado natural o tranquilo. Un valor de 1 indica que se detectó una expresión exagerada y 0 que no.

  • age: la edad de la entidad principal en años.

{
        gender: 1
        glasses: 0
        hat: 1
        mask: 1
        tattoo: 0
        smoking: 0
        others: 1
        env:office
        expression:1
        age:16
}