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:
NotaVentajas 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.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Asia Pacific SE 5 (Jakarta)
Endpoint público:
cloudauth-intl.ap-southeast-5.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com
China (Hong Kong)
Endpoint público:
cloudauth-intl.cn-hongkong.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
Asia Pacific SE 3 (Kuala Lumpur)
Endpoint público:
cloudauth-intl.ap-southeast-3.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com
Depuración e integración en línea
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ínimo640*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.NotaLa 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:
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.
El resultado se devuelve en | 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 | |
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. | | |
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.
| 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:
| |