Todos los productos
Search
Centro de documentos

ID Verification:FACE_COMPARE.

Última actualización: Sep 18, 2026

Integre FaceCompareV2 mediante la API del lado del servidor para comparar rostros en las imágenes que cargue.

API overview

  • Operación de la API: FaceCompareV2

  • Método de solicitud: HTTPS POST

  • Descripción: compara rostros con los datos de imagen y otra información que se envían en una llamada a la API del lado del servidor.

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

  • Endpoints:

    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, utilice el endpoint interno para acceder al servicio ID Verification. De este modo obtendrá mayor seguridad y estabilidad.

    • Optimización del acceso desde el extranjero: los entornos de red internacionales suelen ser complejos. Consulte Optimize server network latency para ajustar su integración, reducir la latencia de red y disminuir 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

    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

    China (Hong Kong)

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

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

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a llamar a las API en la plataforma OpenAPI y obtener el SDK.

Utilice OpenAPI Explorer para ejecutar y depurar esta API directamente. También sirve para generar el ejemplo de código del SDK de esta API.

Requisitos de la imagen

  • Formato de imagen: JPG, JPEG o PNG.

  • Tamaño de imagen: se recomienda un tamaño de entre 50 y 100 KB, con un máximo de 1 MB.

  • Resolución de imagen: entre 640×480 y 1920×1080 (alto × ancho). Para obtener mejores resultados, escale el lado más corto a 720 píxeles con una relación de compresión superior a 0.9. Prefiera imágenes en orientación vertical (alto mayor que el ancho), ya que las horizontales pueden reducir la precisión de detección.

    Nota

    Convertir una imagen al formato base64 aumenta su tamaño de datos. Cuando pase una imagen como base64, asegúrese de que el archivo original no supere los 0.6 MB para mantenerse dentro del límite de transferencia de datos de 1 MB.

  • Recomendaciones de calidad de imagen:

    • El rostro debe estar completo, nítido, sin obstrucciones y orientado directamente hacia la cámara. Para lograr mejores resultados, use imágenes tomadas con una cámara frontal.

    • El rostro debe ocupar más del 60 % del área de la imagen, ya que los rostros pequeños reducen la precisión de detección.

    • Si una imagen contiene varios rostros, el algoritmo procesa el más grande de forma predeterminada. Evite usar imágenes con múltiples rostros.

Request parameters

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

MerchantBizId

String

Sí

Identificador de negocio único para solucionar problemas. Admite hasta 32 caracteres alfanuméricos. Debe ser exclusivo por solicitud.

e0c34a77f5ac40a5aa5e6ed20c35****

SourceFacePicture

String

No

Nota

Elija cualquiera de los tres métodos de carga.

Cadena codificada en base64 de la imagen del rostro de origen.

Nota

Asegúrese de que el tamaño de la imagen no supere los límites especificados.

cadena base64

SourceFacePictureUrl

String

URL de la imagen del rostro de origen. Debe ser accesible públicamente mediante HTTP o HTTPS.

https://***

SourceFacePictureFile

InputStream

Flujo de archivo de la imagen del retrato.

Para conocer los métodos específicos de integración, consulte File uploads with the Advance interface.

TargetFacePicture

String

No

Nota

Elija cualquiera de los tres métodos de carga.

Cadena codificada en base64 de la imagen del rostro de destino.

Nota

Asegúrese de que el tamaño de la imagen no supere los límites especificados.

cadena base64

TargetFacePictureUrl

String

URL de la imagen del rostro de destino. Debe ser accesible públicamente mediante HTTP o HTTPS.

https://***

TargetFacePictureFile

InputStream

Imagen base para la comparación: flujo de archivo de la imagen del retrato contenida en la imagen base.

Para conocer los métodos específicos de integración, consulte File uploads with the Advance interface.

FaceQualityCheck

String

No

Habilita la inspección de calidad del rostro. Está deshabilitada de forma predeterminada. Valores válidos:

  • N: deshabilitado (valor predeterminado).

  • Y: habilitado.

Cuando se habilita, el sistema bloquea las fotografías de baja calidad (borrosas u ocultas) para evitar que se comparen. Se recomienda cuando necesita mayor precisión o desea reducir las solicitudes no válidas. Devuelve 401 (UnqualifiedPhoto) para las imágenes bloqueadas.

N

Response parameters

Parámetro

Tipo

Descripción

Ejemplo

Código de estado HTTP

Integer

Código de estado HTTP.

200

Cuerpo HTTP

RequestId

String

Identificador de la solicitud.

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

Code

String

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

Success

Message

String

Descripción detallada del código de respuesta.

success

Result.TransactionId

String

Identificador único de la solicitud de autenticación.

08573be80f944d95ac812e019e36****

Result.Passed

String

Resultado final de la autenticación. Valores válidos:

  • Y: aprobado

  • N: rechazado

Y

Result.FaceComparisonScore

String

Puntuación de comparación de rostros, en un rango de 0 a 100.

52.57