Docling als gehostete API

Docling wandelt PDF-, Word-, PowerPoint-, Excel-, HTML- und Bilddateien in Markdown, JSON, HTML oder reinen Text um. Es erkennt Lesereihenfolge, Überschriften, Listen und Tabellen und führt auf gescannten Seiten OCR aus.

Diese API ist die von docling-serve selbst: dieselben Pfade, Formularfelder und Antworten unter https://api.pagespool.com/v1/docling. Ein Client für docling-serve funktioniert, wenn Sie seine Basis-URL ändern und Ihren API-Schlüssel ergänzen. Testen Sie es zuerst mit einem kurzen PDF im kostenlosen Tool.

Preis und Limits

Ein PDF kostet 1 Credit pro umgewandelter Seite. Mit page_range zahlen Sie nur die Seiten im Bereich, und force_ocr verdoppelt den Preis. Jede andere Datei kostet 10 Credits. Die Credits werden beim Einreichen der Umwandlung abgebucht und erstattet, wenn sie fehlschlägt. Die Tarife stehen auf der Preisseite.

• Eine Datei pro Anfrage, bis 25 MB und 200 Seiten.
• Im kostenlosen Tarif 1 unfertige Umwandlung gleichzeitig, in einem bezahlten Tarif 3.
• Die synchronen Routen warten bis zu 50 Sekunden. Eine längere Umwandlung antwortet mit 504, dem Code use_async und ihrer task_id. Sie läuft weiter, und Sie fragen sie ab wie eine asynchrone.
• Docling bricht ein PDF nach 8 Sekunden pro Seite ab, frühestens nach 2 und spätestens nach 24 Minuten; jede andere Datei nach 5 Minuten.
• Ergebnisse werden 7 Tage gespeichert. Die hochgeladene Datei wird gelöscht, wenn die Umwandlung endet.
• Nicht unterstützt: Callbacks, Zip- und Presigned-Ziele, andere Pipelines als standard und Optionen außer to_formats, from_formats, image_export_mode, do_ocr, force_ocr, ocr_engine, ocr_lang, pdf_backend, table_mode, page_range, abort_on_error, do_table_structure, include_images, images_scale und md_page_break_placeholder. Jede davon antwortet mit 400. Es gibt keine WebSocket-Statusroute; der Client von Docling fragt dann per Polling ab.

Selbst hosten oder gehostet

docling-serve ist Open Source, und Sie können es selbst betreiben. Das CPU-Image ist 4,4 GB groß, und ein Umwandlungs-Worker lädt die Modelle für Layout, Tabellen und OCR in den Arbeitsspeicher: Planen Sie mehrere GB RAM pro Worker ein, mehr für lange oder gescannte PDFs. Dazu betreiben Sie die Warteschlange, den API-Schlüssel, die Updates und die Maschine.

Hier gehostet brauchen Sie einen API-Schlüssel. Derselbe Schlüssel und dasselbe Credit-Guthaben gelten für die anderen Engines dieser Website, und jede Engine hat ihren eigenen MCP-Server.

curl

Ein PDF umwandeln und auf das Ergebnis warten (bis zu 50 Sekunden):

curl -H "X-Api-Key: YOUR_API_KEY" \
  -F "files=@report.pdf" -F "to_formats=md" \
  https://api.pagespool.com/v1/docling/v1/convert/file

Das Markdown steht in document.md_content. Ein langes Dokument reihen Sie ein, fragen es ab und holen dann das Ergebnis:

curl -H "X-Api-Key: YOUR_API_KEY" -F "files=@report.pdf" \
  https://api.pagespool.com/v1/docling/v1/convert/file/async
# {"task_id": "3f9c…", "task_type": "convert", "task_status": "pending", "task_position": 0, "task_meta": null}

curl -H "X-Api-Key: YOUR_API_KEY" https://api.pagespool.com/v1/docling/v1/status/poll/3f9c…
curl -H "X-Api-Key: YOUR_API_KEY" https://api.pagespool.com/v1/docling/v1/result/3f9c…

Ein Dokument im Web geht an die Source-Route. Die API lädt es selbst von seiner https-URL herunter:

curl -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"options": {"to_formats": ["md"], "page_range": [1, 10]}, "sources": [{"kind": "http", "url": "https://arxiv.org/pdf/2501.17887"}]}' \
  https://api.pagespool.com/v1/docling/v1/convert/source/async

Open WebUI

Open WebUI sendet hochgeladene Dokumente an docling-serve, wenn Docling seine Engine für die Inhaltsextraktion ist. Richten Sie es hierher aus:

CONTENT_EXTRACTION_ENGINE=docling
DOCLING_SERVER_URL=https://api.pagespool.com/v1/docling
DOCLING_API_KEY=YOUR_API_KEY

Open WebUI nutzt die synchrone Route, deshalb scheitert dort ein Dokument, das länger als 50 Sekunden braucht. Für lange PDFs nutzen Sie die asynchronen Routen.

Der Python-Client von Docling

docling-client installiert den DoclingServiceClient von Docling, der eine Umwandlung auf einem docling-serve-Endpunkt statt auf Ihrem Rechner ausführt:

pip install docling-client

from docling.service_client import DoclingServiceClient, StatusWatcherKind

with DoclingServiceClient(
    url="https://api.pagespool.com/v1/docling",
    api_key="YOUR_API_KEY",
    status_watcher=StatusWatcherKind.POLLING,
    job_timeout=1800,
) as client:
    result = client.convert(source="report.pdf")
    print(result.document.export_to_markdown())

StatusWatcherKind.POLLING überspringt den WebSocket-Versuch, den diese API nicht anbietet, und job_timeout gibt langen PDFs die nötige Zeit.

Ihr API-Schlüssel

Erstellen Sie einen Schlüssel auf der Seite API-Schlüssel. Senden Sie ihn auf eine von drei Arten:

• X-API-Key: YOUR_API_KEY (die Clients von Docling senden ihn als X-Api-Key, derselbe Header);
• Authorization: Bearer YOUR_API_KEY;
• HTTP Basic mit dem Schlüssel als Passwort. Ein Client, der nur eine URL annimmt, kann den Schlüssel darin mitgeben, als https://x:YOUR_API_KEY@….

Setzen Sie den Schlüssel nie in einen Pfad oder einen Query-String: Beide landen in Zugriffsprotokollen. Ein fehlender oder falscher Schlüssel ergibt 401.

MCP und das kostenlose Tool

Für KI-Agenten ist der MCP-Server von Docling https://api.pagespool.com/mcp/docling/. Sein Tool convert_document reiht ein Dokument ein, und get_conversion liefert das Markdown, sobald es fertig ist. Die Einrichtung für jeden Client steht auf der Verbindungsseite.

Das kostenlose Tool PDF zu Markdown führt dieselbe Umwandlung für ein PDF mit bis zu 3 Seiten aus, ohne Konto.

Docling™ ist eine Marke von LF Projects, LLC; pagespool ist mit LF Projects nicht verbunden.