--- seo_title: Dateikonvertierungs-API: alle 51 Convert-Endpunkte | EnConvert meta_desc: Die EnConvert-Konvertierungs-API: 51 Endpunkte für Webseiten, Dokumente, Datenformate und Bilder, alle mit derselben Request-Form und einer signierten URL. keywords: dateikonvertierungs api, alle convert endpunkte, post v1 convert, url in pdf umwandeln api, dokument zu pdf api, bilder konvertieren api, datenformate konvertieren api, konvertierungsmatrix, multipart datei upload konvertierung --- # Endpunkte zur Dateikonvertierung Convert ist die deterministische Hälfte von EnConvert: 51 Endpunkte, die eine Datei oder eine URL entgegennehmen und denselben Inhalt in einem anderen Format zurückgeben. Jeder davon ist ein `POST` an `/v1/convert/`; hast du einen aufgerufen, weißt du, wie du die übrigen aufrufst. ## Eine Request-Form Drei Dinge ändern sich von Konvertierung zu Konvertierung: die ID im Pfad, was du sendest und was dabei herauskommt. Sonst bewegt sich nichts. **Pfad.** `POST https://api.enconvert.com/v1/convert/`, wobei `` das Konvertierungspaar benennt: `url-to-pdf`, `doc-to-pdf`, `csv-to-json`, `heic-to-webp`. **Eingabe.** Entweder eine Datei oder eine URL. - Dateikonvertierungen, 46 der 51, nehmen `multipart/form-data` mit der Datei im Feld `file` entgegen. - Webseiten-Konvertierungen, die übrigen fünf, nehmen `application/json` mit einem Feld `url` entgegen, das eine URL oder ein Array von URLs akzeptiert. **Ausgabe.** Jede Konvertierung schreibt ihr Ergebnis in den Objektspeicher und antwortet mit einer signierten Download-URL, die 15 Minuten gültig ist. Endpunkte, die `direct_download` unterstützen, können die Bytes stattdessen als Response-Body zurückstreamen; jede Familienseite nennt ihren eigenen Standard. Siehe [Signierte URLs](/de/docs/concepts/signed-urls.md). ## Beispiel Sende eine URL, erhalte ein 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 } ``` Derselbe Aufruf als Upload, für die 46 Datei-Endpunkte: ```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" ``` ## Wähle eine Familie | Seite | Endpunkte | Was sie abdeckt | |------|-----------|----------------| | [Konvertierungsmatrix](/de/docs/endpoints/convert/matrix.md) | alle 51 | Jedes Eingabeformat und jedes Ausgabeformat in einer Tabelle, mit der Endpunkt-ID für jedes Paar. Fang hier an, wenn du weißt, was du hast und was du willst. | | [Webseiten](/de/docs/endpoints/convert/web-pages.md) | 5 | Rendere eine Live-URL als PDF, als Ganzseiten-PNG oder als Markdown, oder crawle eine gesamte Website und erhalte ein einziges ZIP zurück. | | [Dokumente](/de/docs/endpoints/convert/documents.md) | 13 | Word, Excel, PowerPoint, Pages, Numbers, OpenDocument, HTML und Markdown zu PDF, dazu `anything-to-pdf` (36 Eingabe-Dateiendungen) und `anything-to-markdown` (22). | | [Datenformate](/de/docs/endpoints/convert/data-formats.md) | 11 | JSON, XML, YAML, CSV und TOML in beide Richtungen, dazu Markdown zu HTML. | | [Bilder](/de/docs/endpoints/convert/images.md) | 22 | JPEG, PNG, SVG, HEIC und WebP untereinander, PDF-Seiten als JPEG gerendert sowie Komprimierung im selben Format. | Jede Familienseite listet ihre Endpunkte in einer Tabelle mit dem exakten Pfad auf. Jeder Endpunkt hat dann seine eigene Seite: Request-Parameter, die Antwort, die möglichen Fehlerfälle und Codebeispiele.
Office-Endpunkte ignorieren die Seitengeometrie. Die neun auf LibreOffice basierenden Endpunkte (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) akzeptieren pdf_options, berücksichtigen davon aber nur grayscale. Seitengröße, Ausrichtung und Ränder stammen aus dem Quelldokument; wird eines davon explizit gesetzt, kommt 400 zurück.
## Was alle Convert-Endpunkte gemeinsam haben - **Zugangsdaten und Content-Types** sind über die gesamte API hinweg gleich. Siehe [Endpunkte](/de/docs/endpoints.md). - **Async und Batch** gibt es nur bei den fünf Webseiten-Endpunkten. Datei-Uploads laufen immer synchron, eine Datei pro Anfrage. Siehe [Synchrone und asynchrone Jobs](/de/docs/concepts/sync-and-async.md) und [Batch-Verarbeitung](/de/docs/guides/batch-processing.md). - **Die Upload-Größe** ist je Plan gedeckelt, beginnend bei 5 MB im Founding-Plan. Über der Grenze bekommst du `413`, mit deiner Dateigröße und der Obergrenze im Body. Siehe [Rate-Limits und Kontingente](/de/docs/reference/rate-limits.md). - **Die Kosten** betragen eine Op pro Konvertierung. Ein Batch mit 10 URLs sind 10 Ops, und der gesamte Batch wird gegen dein verbleibendes Kontingent geprüft, bevor irgendeine Seite gerendert wird. - **Timeouts** sind echt. LibreOffice-Konvertierungen werden nach 120 Sekunden abgebrochen und liefern `504`; das Gateway selbst gibt bei jeder Anfrage nach 300 Sekunden auf. - **Fehler** verwenden über alle Familien hinweg dieselben Statuscodes: `400` für ungültige Eingaben, `401` für falsche Zugangsdaten, `402` für das Kontingent, `403` für ein plan-abhängiges Feature, `413` für einen zu großen Upload. Siehe [Fehler](/de/docs/reference/errors.md). ## Häufig gestellte Fragen ### Welche Endpunkte akzeptieren eine URL statt einer Datei? Die fünf Webseiten-Endpunkte: `url-to-pdf`, `url-to-screenshot`, `url-to-markdown`, `website-to-pdf` und `website-to-screenshot`. Die übrigen 46 nehmen ausschließlich Uploads entgegen, `anything-to-pdf` eingeschlossen. Um ein Dokument zu konvertieren, das unter einer URL liegt, hole es selbst ab und lade die Bytes hoch. ### Kann ich mehrere Dateien in einer Anfrage konvertieren? Nicht als Uploads. Batching funktioniert bei den URL-Endpunkten, wo das Feld `url` ein Array entgegennimmt, und es erfordert einen privaten Key sowie einen Plan mit Batch-Zugriff; im Founding-Plan liegt das Batch-Limit bei 0. Siehe [Batch-Verarbeitung](/de/docs/guides/batch-processing.md). ### Was, wenn mein Formatpaar nicht unter den 51 ist? Sieh zuerst bei `anything-to-pdf` nach: Es akzeptiert 36 Eingabe-Dateiendungen und deckt Paare ab, für die es keinen eigenen Endpunkt gibt. Für Text, den du lesen statt drucken willst, akzeptiert `anything-to-markdown` 22. Keiner von beiden macht OCR, ein Bild als Eingabe an `anything-to-markdown` liefert daher `400`. ### Wie finde ich den Endpunkt für ein bestimmtes Formatpaar? Öffne die [Konvertierungsmatrix](/de/docs/endpoints/convert/matrix.md). Sie listet jedes Eingabeformat auf der einen Achse und jedes Ausgabeformat auf der anderen auf, mit der Endpunkt-ID in der Zelle.