Todos los productos
Search
Centro de documentos

ID Verification:Detección de credenciales

Última actualización: Sep 10, 2026

Este tema describe la API Credential Detection, que analiza imágenes de credenciales para detectar riesgos como falsificación, alteración, capturas de pantalla y fotografías de pantallas.

Información de la API

  • Nombre de la API: CredentialVerifyIntl

  • Descripción: detecta riesgos en las imágenes de credenciales, como falsificación, alteración, capturas de pantalla y fotografías de pantallas.

  • Método de solicitud: POST

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

  • Dirección 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 el servidor de su aplicación está desplegado en la misma región, use 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 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.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

Nota
  1. Credential Detection es un servicio predictivo basado en inteligencia artificial. Alcanza una precisión del 90 % en nuestro conjunto de datos de prueba interno. La precisión real puede variar según los escenarios específicos y las muestras de imágenes.

  2. El servicio detecta con mayor eficacia las manipulaciones en imágenes capturadas por una cámara que en imágenes generadas o editadas digitalmente.

  3. El resultado de la detección no es el único criterio para determinar la autenticidad de una credencial. Úselo como herramienta complementaria para mejorar la eficiencia de la revisión manual.

  4. Credential Detection se usa ampliamente en la revisión de documentos electrónicos para escenarios como la adquisición de pagos y el registro de comerciantes de comercio electrónico. Este servicio mejora de manera efectiva la eficiencia de la revisión manual. Si necesita otros casos de uso, comuníquese con su administrador de cuenta.

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.

Use OpenAPI Explorer para depurar esta API en línea y generar un ejemplo de código del SDK.

Parámetros de solicitud

La imagen especificada mediante el parámetro ImageUrl o ImageFileObject debe cumplir los siguientes requisitos:

  • Formato de imagen: PNG, JPG, JPEG, BMP y WebP.

  • Dimensiones de la imagen: el ancho y el alto deben ser mayores que 15 píxeles y menores que 8192 píxeles. La relación de aspecto debe ser menor que 50.

    Nota

    Para obtener resultados de detección óptimos, se recomienda que tanto el ancho como el alto de la imagen sean mayores que 500 píxeles.

  • Tamaño de la imagen: el archivo de imagen no debe superar los 10 MB si usa ImageUrl ni los 3 MB si usa ImageFileObject.

    Nota

    Las imágenes grandes aumentan el tiempo de respuesta de la API. Se recomienda usar imágenes menores que 3 MB.

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

CredType

String

Sí

Tipo de credencial. Valores válidos:

  • 03: calificación empresarial

  • 04: comprobante de transacción

03

CredName

String

Sí

Nombre de la credencial, especificado mediante un código numérico. Valores válidos:

  • Comienza con 03 para calificación empresarial:

    • 0301: licencia comercial en China continental

  • Comienza con 04 para comprobante de transacción:

    • 0401: registro de transacción bancaria

    • 0402: recibo de nómina

    • 0403: recibo de servicios públicos

    • 0405: estado de cuenta de tarjeta de crédito

    • 0499: otro

Nota

Si necesita compatibilidad con tipos de credenciales adicionales, comuníquese con su administrador de cuenta.

0301

ProductCode

String

Sí

Modo de invocación. Valor válido:

  • ANTI_FAKE_CHECK: comprobación de calidad de imagen y detección de alteraciones.

ANTI_FAKE_CHECK

ImageUrl

String

Sí

Importante

Especifique el parámetro ImageUrl o ImageFileObject.

URL de la imagen.

https://example.com/test.jpg

ImageFileObject

InputStream

Flujo del archivo de imagen.

Para cargar un archivo con este parámetro, debe invocar la operación Advance API y pasar un objeto InputStream válido. Para obtener más información, consulte Special scenario: Configure the Advance API for file uploads.

Objeto InputStream que representa la imagen.

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

RequestId

String

ID de la solicitud.

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

Code

String

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

Importante
  • Este parámetro indica si la llamada a la API fue exitosa.

  • Revise los campos de ResultObject para consultar el resultado de verificación del negocio.

Success

Message

String

Descripción detallada del código de respuesta.

success

ResultObject

Result

String

  • 0: riesgo bajo

  • 1: riesgo alto

  • 2: sospechoso

1

RiskTag

String

Etiqueta de riesgo. Varias etiquetas se separan con comas (,). Valores válidos:

  • PS: imagen editada

  • SCREEN_PHOTO: fotografía de una pantalla

  • SCREENSHOT: captura de pantalla

  • ORIGINAL_PHOTO: imagen no original

PS

RiskScore

Map<String,String>

Puntuación de riesgo predicha para cada etiqueta de riesgo. Los valores van de 0 a 1. Una puntuación más alta indica una mayor probabilidad del riesgo correspondiente.

{
  "PS": "0.0211",
  "SCREEN_PHOTO": "0.0101",
  "SCREENSHOT": "0.0521",
  "ORIGINAL_PHOTO": "0.0861"
}

MaterialInfo

String

Información adicional. Este parámetro está reservado.