ID_OCR_MAX es una solución de reconocimiento de documentos de identidad de ID Verification. Utiliza el modelo Qwen-VL para detectar y reconocer diversos tipos de documentos de identidad de todo el mundo.
Los tipos de documentos compatibles varían según la región debido a las limitaciones del modelo regional.
Regiones Singapore y China (Hong Kong): admiten los tipos de documentos que se listan en la tabla Document Types.
Región Indonesia (Jakarta): solo admite tarjetas de identificación indonesias y pasaportes globales (códigos de tipo de documento
IDN01001yGLB03002).Región Malaysia (Kuala Lumpur): solo admite tarjetas de identificación malayas y pasaportes globales (códigos de tipo de documento
MYS01001yGLB03002).
Endpoints del servicio
Operación de API: DocOcrMaxV2
Descripción: reconoce el tipo de documento y extrae la información de una imagen mediante el modelo Qwen-VL. Devuelve los campos correspondientes.
Método de solicitud: POST
Protocolo de transporte: HTTPS
-
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, utilice el endpoint interno para acceder al servicio ID Verification. Esto mejora la seguridad y la 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 evitar 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
China (Hong Kong)
Endpoint público:
cloudauth-intl.cn-hongkong.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.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
Depuración e integración en línea
Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a invocar las API en la plataforma OpenAPI y obtener el SDK.
Puede depurar esta operación y generar código de ejemplo del SDK en OpenAPI Explorer.
Requisitos de la imagen
Para garantizar un rendimiento estable del modelo, utilice imágenes que cumplan con los siguientes requisitos:
-
Formato de imagen: JPG, JPEG o PNG.
-
Tamaño de imagen: se recomienda un tamaño de entre 50 KB y 100 KB. El tamaño máximo es de 10 MB.
Nota -
Resolución de imagen: la altura y el ancho deben estar entre 201 y 8,191 píxeles. Se recomienda una resolución de 480×640 (alto × ancho).
-
Recomendaciones de calidad de imagen:
Las cuatro esquinas de la tarjeta deben ser visibles. No cubra ninguna parte del documento, ya que esto afecta la detección.
La imagen de la tarjeta debe ser nítida, sin obstrucciones ni reflejos, y tener la orientación correcta (sin inclinación ni rotación).
La tarjeta debe ocupar más del 60 % del área total de la imagen. Un área muy pequeña reduce la precisión del reconocimiento.
Utilice una fotografía de una tarjeta real.
Parámetros de solicitud
Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
ProductCode | String | Sí | Solución de producto que se va a utilizar. Establezca el valor en ID_OCR_MAX. | ID_OCR_MAX |
SceneCode | String | No | Identificador personalizado del escenario de autenticación. Con este identificador puede consultar los registros relacionados en la consola. El identificador admite letras, dígitos y guiones bajos, con una longitud máxima de 10 caracteres. | 1234567890 |
MerchantBizId | String | Sí | Identificador de negocio único y personalizado. Sirve para rastrear solicitudes y solucionar problemas. Debe ser único y puede contener hasta 32 caracteres combinados entre letras y dígitos. | e0c34a77f5ac40a5aa5e6ed20c35**** |
MerchantUserId | String | No | Identificador de usuario personalizado u otro dato que distinga a un usuario específico, como un número de celular o una dirección de correo electrónico. Se recomienda aplicar técnicas de ofuscación a este valor antes de enviarlo; por ejemplo, calcular su hash. | 123456789 |
IdOcrPictureBase64 | String | No. Es obligatorio usar uno de los tres métodos para cargar la imagen. | Imagen del documento de identidad codificada en base64. | base64 |
IdOcrPictureUrl | String | URL de la imagen del documento de identidad. Debe ser un enlace HTTP o HTTPS accesible públicamente. | https://***.jpg | |
IdOcrPictureFile | InputStream | Flujo de archivo de la imagen del documento de identidad. | Para conocer los métodos de integración específicos, consulte File uploads with the Advance interface. | |
OcrModel | String | No | Modo de reconocimiento OCR: Nota Los modos 1 y 2 no admiten la detección antisuplantación de documentos. Para obtener más información, consulte Recognition mode differences.
| 0 |
DocType | String | No | [Configuración de OCR] Admite los tres métodos de entrada siguientes:
Importante Los tipos de documentos compatibles varían según la región debido a las limitaciones del modelo regional.
| Ejemplos de los tres métodos de entrada:
|
DocPage | String | No | Página que se va a reconocer.
Importante Si la página detectada no coincide con la especificada, el servicio devuelve el Subcode 213. | 01 |
IdSpoof | String | No | Indica si se habilita la detección antisuplantación de documentos:
| F |
IdThreshold | String | No | Comprobación de calidad de la tarjeta mediante OCR:
| 3 |
OcrValueStandard | String | No | Indica si se devuelven campos OCR adicionales en un formato estandarizado:
Nota Para conocer los detalles sobre los tipos de documentos y los campos estandarizados compatibles, consulte Field standardization. | 0 |
Diferencias entre los modos de reconocimiento
Modo de reconocimiento OCR | Diferencias en la entrada | Diferencias en la salida | Casos de uso recomendados |
0: modo de reconocimiento de un documento específico |
| Devuelve los campos detallados del documento. Para más información, consulte Document OCR Fields. | Registro de usuarios en línea que requiere validar el tipo de documento y extraer campos detallados. |
1: modo de clasificación automática de documentos Importante Este modo de reconocimiento solo es compatible con la región Singapore. |
| Devuelve únicamente el código del tipo de documento detectado (por ejemplo, CHN01). Para obtener más información, consulte Global ID document codes. | Escenarios de análisis de negocio sin conexión para agrupar y limpiar imágenes históricas de documentos de identidad. |
2: modo de clasificación automática y reconocimiento general de documentos Importante Este modo de reconocimiento solo es compatible con la región Singapore. |
| Devuelve el código del tipo de documento (por ejemplo, CHN01) y los campos comunes clave del documento. Para más detalles, consulte Table of general recognition fields. Nota | Escenarios de revisión manual asistida sin conexión, donde reconocer el tipo de documento y sus campos clave agiliza el proceso. |
3: modo de clasificación automática por código de país o región, junto con reconocimiento de un documento específico |
| Devuelve el código del documento (por ejemplo, CHN01001) y sus campos detallados. Para más información, consulte Document OCR Fields. | Registro de usuarios en línea que requiere validar varios tipos de documentos de un país o región específica y extraer campos detallados. |
Parámetros de respuesta
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-5384F**** |
Result.TransactionId | String | Identificador único de la transacción para todo el proceso de autenticación. | hksb7ba1b28130d24e015d694**** | |
Code | String | Código de resultado. Para obtener más información, consulte Server-side HTTP status codes. | Success | |
Message | String | Descripción detallada del parámetro Code. | success | |
Result.Passed | String | Indica si el reconocimiento fue exitoso. | Y | |
Result.SubCode | String | 200 | ||
Result.ExtIdInfo | String | Resultados del OCR del documento y de la detección antisuplantación. Para más detalles, consulte ExtIdInfo. |
| |
ExtIdInfo
Parámetro | Tipo | Descripción | Ejemplo |
ocrDocType | String | El document type code o código del documento. Nota
| CHN01 |
ocrIdInfo | String | Datos de los campos OCR extraídos del documento de identidad. Nota
|
|
spoofInfo | String | Resultado de la detección antisuplantación de documentos, que incluye la decisión de riesgo y los tipos de riesgo: Nota La detección antisuplantación solo se habilita cuando IdSpoof = T. En caso contrario, spoofResult devuelve N y spoofType queda vacío.
| |
ocrStandardData | String | Datos de los campos OCR estandarizados del documento de identidad. Nota Este campo solo se devuelve si el tipo de documento es compatible y | |
Códigos de error de Result.SubCode
|
Código de error |
Facturable |
Descripción y sugerencias |
|
200 |
Sí |
La autenticación fue exitosa. |
|
211 |
Sí |
[Solución de documentos] La calidad o la resolución de la imagen no cumple con los requisitos, o bien la imagen está incompleta. Asegúrese de que la imagen del documento sea nítida, tenga una exposición adecuada, esté completa, sin obstrucciones y con la orientación correcta. |
|
212 |
Sí |
[Solución de documentos] La detección antisuplantación identificó un riesgo. Las causas posibles incluyen recaptura de pantalla, alteración o fotocopia. |
|
213 |
Sí |
[Solución de documentos] No se detectó el tipo de documento especificado (en el modo de reconocimiento de un documento específico), o no fue posible identificar el tipo de documento (en el modo de clasificación automática). Proporcione una imagen del documento nítida, completa y con la orientación correcta. |