Todos los productos
Search
Centro de documentos

ID Verification:ID_OCR_MAX

Última actualización: Nov 03, 2026

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.

Importante

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 IDN01001 y GLB03002).

  • Región Malaysia (Kuala Lumpur): solo admite tarjetas de identificación malayas y pasaportes globales (códigos de tipo de documento MYS01001 y GLB03002).

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:

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

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.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 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

Depuración e integración en línea

Nota

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: modo de reconocimiento de un documento específico (predeterminado)

  • 1: modo de clasificación automática de documentos

  • 2: modo de clasificación automática y reconocimiento general de documentos

  • 3: modo de clasificación automática por código de país o región, junto con reconocimiento de un documento específico

0

DocType

String

No

[Configuración de OCR] Admite los tres métodos de entrada siguientes:

  1. Especificar país o región: envíe un código de país de tres letras. El sistema recupera automáticamente los tipos de documentos compatibles dentro del alcance indicado y devuelve el código específico del documento si el reconocimiento es exitoso. Puede especificar hasta tres códigos como alcance de clasificación automática; por ejemplo, CHN, HKG y GLB. Para consultar los códigos de país de tres letras, vea Country code abbreviations.

  2. Especificar país o región y categoría de documento: envíe un código de país de tres letras y un código de categoría de documento de dos dígitos. El sistema recupera automáticamente los tipos de documentos compatibles dentro del alcance indicado y devuelve el código específico del documento si el reconocimiento es exitoso. Para consultar los códigos de tipo de documento, vea Certificate type codes.

  3. Especificar el documento exacto: envíe el código exacto del tipo de documento, formado por un código de país de tres letras y un número de documento de cinco dígitos. El sistema verifica con precisión si el documento coincide con el tipo esperado. Para consultar los códigos de tipo de documento, vea Certificate code.

Importante

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 documento IDN01001 y GLB03002).

  • Región Malaysia (Kuala Lumpur): solo admite tarjetas de identificación malayas y pasaportes globales (códigos de documento MYS01001 y GLB03002).

  • Si OcrModel = 0, el parámetro DocType es obligatorio. Debe especificar el tipo de documento.

  • Si OcrModel = 1 o 2, el sistema ignora el parámetro DocType.

  • Si OcrModel = 3, el parámetro DocType es obligatorio. Especifique un país o región, o bien un país o región junto con la categoría de documento.

Ejemplos de los tres métodos de entrada:

  • MYS: código de país de Malasia

  • MYS01: tarjeta de identidad de Malasia

  • GLB03002: pasaporte global

DocPage

String

No

Página que se va a reconocer.

  • 01 (predeterminado): lado del documento donde aparece la fotografía

  • 02: reverso del documento

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:

  • T (predeterminado): habilitada

  • F: deshabilitada

F

IdThreshold

String

No

Comprobación de calidad de la tarjeta mediante OCR:

  • 1: habilitar el modo estricto

  • 2: habilitar el modo flexible (predeterminado)

  • 3: deshabilitar

3

OcrValueStandard

String

No

Indica si se devuelven campos OCR adicionales en un formato estandarizado:

  • 0: no (predeterminado)

  • 1: sí

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

  • Debe especificar el tipo de documento y la página.

    Para consultar los tipos de documentos y las páginas compatibles, vea Document Types.

  • De manera opcional, puede habilitar la inspección de calidad de la tarjeta y la detección antisuplantación de documentos.

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.

  • No es necesario especificar el tipo de documento.

  • Puede habilitar la inspección de calidad de la tarjeta.

  • No admite la detección antisuplantación de documentos.

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.

  • No es necesario especificar el tipo de documento.

  • Puede habilitar la inspección de calidad de la tarjeta.

  • No admite la detección antisuplantación de documentos.

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

  • Debe especificar el código de país o región, o bien el país o región junto con la categoría de documento.

  • De manera opcional, puede habilitar la inspección de calidad de la tarjeta y la detección antisuplantación de documentos.

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

Result.SubCode error codes.

200

Result.ExtIdInfo

String

Resultados del OCR del documento y de la detección antisuplantación. Para más detalles, consulte ExtIdInfo.

  • OcrModel = 0:

    {
      "ocrIdInfo": {
      "expiryDate": "",
      "originOfIssue": "MPS Exit & Entry Administration",
      "englishName": "LI SI",
      "sex": "M",
      "name": "Li Si",
      "idNumber": "H11111112",
      "issueDate": "2013-01-02",
      "birthDate": "1990-02-21"
    },
      "spoofInfo":{
         "spoofResult": "Y",
         "spoofType": ["SCREEN_REMARK"]
      },
    }
  • OcrModel = 1:

    {
          "ocrDocType":"CHN01"
        }
  • OcrModel = 2:

    {
          "ocrDocType": "CHN01",
          "ocrIdInfo": {
             "given_name_s": "Jing",
             "surname_s": "Lu",
             "date_of_birth_s": "1976-05-23",
             "card_number_s": "642123197605230048",
             "sex_s": "F"
           }
        }
  • OcrModel = 3:

    {
          "ocrDocType": "CHN01001",
          "ocrIdInfo": {
          "expiryDate": "",
          "originOfIssue": "MPS Exit & Entry Administration",
          "englishName": "LI SI",
          "sex": "M",
          "name": "Li Si",
          "idNumber": "H11111112",
          "issueDate": "2013-01-02",
          "birthDate": "1990-02-21"
        },
          "spoofInfo":{
             "spoofResult": "Y",
             "spoofType": ["SCREEN_REMARK"]
          },
        }

ExtIdInfo

Parámetro

Tipo

Descripción

Ejemplo

ocrDocType

String

El document type code o código del documento.

Nota
  • Si OcrModel = 1 o 2, la API devuelve un código de tipo de documento de cinco caracteres, como CHN01.

  • Si OcrModel = 3, la API devuelve un código de documento más específico, como CHN01001.

CHN01

ocrIdInfo

String

Datos de los campos OCR extraídos del documento de identidad.

Nota
  • Este campo queda vacío si el proceso de OCR falla.

  • Este campo queda vacío si OcrModel = 1.

  • Si OcrModel = 2, este campo contiene los campos comunes del documento clasificado automáticamente.

  • Si OcrModel = 0 o 3, este campo contiene todos los campos de la página del documento.

  • OcrModel = 2

     {
         "given_name_s": "Jing",
         "surname_s": "Lu",
         "date_of_birth_s": "1976-05-23",
         "card_number_s": "642123197605230048",
         "sex_s": "F"
       }
  • OcrModel = 0 o 3

    {
          "expiryDate": "",
          "originOfIssue": "MPS Exit & Entry Administration",
          "englishName": "LI SI",
          "sex": "M",
          "name": "Li Si",
          "idNumber": "H11111112",
          "issueDate": "2013-01-02",
          "birthDate": "1990-02-21"
        }

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.

  • spoofResult:

    • Y: riesgo detectado

    • N: normal

  • spoofType:

    • SCREEN_REMARK: recaptura de pantalla

    • PHOTO_COPY: fotocopia

    • TAMPER: alteración

    • SHORTCUT: captura de pantalla

{
 "spoofResult": "Y",
 "spoofType": ["SCREEN_REMARK"]
}

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 OcrValueStandard se establece en 1.

{
        "given_name_s": "HYUNEUI",
        "surname_s": "MUN",
        "date_of_expiry_s": "2028-02-08",
        "date_of_birth_s": "1988-10-26",
        "sex_s": "M"
    }

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.