In der Sandbox ausführen

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/<id>; 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/<id>, wobei <id> 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.

Beispiel#

Sende eine URL, erhalte ein 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
}

Derselbe Aufruf als Upload, für die 46 Datei-Endpunkte:

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

Wähle eine Familie#

Seite	Endpunkte	Was sie abdeckt
Konvertierungsmatrix	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	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	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	11	JSON, XML, YAML, CSV und TOML in beide Richtungen, dazu Markdown zu HTML.
Bilder	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.
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 und Batch-Verarbeitung.
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.
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.

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.

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. Sie listet jedes Eingabeformat auf der einen Achse und jedes Ausgabeformat auf der anderen auf, mit der Endpunkt-ID in der Zelle.

← Ingest Conversion Matrix →

API Documentation