API

API PDF para EPUB

A API EpubCC converte PDFs em EPUB 3 com o mesmo mecanismo deste site. Crie uma chave em sua conta, envie um PDF para POST /v1/conversions e faça o download do EPUB quando o trabalho estiver concluído; as páginas são descontadas da cota mensal do seu plano, começando com 100 páginas gratuitas por mês.

Atualizado: 5 de Novembro de 2026

Como funciona

Crie uma chave em sua conta (ela é exibida uma vez; nós apenas mantemos um hash). Envie-a como Authorization: Bearer <key> para https://api.epubcc.com.
POST /v1/conversions com o PDF como file (multipart, até 10 MB por solicitação) e, opcionalmente, paginas (1-5,9), webhook_url e um cabeçalho Idempotency-Key para que uma nova tentativa nunca crie dois trabalhos.
GET /v1/conversions/{id}: o estado (en_cola, procesando, completado, fallido, cancelado), a posição na fila, uma estimativa de tempo, contagens de páginas e o relatório de qualidade.
GET /v1/conversions/{id}/download: um link assinado para o EPUB, válido por 30 minutos.
DELETE /v1/conversions/{id}: cancela o trabalho e exclui o PDF e o EPUB de uma vez.
PDFs maiores: POST /v1/uploads abre um upload retomável (8 MB por partes com PATCH e Upload-Offset), depois POST /v1/conversions com {"subida": "<upload id>"}.

Páginas e limites

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.
As páginas são contadas apenas quando uma conversão é bem-sucedida. Um trabalho falhado ou cancelado não usa nada.
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.
Até 5 conversões em progresso por conta; erro 429 demasiados_trabajos acima disso.

Webhooks

Com webhook_url, nós POSTamos o trabalho (o mesmo JSON que GET /v1/conversions/{id}) quando ele termina, e tentamos novamente 5 vezes. O cabeçalho X-EPUBLab-Firma é t=<unix time>,v1=<hex HMAC-SHA256> de <t>.<body> com o segredo do webhook da sua chave, mostrado ao lado da chave em sua conta.

Erros

Sempre JSON: {"error": {"codigo": "…", "mensaje": "…"}}. O código é estável para máquinas e a mensagem está em inglês. Os mais comuns: no_autorizado (401), cuota_agotada e demasiadas_paginas (402), demasiado_grande (413), no_es_pdf e paginas_invalidas (400), pdf_cifrado e pdf_ilegible (422).

Seus arquivos

A mesma política de exclusão do site: o PDF é excluído quando o livro inteiro é convertido ou 2 horas após sua última conversão, o EPUB 1 hora após o primeiro download ou 24 horas após estar pronto. Nunca publicado, nunca usado para treinamento.

Obtenha uma chave da API

Grátis com qualquer conta: 100 páginas por mês no plano Grátis, mais no Pro e no Negócios.

Inscreva-se e crie uma chave

Converter um 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=…"}

Perguntas ou mais volume: nos contate.