🚀 API Gemini - Documentación

Endpoint OCR Laburen - Procesamiento de imágenes y PDFs con Gemini

POST /ocr-laburen

Procesa imágenes o PDFs desde una URL o archivo directo. Los PDFs se dividen por páginas automáticamente. Las imágenes se procesan directamente.

Parámetros

Parámetro Tipo Requerido Descripción
prompt String Sí El prompt que se enviará a Gemini
workSpaceApiKey String Sí API key de Laburen para descontar créditos. El costo lo calcula Laburen según el modelo y los tokens consumidos (una petición por imagen, una por página de PDF)
agentId String Sí ID del agente de Laburen para registrar el uso de tokens
fileUrl URL Opcional* URL del archivo a procesar (imagen o PDF)
file File Opcional* Archivo directo a procesar (imagen o PDF)
model String No Modelo a usar. Acepta el enum de Laburen o el deploy name. Soportados: gemini_2_5_flash, gemini_2_5_pro, gemini_3_flash, gemini_3_pro_preview (default: gemini_3_flash)

* Debes proporcionar fileUrl O file, no ambos

Respuesta

Siempre devuelve JSON. El campo creditsCharged refleja los créditos descontados al workspace de Laburen (valor credits.charged que reporta el endpoint de usage; null si falla la facturación, o 0 si el modelo no tiene precio configurado en el workspace).

Imagen

{
  "result": "...texto extraído...",
  "usage": { "promptTokenCount": 258, "candidatesTokenCount": 42, ... },
  "billing": {
    "success": true,
    "credits": { "charged": 0.07, "requested": 0.07 },
    "model": { "provider": "gemini", "modelName": "gemini-3-flash-preview" },
    "tokens": { "inputTokens": 258, "outputTokens": 42 }
  },
  "creditsCharged": 0.07
}

PDF (multipágina)

Objeto con el array pages (un elemento por página, con su propio creditsCharged) y totalCreditsCharged con la suma de todas las páginas.

{
  "pages": [
    { "page": 1, "result": "...", "usage": {...}, "billing": {...}, "creditsCharged": 0.07 },
    { "page": 2, "result": "...", "usage": {...}, "billing": {...}, "creditsCharged": 0.05 }
  ],
  "totalCreditsCharged": 0.12
}

Las páginas que fallan incluyen error y creditsCharged: null (no suman al total).

Procesando...