Skip to main content
FreeAIOCR logoFreeAIOCR
Documentación de API

Resumen de la API

Integra reconocimiento de texto y extracción de tablas con una clave API y un saldo compartidos, con facturación por uso.

APIAPI KeysFacturación de API

Elegir API

  • Imagen a texto

    Extrae documentos como Markdown en JSON, texto plano en JSON o Word editable.

    POST /api/v1/image-to-text
  • Imagen a tabla

    Extrae estructuras de tablas como JSON, CSV o Excel.

    POST /api/v1/image-to-table

Usa la API de FreeAIOCR para reconocer texto o extraer tablas de imágenes. Consulta las referencias de ambas API de arriba para ver sus entradas y formatos.

Inicio rápido

  1. Verifica el correo de tu cuenta
  2. Crea una clave API en los ajustes y guárdala de forma segura; solo se muestra una vez
  3. Añade $5 al saldo API. Todas las claves comparten ese saldo, distinto de las suscripciones web y sin caducidad
  4. Envía la solicitud de ejemplo desde tu servidor, sustituyendo YOUR_API_KEY y document.png
  5. Comprueba el texto reconocido, los tokens usados y la facturación de la respuesta

Autenticación

Authorization: Bearer YOUR_API_KEY

Envía la clave como Bearer por HTTPS y guárdala en el servidor. No se admiten llamadas entre orígenes desde el navegador. Nunca publiques la clave en tu código.

Primera solicitud

Usa POST con clave Bearer y un único archivo en image. Sustituye YOUR_API_KEY y document.png. Deja que cURL establezca Content-Type multipart y su límite. Solo se admite el parámetro opcional format; no se admiten campos de formulario ni ajustes del modelo adicionales. Llama desde tu servidor; no se admiten llamadas entre orígenes desde el navegador. No publiques tu clave.

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

Leer la respuesta

El siguiente JSON es ilustrativo; el texto y los tokens dependen de la imagen.

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

Reintentos seguros

Ante errores de red, reutiliza el mismo Idempotency-Key y la imagen original. Cada operación nueva necesita una clave única nueva. No inicies otra operación mientras el resultado o el cobro anterior sean inciertos. Consulta la estrategia de reintento.

Estas guías se aplican a Imagen a texto e Imagen a tabla. Consulta las entradas, formatos y errores específicos en la referencia de cada API.