API

API PDF vers EPUB

L'API EpubCC convertit les PDFs en EPUB 3 avec le même moteur que ce site web. Créez une clé dans votre compte, envoyez un PDF à POST /v1/conversions et téléchargez le EPUB lorsque le travail est terminé ; les pages sont déduites de l'allocation mensuelle de votre plan, en commençant par 100 pages gratuites par mois.

Mis à jour : 5 novembre 2026

Comment ça marche

Créez une clé dans votre compte (elle est affichée une fois ; nous ne gardons qu'un hachage). Envoyez-la en tant que Authorization: Bearer <key> à https://api.epubcc.com.
POST /v1/conversions avec le PDF en tant que file (multipart, jusqu'à 10 Mo par demande) et, éventuellement, paginas (1-5,9), webhook_url et un en-tête Idempotency-Key pour qu'un nouvel essai ne crée jamais deux travaux.
GET /v1/conversions/{id} : l'état (en_cola, procesando, completado, fallido, cancelado), la position dans la file d'attente, une estimation du temps, le nombre de pages et le rapport de qualité.
GET /v1/conversions/{id}/download : un lien signé vers le EPUB, valable pendant 30 minutes.
DELETE /v1/conversions/{id} : annule le travail et supprime le PDF et le EPUB en même temps.
PDFs plus volumineux : POST /v1/uploads ouvre un téléchargement reprenable (8 Mo par morceaux avec PATCH et Upload-Offset), puis POST /v1/conversions avec {"subida": "<upload id>"}.

Pages et limites

Chaque conversion utilise les pages qu'elle convertit de l'allocation mensuelle de votre plan, partagée avec le site Web : Gratuit 100, Pro 1 500, Entreprise 6 000.
Les pages ne sont comptées que lorsque la conversion réussit. Un travail échoué ou annulé n'utilise rien.
Par fichier : jusqu'à 300 pages et 50 Mo sur le plan gratuit, 1 000 pages et 100 Mo sur le plan Pro, 2 000 pages et 200 Mo sur le plan Business. Les travaux Business passent en premier dans la file d'attente, suivis par Pro, puis Free.
Jusqu'à 5 conversions en cours par compte ; erreur 429 demasiados_trabajos au-dessus de cela.

Webhooks

Avec webhook_url, nous POSTons le travail (le même JSON que GET /v1/conversions/{id}) lorsqu'il se termine, et réessayons 5 fois. L'en-tête X-EPUBLab-Firma est t=<unix time>,v1=<hex HMAC-SHA256> de <t>.<body> avec le secret du webhook de votre clé, affiché à côté de la clé dans votre compte.

Erreurs

Toujours JSON : {"error": {"codigo": "…", "mensaje": "…"}}. Le code est stable pour les machines et le message est en anglais. Les plus courants : no_autorizado (401), cuota_agotada et demasiadas_paginas (402), demasiado_grande (413), no_es_pdf et paginas_invalidas (400), pdf_cifrado et pdf_ilegible (422).

Vos fichiers

La même politique de suppression que le site web : le PDF est supprimé lorsque l'ensemble du livre est converti ou 2 heures après sa dernière conversion, le EPUB 1 heure après le premier téléchargement ou 24 heures après qu'il soit prêt. Jamais publié, jamais utilisé pour l'entraînement.

Obtenez une clé API

Gratuit avec n'importe quel compte : 100 pages par mois sur le plan Gratuit, plus sur Pro et Entreprise.

Inscrivez-vous et créez une clé

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

Questions ou plus de volume : contactez-nous.