Batch Mode

Overview

Batch mode processes files from Google Drive in the background — 40% cheaper than the standard API. Ideal for large document archives.

	Standard API	Batch Mode
Response	Synchronous (streaming)	Async (polling)
Price	100%	60% (40% discount)
Input	Per-request	Bulk submit or Google Drive folder
Output	Response body	JSON result or written back to Drive

Supported file types: PNG · JPG · TIFF · WebP · PDF · TXT · MD · JSON · CSV · Excel

Quick Start

1. Submit a job

import httpx

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "chat",
        "model": "MamayLM-Gemma-3-27B-IT-v2.0",
        "input": "Summarise the following: ...",
    },
)
job_id = resp.json()["job_id"]

2. Poll for result

import time

while True:
    status = httpx.get(
        f"https://app.lapathoniia.top/batch/jobs/{job_id}",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
    ).json()
    if status["status"] == "done":
        print(status["result"]["content"])
        break
    time.sleep(5)

Batch JSON List

Submit a single JSON file with an array of prompts — each item is processed as a separate job. Ideal for bulk translation, mass processing, batch analysis.

[
  {"text": "Chapter 1: One morning Gregor Samsa..."},
  {"text": "Chapter 2: His sister brought food daily..."},
  {"text": "Chapter 3: Their father no longer felt shame..."}
]

Extended format with metadata:

[
  {
    "id": "page_1",
    "text": "Page text...",
    "system": "Translate to Polish."
  },
  {
    "id": "page_2",
    "text": "Next page text...",
    "system": "Translate to Polish."
  }
]

Field	Required	Description
`text`	✅	The prompt text for the LLM
`id`	—	Identifier for finding results
`system`	—	System prompt for this item. Falls back to the instruction from the submit form

Limit: 1000 items per file. Each item goes through the 24K character check. In the UI each item appears as a separate job named file.json [1/300].

OCR Pipeline

Combine OCR with LLM post-processing:

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "ocr",
        "model": "rukopys-ocr",
        "input_ref": "data:image/jpeg;base64,...",
        "pipeline": "ocr_then_chat",
        "pipeline_instruction": "Extract: date, signatories, amounts. Return JSON.",
        "pipeline_model": "MamayLM-Gemma-3-27B-IT-v2.0",
    },
)

Google Drive Integration

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "drive_folder",
        "drive_folder_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
        "model": "rukopys-ocr",
        "pipeline": "ocr_then_chat",
        "pipeline_instruction": "Translate to modern Ukrainian",
        "pipeline_model": "MamayLM-Gemma-3-27B-IT-v2.0",
    },
)

Share your Drive folder with: batch-worker@lapathoniia-prod.iam.gserviceaccount.com (Editor)

File Limits

Limit	Value	Behaviour
File size	50 MB	File skipped with error
PDF/TIFF pages	50 pages max	First 50 processed, rest ignored
Image resolution	4 MP (≈2048×2048)	Auto-downscaled preserving aspect ratio
Text (TXT/CSV/Excel)	24,000 characters	Truncated at sentence boundary with notice
OCR tokens per page	12,000	Dense pages may be cut off
Files per folder	Unlimited	100 files per Drive API page, auto-paginated

Multi-page PDFs and TIFFs are processed page by page. Each region in the result has a page field. The OCR quota (4 images/hour) applies per page.

40% Discount

All batch mode requests automatically get a 40% discount. Applied hourly. View usage: Usage → Batch mode section in the dashboard.

Overview

Batch mode обробляє файли з Google Drive у фоні — на 40% дешевше за стандартний API. Ідеально для великих архівів документів.

	Стандартний API	Batch Mode
Відповідь	Синхронний (streaming)	Async (polling)
Ціна	100%	60% (знижка 40%)
Введення	Один запит	Bulk submit або папка Google Drive
Виведення	В тілі відповіді	JSON або запис у Drive

Підтримувані формати: PNG · JPG · TIFF · WebP · PDF · TXT · MD · JSON · CSV · Excel

Quick Start

1. Відправте завдання

import httpx

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "chat",
        "model": "MamayLM-Gemma-3-27B-IT-v2.0",
        "input": "Підсумуй наступне: ...",
    },
)
job_id = resp.json()["job_id"]

2. Перевірте результат

import time

while True:
    status = httpx.get(
        f"https://app.lapathoniia.top/batch/jobs/{job_id}",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
    ).json()
    if status["status"] == "done":
        print(status["result"]["content"])
        break
    time.sleep(5)

Batch JSON List

Завантажте один JSON-файл з масивом промптів — кожен елемент обробляється як окремий запит. Ідеально для перекладу книг, масової обробки, пакетних аналізів.

[
  {"text": "Розділ 1: Одного ранку Грегор Замза..."},
  {"text": "Розділ 2: Сестра щодня приносила їжу..."},
  {"text": "Розділ 3: Батько вже не соромився..."}
]

Розширений формат з метаданими:

[
  {
    "id": "page_1",
    "text": "Текст сторінки...",
    "system": "Переклади на польську мову."
  }
]

Поле	Обов’язкове	Опис
`text`	✅	Текст промпту для LLM
`id`	—	Ідентифікатор для пошуку результатів
`system`	—	Системний промпт для цього елемента

OCR Pipeline

Комбінуйте OCR з постобробкою LLM:

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "ocr",
        "model": "rukopys-ocr",
        "input_ref": "data:image/jpeg;base64,...",
        "pipeline": "ocr_then_chat",
        "pipeline_instruction": "Витягни: дату, підписантів, суми. Поверни JSON.",
        "pipeline_model": "MamayLM-Gemma-3-27B-IT-v2.0",
    },
)

Google Drive Integration

Поділіться папкою з сервісним акаунтом: batch-worker@lapathoniia-prod.iam.gserviceaccount.com (Редактор)

resp = httpx.post(
    "https://app.lapathoniia.top/batch/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "job_type": "drive_folder",
        "drive_folder_id": "YOUR_FOLDER_ID",
        "model": "rukopys-ocr",
        "pipeline": "ocr_then_chat",
        "pipeline_instruction": "Переклади на сучасну українську",
        "pipeline_model": "MamayLM-Gemma-3-27B-IT-v2.0",
    },
)

File Limits

Ліміт	Значення	Що відбувається
Розмір файлу	50 МБ	Файл пропускається з помилкою
Сторінок PDF/TIFF	50 стор. (макс)	Перші 50 обробляються, решта ігнорується
Роздільна здатність	4 МП (≈2048×2048)	Автоматичне масштабування
Текст (TXT/CSV/Excel)	24 000 символів	Обрізається на межі речення
OCR токени на сторінку	12 000	Щільні сторінки можуть обрізатися
Файлів у папці	Необмежено	100 файлів на сторінку API Drive

Квота OCR (4 зображення/год) діє на кожну сторінку окремо, не на файл.

40% Discount

Всі запити через пакетний режим автоматично отримують знижку 40%. Знижка застосовується щогодини.

Get Started

API Reference

Guides

Connectors

Ecosystem

Overview

Quick Start

1. Submit a job

2. Poll for result

Batch JSON List

OCR Pipeline

Google Drive Integration

File Limits

40% Discount

Overview

Quick Start

1. Відправте завдання

2. Перевірте результат

Batch JSON List

OCR Pipeline

Google Drive Integration

File Limits

40% Discount

​Overview

​Quick Start

​1. Submit a job

​2. Poll for result

​Batch JSON List

​OCR Pipeline

​Google Drive Integration

​File Limits

​40% Discount

​Overview

​Quick Start

​1. Відправте завдання

​2. Перевірте результат

​Batch JSON List

​OCR Pipeline

​Google Drive Integration

​File Limits

​40% Discount

Overview

Quick Start

1. Submit a job

2. Poll for result

Batch JSON List

OCR Pipeline

Google Drive Integration

File Limits

40% Discount

Overview

Quick Start

1. Відправте завдання

2. Перевірте результат

Batch JSON List

OCR Pipeline

Google Drive Integration

File Limits

40% Discount