Kurzantwort
- Die asynchrone Bild-Task-API mit model=doubao-seedream-5-5 aufrufen.
- size akzeptiert die Stufen 1K/1.5K/2K oder explizite BxH-Pixel mit insgesamt 921.600-4.624.220 Pixeln.
- metadata.background=transparent liefert RGBA-PNG. Bei Ebenen begrenzt max_images die Gesamtausgabe inklusive Basisbild: 2-100, Standard 30.
Wichtige Parameter
- model | string | erforderlich | doubao-seedream-5-5 | - | Verwende doubao-seedream-5-5 als exakte Modell-ID.
- prompt | string | optional | - | - | Erforderlich für Generierung und Bearbeitung; optional bei layer_decomposition=true.
- size | string | optional | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | Für die Generierung gilt der Modellstandard, für Ebenen auto. Stufen legen kein Seitenverhältnis fest; explizite Maße müssen zusammen 921.600-4.624.220 Pixel ergeben.
- image_urls | string[] | optional | - | 0-10 | Übergib 1-10 Referenzbilder im Format JPEG, PNG oder WEBP über image_urls. Lade lokale Dateien zuerst hoch und nutze dann die zurückgegebenen URLs.
- n | integer | optional | 1 | 1 | Verwende 1 oder lass das Feld weg. Die normale Generierung liefert ein Bild; die Ebenenanzahl legt dieses Feld nicht fest.
- layer_decomposition | boolean | optional | false | - | Für die normale Generierung deaktiviert lassen. Erfordert genau eine Referenz und kein metadata.background. Liefert ein Basisbild und transparente PNG-Ebenen; layer_decomposition_options.max_images begrenzt die Gesamtausgabe.
- layer_decomposition_options.max_images | integer | optional | 30 | 2-100 | Gesamtlimit der Ausgaben bei der Ebenenzerlegung, inklusive Basisbild. Es ist keine garantierte Anzahl; das Modell entscheidet über die benötigten Ausgaben.
- layer_decomposition_options.text_recognition | boolean | optional | - | - | Steuert die Texterkennung bei der Ebenenzerlegung. Aufgabenergebnisse enthalten text_recognition-Metadaten nur, wenn der Anbieter sie zurückgibt.
- metadata.output_format | string | optional | - | png | jpeg | Wenn weggelassen, gilt der Anbieterstandard; bei Transparenz wird png gewählt. Bei Ebenen betrifft es nur das Basisbild; alle anderen Ebenen sind immer PNG.
- metadata.background | string | optional | - | auto | opaque | transparent | Nur für Generierung und Bearbeitung. Bei layer_decomposition=true weglassen, auch bei opaque. transparent liefert RGBA-PNG und ist mit jpeg nicht möglich.
- metadata.watermark | boolean | optional | - | - | Auf false setzen, um das sichtbare Wasserzeichen zu deaktivieren.
- metadata.response_format | string | optional | url | url | b64_json | Form der Ergebnisausgabe; url wird empfohlen.
Häufige Fehler
- 400 invalid_input: Auslöser=size-Pixel außerhalb des Bereichs, mehr als 10 Referenzbilder oder layer_decomposition ohne genau ein Eingabebild.; Behebung=Prüfe size, die Anzahl der image_urls und die Eingabebedingungen von layer_decomposition anhand der Dokumentation.; Wiederholung=Erst nach Korrektur des Payload erneut versuchen.
- 429 rate_limit_exceeded: Auslöser=Anfragefrequenz, Parallelität oder Kontingent erreichen das Ratenlimit.; Behebung=Setze exponentielles Backoff ein und prüfe danach Anfragetakt und Kontingentverbrauch.; Wiederholung=Nutze 1s/2s/4s Backoff mit Jitter.










