> ## Documentation Index
> Fetch the complete documentation index at: https://docs.origoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trabajando con imágenes

> Cómo enviar imágenes a los endpoints de OrigoID.

Varios endpoints (OCR Voter ID, comprobante domicilio, face match, liveness, extracción CSF con PDF) aceptan imágenes. Envíalas como **strings base64** en el campo correspondiente.

## Formato

```json theme={null}
{
  "front": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAA..."
}
```

Envía el string base64 puro. No incluyas el prefijo `data:image/...;base64,`.

## Límites

| Restricción                       | Valor                                  |
| --------------------------------- | -------------------------------------- |
| Máximo por campo de imagen / PDF  | **12 MB** (longitud del string base64) |
| Máximo total del body del request | **28 MB**                              |
| Formatos soportados               | PNG, JPG, PDF (donde aplica)           |

Requests que excedan estos límites son rechazados con `INVALID_REQUEST` y `errors[].code = "PAYLOAD_TOO_LARGE"`. El `field` apunta o al campo específico de imagen que excede 12 MB, o a `body` cuando el request completo excede 28 MB.

Endpoints con múltiples imágenes (ej. voter ID OCR con `front` + `back`, face match con `face` + `front`) comparten el cap de 28 MB del body — cada imagen mantiene su cap individual de 12 MB.

## Recomendaciones para mejores resultados

Estas son guías, no límites duros. Imágenes subóptimas se procesan igual; sólo bajan los resultados confiables.

| Recomendación                         | Por qué                                         |
| ------------------------------------- | ----------------------------------------------- |
| Tamaño \< 3 MB                        | Menor latencia, holgura debajo del cap de 12 MB |
| Resolución 1024×768 o mayor           | Mejor precisión OCR                             |
| Iluminación uniforme, mínimo brillo   | Reduce falsos negativos                         |
| Documento completo en encuadre        | Campos requeridos legibles                      |
| Calidad JPG 85 o mayor                | Balance tamaño/detalle                          |
| Comprimir antes de codificar a base64 | Base64 infla el payload \~33% sobre el binario  |

Si la extracción falla porque la imagen es ilegible, recibes un código de resultado claro (`IMAGE_UNREADABLE`, `NO_FACE_DETECTED`, `DOCUMENT_NOT_IDENTIFIED`) para que actúes.

## Privacidad

Las imágenes que envías se procesan en memoria y **nunca se persisten**. No almacenamos las imágenes ni ninguna información personal extraída de ellas. Sólo metadata operativa (timestamp, latencia, código de resultado) se conserva para auditoría.

Lee nuestra política completa de manejo de datos en [origoid.com/legal](https://origoid.com/legal).