Exécuter dans le bac à sable

Endpoints de conversion de fichiers#

Convert est la moitié déterministe d'EnConvert : 51 endpoints qui prennent un fichier ou une URL et renvoient le même contenu dans un autre format. Chacun est un POST vers /v1/convert/<id>, donc dès que vous en avez appelé un, vous savez appeler tous les autres.

Une seule forme de requête#

Trois choses changent d'une conversion à l'autre : l'id dans le chemin, ce que vous envoyez, et ce qu'est le résultat. Rien d'autre ne bouge.

Chemin. POST https://api.enconvert.com/v1/convert/<id>, où <id> nomme la paire de conversion : url-to-pdf, doc-to-pdf, csv-to-json, heic-to-webp.

Entrée. Soit un fichier, soit une URL.

Les conversions de fichiers, 46 des 51, prennent du multipart/form-data avec le fichier dans un champ file.
Les conversions de pages web, les cinq autres, prennent de l'application/json avec un champ url qui accepte une URL ou un tableau d'URL.

Sortie. Chaque conversion écrit son résultat dans le stockage objet et répond avec une URL de téléchargement signée valable 15 minutes. Les endpoints qui prennent en charge direct_download peuvent à la place renvoyer les octets directement dans le corps de la réponse ; chaque page de famille indique sa propre valeur par défaut. Voir URLs signées.

Exemple#

Envoyez une URL, récupérez un PDF :

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
    "presigned_url": "https://spaces.example.com/...signed...",
    "object_key": "live/files/4127/url-to-pdf/example_20260405_123456789.pdf",
    "filename": "example_20260405_123456789.pdf",
    "file_size": 48213,
    "conversion_time_seconds": 2.41
}

La variante par envoi de fichier du même appel, pour les 46 endpoints de fichiers :

curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -F "[email protected]"

Choisir une famille#

Page	Endpoints	Ce qu'elle couvre
Matrice de conversion	les 51	Chaque format d'entrée et chaque format de sortie dans un seul tableau, avec l'id d'endpoint de chaque paire. Commencez ici quand vous savez ce que vous avez et ce que vous voulez.
Pages web	5	Effectuez le rendu d'une URL en direct vers un PDF, un PNG pleine page ou du Markdown, ou parcourez un site entier et récupérez un seul ZIP.
Documents	13	Word, Excel, PowerPoint, Pages, Numbers, OpenDocument, HTML et Markdown vers PDF, plus `anything-to-pdf` (36 extensions d'entrée) et `anything-to-markdown` (22).
Formats de données	11	JSON, XML, YAML, CSV et TOML dans les deux sens, plus Markdown vers HTML.
Images	22	JPEG, PNG, SVG, HEIC et WebP entre eux, pages PDF rendues en JPEG, et compression sans changement de format.

Chaque page de famille liste ses endpoints dans un tableau avec le chemin exact de chacun. Chaque endpoint a ensuite sa propre page : paramètres de la requête, réponse, cas d'erreur qu'il peut renvoyer, et exemples de code.

Les endpoints Office ignorent la géométrie de page. Les neuf endpoints adossés à LibreOffice (doc-to-pdf, excel-to-pdf, ppt-to-pdf, odt-to-pdf, ods-to-pdf, odp-to-pdf, ots-to-pdf, pages-to-pdf, numbers-to-pdf) acceptent pdf_options mais n'honorent que grayscale. La taille de page, l'orientation et les marges proviennent du document source : en définir une explicitement renvoie donc 400.

Ce que partagent tous les endpoints de conversion#

Les identifiants et les types de contenu sont les mêmes dans toute l'API. Voir Endpoints.
L'asynchrone et le traitement par lot ne sont disponibles que sur les cinq endpoints de pages web. Les envois de fichiers s'exécutent toujours de manière synchrone, un fichier par requête. Voir Tâches synchrones et asynchrones et Traitement par lot.
La taille d'envoi est plafonnée par forfait, à partir de 5 MB sur Founding. Au-dessus du plafond, vous obtenez 413 avec la taille de votre fichier et la limite dans le corps de la réponse. Voir Limites de débit et quotas.
Le coût est d'une op par conversion. Un lot de 10 URL vaut 10 ops, et le lot entier est vérifié par rapport à votre quota restant avant le rendu de la moindre page.
Les délais d'attente sont réels. Les conversions LibreOffice sont coupées à 120 secondes et renvoient 504 ; la gateway elle-même abandonne toute requête après 300 secondes.
Les erreurs utilisent les mêmes codes de statut dans toutes les familles : 400 pour une entrée invalide, 401 pour des identifiants incorrects, 402 pour le quota, 403 pour une fonctionnalité réservée à certains forfaits, 413 pour un envoi trop volumineux. Voir Codes d'erreur.

Questions fréquentes#

Quels endpoints acceptent une URL plutôt qu'un fichier ?#

Les cinq endpoints de pages web : url-to-pdf, url-to-screenshot, url-to-markdown, website-to-pdf et website-to-screenshot. Les 46 autres n'acceptent que des envois de fichiers, anything-to-pdf compris. Pour convertir un document qui se trouve à une URL, récupérez-le vous-même et envoyez les octets.

Puis-je convertir plusieurs fichiers en une seule requête ?#

Pas sous forme d'envois de fichiers. Le traitement par lot fonctionne sur les endpoints d'URL, où le champ url accepte un tableau, et il exige une clé privée ainsi qu'un forfait donnant accès au lot : la limite de lot du forfait Founding est de 0. Voir Traitement par lot.

Et si ma paire de formats ne fait pas partie des 51 ?#

Regardez d'abord anything-to-pdf : il accepte 36 extensions d'entrée et couvre les paires qui n'ont pas d'endpoint dédié. Pour du texte que vous voulez lire plutôt qu'imprimer, anything-to-markdown en accepte 22. Aucun des deux ne fait d'OCR : une image envoyée à anything-to-markdown renvoie donc 400.

Comment trouver l'endpoint d'une paire de formats précise ?#

Ouvrez la matrice de conversion. Elle liste chaque format d'entrée sur un axe et chaque format de sortie sur l'autre, avec l'id d'endpoint dans la cellule.

← Ingest Conversion Matrix →

API Documentation