--- seo_title: API de conversion de fichiers : tous les endpoints | EnConvert meta_desc: L'API de conversion EnConvert : 51 endpoints pour pages web, documents, formats de données et images, une seule forme de requête, une URL signée en retour. keywords: api de conversion de fichiers, endpoints api convert, post v1 convert, api url vers pdf, api document vers pdf, api conversion d'images, api conversion de formats de données, matrice de conversion, upload multipart conversion de fichiers --- # 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/`, 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/`, où `` 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](/fr/docs/concepts/signed-urls.md). ## Exemple Envoyez une URL, récupérez un PDF : ```bash 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"}' ``` ```json { "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 : ```bash curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \ -H "X-API-Key: sk_your_private_key" \ -F "file=@quarterly-report.docx" ``` ## Choisir une famille | Page | Endpoints | Ce qu'elle couvre | |------|-----------|----------------| | [Matrice de conversion](/fr/docs/endpoints/convert/matrix.md) | 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](/fr/docs/endpoints/convert/web-pages.md) | 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](/fr/docs/endpoints/convert/documents.md) | 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](/fr/docs/endpoints/convert/data-formats.md) | 11 | JSON, XML, YAML, CSV et TOML dans les deux sens, plus Markdown vers HTML. | | [Images](/fr/docs/endpoints/convert/images.md) | 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](/fr/docs/endpoints.md). - **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](/fr/docs/concepts/sync-and-async.md) et [Traitement par lot](/fr/docs/guides/batch-processing.md). - **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](/fr/docs/reference/rate-limits.md). - **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](/fr/docs/reference/errors.md). ## 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](/fr/docs/guides/batch-processing.md). ### 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](/fr/docs/endpoints/convert/matrix.md). 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.