API

API de PDF a EPUB

La API EpubCC convierte PDFs a EPUB 3 con el mismo motor que este sitio web. Crea una clave en tu cuenta, envía un PDF a POST /v1/conversions y descarga el EPUB cuando el trabajo esté terminado; las páginas salen de la asignación mensual de tu plan, comenzando con 100 páginas gratuitas al mes.

Actualizado: 5 de noviembre de 2026

Cómo funciona

Crea una clave en tu cuenta (se muestra una vez; solo guardamos un hash). Envíala como Authorization: Bearer <key> a https://api.epubcc.com.
POST /v1/conversions con el PDF como file (multipart, hasta 10 MB por solicitud) y, opcionalmente, paginas (1-5,9), webhook_url y un encabezado Idempotency-Key para que un reintento nunca cree dos trabajos.
GET /v1/conversions/{id}: el estado (en_cola, procesando, completado, fallido, cancelado), la posición en la cola, una estimación de tiempo, contadores de páginas y el informe de calidad.
GET /v1/conversions/{id}/download: un enlace firmado al EPUB, válido por 30 minutos.
DELETE /v1/conversions/{id}: cancela el trabajo y elimina el PDF y el EPUB a la vez.
PDFs más grandes: POST /v1/uploads abre una carga reanudable (fragmentos de 8 MB con PATCH y Upload-Offset), luego POST /v1/conversions con {"subida": "<upload id>"}.

Páginas y límites

Cada conversión utiliza las páginas que convierte del límite mensual de tu plan, compartido con el sitio web: Free 100, Pro 1,500, Business 6,000.
Las páginas se cuentan solo cuando una conversión tiene éxito. Un trabajo fallido o cancelado no utiliza nada.
Por archivo: hasta 300 páginas y 50 MB en gratis, 1,000 páginas y 100 MB en Pro, 2,000 páginas y 200 MB en Business. Los trabajos de Business van primero en la cola, luego Pro, luego Free.
Hasta 5 conversiones en progreso por cuenta; error 429 demasiados_trabajos por encima de eso.

Webhooks

Con webhook_url, enviamos el trabajo (el mismo JSON que GET /v1/conversions/{id}) cuando finaliza, y reintentamos 5 veces. El encabezado X-EPUBLab-Firma es t=<unix time>,v1=<hex HMAC-SHA256> de <t>.<body> con el secreto del webhook de tu clave, mostrado junto a la clave en tu cuenta.

Errores

Siempre JSON: {"error": {"codigo": "…", "mensaje": "…"}}. El código es estable para máquinas y el mensaje está en inglés. Los más comunes: no_autorizado (401), cuota_agotada y demasiadas_paginas (402), demasiado_grande (413), no_es_pdf y paginas_invalidas (400), pdf_cifrado y pdf_ilegible (422).

Tus archivos

La misma política de eliminación que el sitio web: el PDF se elimina cuando se convierte todo el libro o 2 horas después de su última conversión, el EPUB 1 hora después de la primera descarga o 24 horas después de que esté listo. Nunca publicado, nunca usado para entrenamiento.

Obtén una clave de API

Gratis con cualquier cuenta: 100 páginas al mes en el plan Free, más en Pro y Business.

Regístrate y crea una clave

Convertir un 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=…"}

¿Preguntas o más volumen?: contáctanos.