Skip to main content
POST
Der Doku-Playground unterstützt keinen Datei-Upload: Verwenden Sie zum Testen die untenstehenden Codebeispiele für cURL, Python oder JavaScript.
Temporäre Speicherung: Hochgeladene Bilder werden nur 72 Stunden lang gespeichert. Danach ist die Bild-URL nicht mehr gültig. Verwenden Sie das Bild innerhalb dieses Zeitraums oder speichern Sie es rechtzeitig in Ihrem eigenen Speicherdienst.
Wichtige Änderung: Aus Gründen der Performance- und Kostenkontrolle unterstützen wir die direkte Übergabe von Base64-Bilddaten in den Generierungs-APIs nicht mehr. Bitte verwenden Sie diese API, um Bilder hochzuladen, die URL abzurufen und dann die Generierungs-API aufzurufen.

Warum Bilder zuerst hochladen?

  1. Performance-Optimierung – Base64-Kodierung vergrößert die Daten um 33 %; vorheriges Hochladen reduziert die Größe des Request-Bodys erheblich
  2. Bilder wiederverwenden – Einmal hochladen, die URL beliebig oft wiederverwenden, ohne dass redundante Übertragungen nötig sind

Workflow

Autorisierungen

string
erforderlich
Alle APIs erfordern eine Authentifizierung per Bearer TokenAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie ihn den Request-Headern hinzu:

Body

file
erforderlich
BilddateiUnterstützte Formate: JPEG (.jpg, .jpeg), PNG (.png), WebP (.webp), GIF (.gif)Maximale Dateigröße: 20 MB

Antwort

string
Öffentliche Zugriffs-URL des Bildes; kann direkt in Generierungs-APIs verwendet werden (72 Stunden gültig)
string
Ursprünglicher Dateiname
string
Erkannter MIME-Typ, z. B. image/jpeg
integer
Dateigröße in Bytes
integer
Upload-Zeitpunkt als Unix-Zeitstempel (Sekunden)

Vollständiges Beispiel: Bild-zu-Bild-Workflow

Python