Crear sesión de análisis GPU
Crea una nueva sesión de análisis en el servicio GPU. Devuelve un req_id que identifica la sesión y debe usarse en todas las llamadas posteriores a este servicio (WebSocket de guía en tiempo real y subida de imágenes).
Este endpoint no requiere autenticación. El mismo req_id se reutiliza para la captura del frente y del dorso del mismo documento.
Cuándo llamarlo
Antes de abrir la cámara para capturar el documento. Si el req_id ya existe en sesión, no es necesario volver a llamarlo.
Crear sesión de análisis GPU › Responses
Sesión creada correctamente
okreq_idIdentificador único de la sesión GPU. Debe conservarse para todas las llamadas siguientes.
Estado inicial de la sesión (todo en false al momento de crear)
Subir imagen del frente del documento
Sube el frame capturado del frente del documento de identidad al servicio GPU. Devuelve las URLs de las imágenes procesadas que deben enviarse al siguiente paso de extracción de datos.
Este endpoint no requiere autenticación.
Cuándo llamarlo
Después de que el WebSocket /ws-id-live confirme que el documento fue detectado correctamente (verified: true y ocr_ok: true en el mensaje recibido por el socket). El frame JPEG debe ser la imagen completa del viewport de la cámara en ese momento.
Uso de las URLs de respuesta
Los campos devueltos se pasan directamente al endpoint de extracción de datos:
| Campo respuesta GPU | Campo body extracción |
|---|---|
used_id_path | imageSrc |
used_id_raw_path | rawImageSrc |
cropped_face | croppedFaceImageSrc |
id_crop_url | croppedDocumentImageSrc |
Las URLs se concatenan con la base URL del servicio GPU: https://w7hghxo7gyc3do-3005.proxy.runpod.net{path}.
query Parameters
req_idIdentificador de la sesión GPU obtenido de POST /req/new
Subir imagen del frente del documento › Request Body
imageFrame completo de la cámara en formato JPEG (imagen sin recortar del viewport)
id_cropRecorte del área del documento extraído por el WebSocket. Campo opcional: si se omite, el servidor aplica detección automática.
Subir imagen del frente del documento › Responses
Imagen del frente procesada correctamente
okreq_idused_id_pathRuta de la imagen del frente procesada. Usar como imageSrc en el endpoint de extracción.
used_id_raw_pathRuta de la imagen original sin procesar. Usar como rawImageSrc en el endpoint de extracción.
cropped_faceRuta del recorte del rostro detectado en el documento. Usar como croppedFaceImageSrc en el endpoint de extracción.
id_crop_urlRuta del recorte del documento. Usar como croppedDocumentImageSrc en el endpoint de extracción.
Subir imagen del dorso del documento
Sube el frame capturado del dorso del documento de identidad al servicio GPU. Solo aplica para documentos que tienen reverso (cédulas, licencias de conducir, permisos). Los pasaportes no requieren este paso.
Este endpoint no requiere autenticación.
Cuándo llamarlo
Después de que el WebSocket /ws-id-back-live confirme la detección correcta del dorso (verified: true y ocr_ok: true). Se usa el mismo req_id creado al inicio del flujo de identidad.
Uso de la URL de respuesta
El campo used_id_back_path se usa como imageSrc en el endpoint de verificación de autenticidad del documento:
Code
query Parameters
req_idIdentificador de la sesión GPU obtenido de POST /req/new
Subir imagen del dorso del documento › Request Body
imageFrame completo de la cámara en formato JPEG (imagen sin recortar del viewport)
id_cropRecorte del área del dorso del documento extraído por el WebSocket. Campo opcional: si se omite, el servidor aplica detección automática.
Subir imagen del dorso del documento › Responses
Imagen del dorso procesada correctamente
okreq_idused_id_back_pathRuta de la imagen del dorso procesada. Usar como imageSrc en el endpoint de verificación de autenticidad.
Subir video de prueba de vida
Sube el clip de video grabado durante la sesión de prueba de vida al servicio GPU para su procesamiento.
Este endpoint no requiere autenticación.
Cuándo llamarlo
Después de que el WebSocket /ws-live-verification haya guiado al usuario y se haya completado la grabación de 4.8 segundos con todas las validaciones activas (cara detectada, dentro de la elipse, de frente, sin gafas).
Formato del video
El video debe grabarse con la API MediaRecorder del navegador en formato WebM:
- Codec preferido: VP9 (
video/webm;codecs=vp9) - Fallback: VP8 (
video/webm;codecs=vp8) - Framerate: 30 fps
- Duración objetivo: 4.8 segundos
Siguiente paso
Una vez subido el video, llamar a POST /liveness/analyze-liveness-session en el Queue Service para iniciar el análisis.
query Parameters
req_idIdentificador de la sesión GPU obtenido de POST /req/new
Subir video de prueba de vida › Request Body
videoClip de video en formato WebM grabado con MediaRecorder
Subir video de prueba de vida › Responses
Video subido correctamente
ok