Bild-Konvertierungs-API#
Mit einer einzigen REST-API konvertieren Sie Bilder zwischen JPEG, PNG, WebP, HEIC und SVG, rendern PDF-Seiten als JPEGs oder komprimieren Bilder direkt im Ausgangsformat. Jeder Endpunkt akzeptiert einen multipart/form-data-Upload und konvertiert synchron, je nach Formatpaar mit Pillow, CairoSVG, pillow-heif oder PyMuPDF. Standardmäßig ist die Antwort die roh konvertierte Datei; setzen Sie direct_download=false, um stattdessen JSON-Metadaten mit einer presigned Download-URL zu erhalten.
Unterstützte Konvertierungen#
| Konvertierung | Endpunkt | Beschreibung |
|---|---|---|
| JPEG zu PNG | POST /v1/convert/jpeg-to-png |
Konvertiert einen .jpeg/.jpg-Upload in ein verlustfreies PNG mit voller Farbtreue. |
| PNG zu JPEG | POST /v1/convert/png-to-jpeg |
Konvertiert eine .png in ein JPEG mit maximaler Qualität und legt transparente Bereiche auf einen weißen Hintergrund. |
| JPEG zu SVG | POST /v1/convert/jpeg-to-svg |
Bettet das JPEG base64-kodiert als Daten-URI in ein SVG-<image>-Element ein. Das ergibt einen Raster-Wrapper, keine Vektorisierung. |
| SVG zu JPEG | POST /v1/convert/svg-to-jpeg |
Rastert das SVG mit CairoSVG und liefert ein JPEG, wobei Transparenz auf einen weißen Hintergrund gelegt wird. |
| JPEG zu HEIC | POST /v1/convert/jpeg-to-heic |
Kodiert einen .jpeg/.jpg-Upload mit dem HEIF-Codec als hochwertige HEIC-Datei. |
| HEIC zu JPEG | POST /v1/convert/heic-to-jpeg |
Dekodiert einen .heic- oder .heif-Upload (z. B. iPhone-Fotos) und erzeugt ein hochwertiges JPEG. |
| JPEG zu WebP | POST /v1/convert/jpeg-to-webp |
Erzeugt ein hochwertiges WebP mit kleinerer Dateigröße als das entsprechende JPEG für die Auslieferung im Web. |
| WebP zu JPEG | POST /v1/convert/webp-to-jpeg |
Konvertiert eine .webp in JPEG und legt transparente Bereiche auf einen weißen Hintergrund. |
| PNG zu SVG | POST /v1/convert/png-to-svg |
Bettet das PNG als base64-Daten-URI in einen SVG-Wrapper ein, der den Pixelabmessungen des Bilds entspricht. Keine Vektorisierung. |
| SVG zu PNG | POST /v1/convert/svg-to-png |
Rastert das SVG mit CairoSVG in der angegebenen Größe und erhält die Transparenz in der PNG-Ausgabe. |
| PNG zu HEIC | POST /v1/convert/png-to-heic |
Konvertiert eine .png in HEIC und legt transparente Bereiche auf einen weißen Hintergrund. |
| HEIC zu PNG | POST /v1/convert/heic-to-png |
Konvertiert einen .heic- oder .heif-Upload in ein verlustfreies PNG mit voller Farbtreue. |
| PNG zu WebP | POST /v1/convert/png-to-webp |
Konvertiert eine .png in WebP und erhält dabei den Alphakanal (Transparenz). |
| WebP zu PNG | POST /v1/convert/webp-to-png |
Konvertiert eine .webp in ein verlustfreies PNG mit erhaltener Transparenz. |
| SVG zu HEIC | POST /v1/convert/svg-to-heic |
Rendert das SVG mit CairoSVG und kodiert es mit maximaler Qualität auf weißem Hintergrund als HEIC. |
| HEIC zu SVG | POST /v1/convert/heic-to-svg |
Dekodiert das HEIC zu PNG und bettet es als base64-Daten-URI in einen SVG-Wrapper ein. Keine Vektorisierung. |
| SVG zu WebP | POST /v1/convert/svg-to-webp |
Rendert das SVG mit CairoSVG und kodiert es mit maximaler Qualität und erhaltener Transparenz als WebP. |
| WebP zu SVG | POST /v1/convert/webp-to-svg |
Dekodiert das WebP zu PNG und bettet es als base64-Daten-URI in einen SVG-Wrapper ein. Keine Vektorisierung. |
| HEIC zu WebP | POST /v1/convert/heic-to-webp |
Konvertiert einen .heic- oder .heif-Upload in ein hochwertiges WebP und erhält dabei einen vorhandenen Alphakanal. |
| WebP zu HEIC | POST /v1/convert/webp-to-heic |
Konvertiert eine .webp mit maximaler Qualität in HEIC und legt Transparenz auf einen weißen Hintergrund. |
| PDF zu JPEG | POST /v1/convert/pdf-to-jpeg |
Rendert jede PDF-Seite mit 144 DPI als JPEG; einseitige PDFs liefern ein JPEG, mehrseitige PDFs liefern ein ZIP mit einem JPEG pro Seite. |
| Bild komprimieren | POST /v1/convert/compress-image |
Komprimiert PNG, JPEG oder WebP direkt im Ausgangsformat (das Format bleibt unverändert): zunächst verlustfreie Optimierung, optional mit Herunterskalierung bei fixiertem Seitenverhältnis auf ein target_size_kb-Budget. |
Gemeinsame Konventionen#
- Authentifizierung: jeder Endpunkt erfordert entweder einen privaten API-Schlüssel (
X-API-Key: sk_...) oder ein JWT-Token eines öffentlichen Schlüssels (Authorization: Bearer <jwt_token>). Siehe Authentifizierung. - Request-Form: alle Endpunkte akzeptieren
multipart/form-datamit einem erforderlichen Feldfilesowie den optionalen Parameternoutput_filenameunddirect_download. Die SVG-Rasterungs-Endpunkte (svg-to-png,svg-to-jpeg,svg-to-webp) akzeptieren zusätzlich optionalewidth-/height-Pixelabmessungen, undcompress-imageakzeptiert ein optionalestarget_size_kb-Budget. Siehe Synchrone und asynchrone Jobs. - Antworten: Konvertierungen laufen synchron. Mit
direct_download=true(Standard) erhalten Sie die rohen konvertierten Bytes; mitdirect_download=falseerhalten Sie JSON-Metadaten mitpresigned_url,object_key,filename,file_sizeundconversion_time_seconds. - Fehler und Limits: Endpunkte liefern
400bei ungültiger oder beschädigter Eingabe,401bei fehlenden/ungültigen Zugangsdaten,402, wenn das monatliche Ops-Kontingent oder Speicherlimit Ihres Plans erreicht ist, und413, wenn eine Datei die maximale Dateigröße Ihres Plans überschreitet. Siehe Fehlercodes. - Qualität: Konvertierungs-Endpunkte kodieren mit maximaler Qualität (nicht konfigurierbar). Die Größe der Ausgabe ist dort konfigurierbar, wo oben angegeben:
width/heightbei den SVG-Rasterungs-Endpunkten,target_size_kbbeicompress-image.
Häufig gestellte Fragen#
Wie konvertiere ich ein Bildformat mit einer REST-API?#
Senden Sie einen multipart/form-data-POST-Request an den passenden /v1/convert/{source}-to-{target}-Endpunkt mit Ihrem Bild im Feld file, authentifiziert über X-API-Key oder ein Bearer-JWT-Token. Standardmäßig antwortet die API mit der roh konvertierten Datei; setzen Sie direct_download=false, um stattdessen JSON-Metadaten mit einer presigned Download-URL zu erhalten.
Vektorisieren die SVG-Ausgabe-Endpunkte mein Bild?#
Nein. Die Endpunkte JPEG, PNG, WebP und HEIC zu SVG kodieren das Rasterbild base64 und betten es als Daten-URI in ein SVG-<image>-Element ein, das auf die ursprünglichen Pixelabmessungen skaliert ist. Sie wandeln das Bild nicht in Vektorpfade um, und die base64-Kodierung erhöht die Dateigröße um etwa 33 %.
Was passiert mit Transparenz bei der Konvertierung?#
Das hängt vom Ausgabeformat ab. Konvertierungen zu JPEG und HEIC legen transparente Bereiche auf einen weißen Hintergrund, da diese Ausgaben ohne Transparenz erzeugt werden. Konvertierungen zu PNG und WebP erhalten den Alphakanal.