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:
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, 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.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
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
China (Hong Kong)
Endpoint público:
cloudauth-intl.cn-hongkong.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
Depuración e integración en línea
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.
NotaConvertir 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:
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 | |
Result.FaceComparisonScore | String | Puntuación de comparación de rostros, en un rango de 0 a 100. | 52.57 | |