API

PDF zu EPUB API

Die EpubCC API wandelt PDFs in EPUB 3 um, mit der gleichen Engine wie diese Webseite. Erstellen Sie einen Schlüssel in Ihrem Konto, senden Sie eine PDF an POST /v1/conversions und laden Sie die EPUB herunter, wenn der Vorgang abgeschlossen ist; die Seiten zählen zu den monatlichen Kontingenten Ihres Plans, beginnend mit 100 kostenlosen Seiten pro Monat.

Aktualisiert: 5. November 2026

Wie es funktioniert

Erstelle einen Schlüssel in deinem Konto (er wird einmal angezeigt; wir speichern nur einen Hash). Sende ihn als Authorization: Bearer <key> an https://api.epubcc.com.
POST /v1/conversions mit dem PDF als file (multipart, bis zu 10 MB pro Anfrage) und optional paginas (1-5,9), webhook_url und einen Idempotency-Key Header, damit ein erneuter Versuch niemals zwei Jobs erstellt.
GET /v1/conversions/{id}: der Zustand (en_cola, procesando, completado, fallido, cancelado), die Warteschlangenposition, eine Zeitabschätzung, Seitenzahlen und der Qualitätsbericht.
GET /v1/conversions/{id}/download: ein signierter Link zu der EPUB, gültig für 30 Minuten.
DELETE /v1/conversions/{id}: kündigt den Job und löscht gleichzeitig die PDF und die EPUB.
Größere PDFs: POST /v1/uploads öffnet einen fortsetzbaren Upload (8 MB große Blöcke mit PATCH und Upload-Offset), dann POST /v1/conversions mit {"subida": "<upload id>"}.

Seiten und Limits

Each conversion uses the pages it converts from your plan's monthly allowance, shared with the website: Free 100, Pro 1,500, Business 6,000.
Seiten werden nur gezählt, wenn eine Konvertierung erfolgreich ist. Ein fehlgeschlagenes oder abgebrochenes Job nutzt nichts.
Per file: up to 300 pages and 50 MB on Free, 1,000 pages and 100 MB on Pro, 2,000 pages and 200 MB on Business. Business jobs go first in the queue, then Pro, then Free.
Bis zu 5 in Bearbeitung befindliche Umwandlungen pro Konto; Fehler 429 demasiados_trabajos darüber.

Webhooks

Mit webhook_url senden wir den Job (das gleiche JSON wie GET /v1/conversions/{id}), wenn er abgeschlossen ist, und versuchen es 5 Mal erneut. Der X-EPUBLab-Firma Header ist t=<unix time>,v1=<hex HMAC-SHA256> von <t>.<body> mit dem Webhook-Geheimnis Ihres Schlüssels, das neben dem Schlüssel in Ihrem Konto angezeigt wird.

Fehler

Immer JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Der Code ist stabil für Maschinen und die Nachricht ist auf Englisch. Die häufigsten: no_autorizado (401), cuota_agotada und demasiadas_paginas (402), demasiado_grande (413), no_es_pdf und paginas_invalidas (400), pdf_cifrado und pdf_ilegible (422).

Ihre Dateien

Die gleiche Löschrichtlinie wie die Webseite: die PDF wird gelöscht, wenn das gesamte Buch umgewandelt wurde oder 2 Stunden nach der letzten Umwandlung, die EPUB 1 Stunde nach dem ersten Download oder 24 Stunden nachdem sie bereit ist. Nie veröffentlicht, nie für Schulungen verwendet.

Holen Sie sich einen API-Schlüssel

Kostenlos mit jedem Konto: 100 Seiten pro Monat im kostenlosen Plan, mehr im Pro- und Business-Plan.

Registrieren und einen Schlüssel erstellen

Konvertiere ein PDF

curl https://api.epubcc.com/v1/conversions \
  -H "Authorization: Bearer $EPUBCC_KEY" \
  -H "Idempotency-Key: my-book-1" \
  -F file=@book.pdf
# → 201 {"id": "…", "estado": "en_cola", "posicion": 1, …}

curl https://api.epubcc.com/v1/conversions/$ID \
  -H "Authorization: Bearer $EPUBCC_KEY"
# → {"estado": "completado", "paginas_convertidas": 120, "informe": {…}}

curl https://api.epubcc.com/v1/conversions/$ID/download \
  -H "Authorization: Bearer $EPUBCC_KEY"
# → {"url": "https://api.epubcc.com/d/…?exp=…&sig=…"}

Fragen oder mehr Volumen: kontaktieren Sie uns.