API

PDF till EPUB API

EpubCC API konverterar PDF-filer till EPUB 3 med samma motor som denna webbplats. Skapa en nyckel i ditt konto, skicka en PDF till POST /v1/conversions och ladda ner EPUB när jobbet är klart; sidor dras från din månadsavgift som börjar med 100 gratis sidor per månad.

Uppdaterad: 5 november 2026

Hur det fungerar

Skapa en nyckel i ditt konto (den visas en gång; vi sparar bara en hash). Skicka den som Authorization: Bearer <key> till https://api.epubcc.com.
POST /v1/conversions med PDF som file (multipart, upp till 10 MB per begäran) och, valfritt, paginas (1-5,9), webhook_url och en Idempotency-Key-header så att ett nytt försök aldrig skapar två jobb.
GET /v1/conversions/{id}: tillståndet (en_cola, procesando, completado, fallido, cancelado), köpositionen, en tidsuppskattning, sidantal och kvalitetsrapport.
GET /v1/conversions/{id}/download: en signerad länk till EPUB, giltig i 30 minuter.
DELETE /v1/conversions/{id}: avbryter jobbet och tar bort PDF och EPUB på en gång.
Större PDF:er: POST /v1/uploads öppnar en återupptagbar uppladdning (8 MB bitar med PATCH och Upload-Offset), sedan POST /v1/conversions med {"subida": "<upload id>"}.

Sidor och begränsningar

Varje konvertering använder sidorna den konverterar från din plan månadsallokering, delad med webbplatsen: Gratis 100, Pro 1 500, Business 6 000.
Sidor räknas endast när en konvertering lyckas. Ett misslyckat eller avbrutet jobb använder inget.
Per fil: upp till 300 sidor och 50 MB på Gratis, 1,000 sidor och 100 MB på Pro, 2,000 sidor och 200 MB på Business. Business-jobb går först i kön, sedan Pro, sedan Gratis.
Upp till 5 konverteringar på gång per konto; fel 429 demasiados_trabajos över det.

Webhooks

Med webhook_url, POST:ar vi jobbet (samma JSON som GET /v1/conversions/{id}) när det avslutas, och försöker 5 gånger. X-EPUBLab-Firma-headern är t=<unix time>,v1=<hex HMAC-SHA256> av <t>.<body> med din nyckels webhook-hemlighet, som visas bredvid nyckeln i ditt konto.

Fel

Alltid JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Koden är stabil för maskiner och meddelandet är på engelska. De vanligaste: no_autorizado (401), cuota_agotada och demasiadas_paginas (402), demasiado_grande (413), no_es_pdf och paginas_invalidas (400), pdf_cifrado och pdf_ilegible (422).

Dina filer

Samma raderingspolicy som webbplatsen: PDF tas bort när hela boken är konverterad eller 2 timmar efter den senaste konverteringen, EPUB en timme efter första nedladdningen eller 24 timmar efter att den är klar. Aldrig publicerad, aldrig använd för träning.

Få en API-nyckel

Gratis med vilket konto som helst: 100 sidor per månad på gratisplanen, fler på Pro och Business.

Registrera dig och skapa en nyckel

Konvertera en 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=…"}

Frågor eller mer volym: kontakta oss.

Dela