Seedream 5.5 API — Generierung, RGBA, Bearbeitung, Ebenen und Rich-Text-OCR
Vollständige Anfrageparameter, Bildbeschränkungen, Ebenenrekonstruktion, Rich-Text-OCR und nutzungsbasierte Bildpreisgestaltung für doubao-seedream-5-5-261028.
Seedream 5.5
Verwenden Sie das Modell doubao-seedream-5-5-261028 mit POST https://apimaster.ai/v1/images/generations, einem JSON-Body und Authorization: Bearer YOUR_API_KEY. Erstellen Sie Ihren APIMaster-Schlüssel in der Konsole.
Unterstützt Text-zu-Bild, Bearbeitung mit bis zu zehn Referenzen, aufeinanderfolgende Bearbeitung, native transparente RGBA-Ausgabe, Ebenenzerlegung und Rich-Text-OCR. Die normale Generierung gibt ein Bild zurück. Die Zerlegung gibt eine Basis und separate Ebenen zurück. Streaming, sequenzielle Bildgenerierung und Websuche werden nicht unterstützt. Verwenden Sie den synchronen Endpunkt; erlauben Sie mindestens 300 Sekunden vor einem Client-Timeout und vermeiden Sie blinde erneute Übermittlung.
Offizielle Basispreise
Am 2026-11-13 mit den Volcengine-Preisen abgeglichen. Der konfigurierte Wechselkurs betrug 7 CNY pro USD.
| Posten | CNY pro Bild | Ungefährer USD-Basispreis |
|---|---|---|
| Jede Eingabereferenz, einschließlich der ersten | 0.05 | 0.00714286 |
| Ausgabe mit Breite × Höhe ≤ 2,610,000 Pixel | 0.13 | 0.01857143 |
| Ausgabe über 2,610,000 Pixel | 0.23 | 0.03285714 |
Generierung und Zerlegung verwenden dieselben Ausgabesätze. Berechnen Sie jede Basis/jede Ebene separat anhand ihrer tatsächlichen data[].size; die längste Kante bestimmt nicht die Stufe. 2048x1024 liegt in der niedrigeren Stufe. Zwei Eingaben plus eine Ausgabe der hohen Stufe kosten CNY 0.33 vor Konto-/Kanal-Multiplikatoren. Anders als bei Seedream 5.0 Pro ist die erste Referenz nicht kostenlos. Tatsächliche Kontobelastungen umfassen anwendbare Kanal-/Benutzergruppen-Koeffizienten und Ganzzahl-Quotenrundung. Siehe die Live-Modellkarte und Nutzungsprotokolle.
Text-zu-Bild
curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"doubao-seedream-5-5-261028",
"prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
"size":"1.5K",
"output_format":"png",
"background":"opaque",
"response_format":"url",
"watermark":false
}'
Parameter
| Feld | Typ / Standardwert | Regeln |
|---|---|---|
model |
erforderlicher String | doubao-seedream-5-5-261028. |
prompt |
String | Erforderlich für die Generierung; optional für die Zerlegung. Beschreiben Sie Inhalt, Stil, Seitenverhältnis, Text oder die Bearbeitungsstelle. Die offizielle Schreibhilfe empfiehlt ≤300 chinesische Zeichen oder ≤600 englische Wörter; dies ist eine Empfehlung, kein Byte-Limit. |
image |
String oder String[] | Öffentliche URL oder data:image/png;base64,.... Bis zu zehn Generierungsreferenzen; genau eine Eingabe für die Zerlegung. Lokale Dateisystempfade funktionieren nicht. |
size |
String | Generierung verwendet standardmäßig 2K; 1K, 1.5K, 2K oder exakt WIDTHxHEIGHT. Zerlegung verwendet standardmäßig auto, akzeptiert nur auto und diese drei Stufen. |
output_format |
String, png |
png oder jpeg. Bei der Zerlegung steuert dies nur die Basis; Ebenen sind immer PNG. |
background |
String, auto |
auto, transparent oder opaque, nur für die Generierung. Transparente Ausgabe erfordert PNG; lassen Sie dieses Feld bei der Zerlegung vollständig weg. |
response_format |
String, url |
url oder b64_json. Lesen Sie das passende Feld in jedem data[]-Element. |
watermark |
Boolean, true |
Setzen Sie false, um das sichtbare KI-Generierungswasserzeichen wegzulassen. |
optimize_prompt_options |
Objekt | Nur {"mode":"standard"} wird von 5.5 unterstützt; fast wird nicht unterstützt. |
layer_decomposition |
Boolean, false |
Aktivieren Sie die Zerlegung eines PNG/JPEG-Bildes. |
layer_decomposition_options |
Objekt | Zerlegungsoptionen unten. |
layer_decomposition_options.max_images |
Ganzzahl, 30 |
2–100, einschließlich der Basis. Ein Maximum, keine garantierte Anzahl. |
layer_decomposition_options.text_recognition |
Boolean, false |
Fordern Sie Rich-Text-OCR für reguläre Textebenen an. |
safety_identifier |
String | Stabile englische Benutzerkennung, höchstens 64 Zeichen; verwenden Sie einen Hash anstelle personenbezogener Kontaktdaten. |
Verwenden Sie nicht resolution, quality, n oder seed eines anderen Modells, um dieses Modell zu steuern. Diese sind in der offiziellen API nicht als seine entsprechenden Generierungssteuerungen aufgeführt. Legen Sie Zerlegungsgrenzen mit layer_decomposition_options.max_images fest.
Größen und Eingabebeschränkungen
Wählen Sie für die gewöhnliche Generierung eine Stufe (1K, 1.5K, 2K) und beschreiben Sie das Seitenverhältnis im Prompt oder geben Sie exakte Abmessungen an. Die exakte Ausgabefläche muss 921,600–4,624,220 Pixel betragen, bei einem Seitenverhältnis von 1:16–16:1, wobei beide Einschränkungen erfüllt sein müssen. 2880x1440 ist gültig; 512x512 ist zu klein. Es gibt keine Stufe 4K.
Die Zerlegung akzeptiert keine exakten Abmessungen. Mit auto behalten Basis-/Ebenengrößen innerhalb des unterstützten Bereichs nach Möglichkeit ihre ursprünglichen Abmessungen; kleinere/größere Elemente werden in Richtung 1K/2K skaliert, wobei ihr Seitenverhältnis erhalten bleibt. Zurückgegebene Ebenen können unterschiedliche Abrechnungsstufen belegen.
| Eingabebeschränkung | Generierung/Bearbeitung | Zerlegung |
|---|---|---|
| Anzahl | Bis zu 10 | Genau 1 |
| Formate | JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF | PNG, JPEG |
| Dateigröße pro Bild | ≤30 MB | ≤30 MB |
| Pixelbereich | 196–36,000,000; beide Seiten >14 px | 262,144–36,000,000 |
| Seitenverhältnis | 1:16–16:1 | 1:16–16:1 |
Verwenden Sie MIME-Typen in Kleinbuchstaben in Daten-URLs. Remote-Eingabe-URLs müssen für den Dienst erreichbar sein.
Bearbeitung und transparente Bilder
{
"model":"doubao-seedream-5-5-261028",
"prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
"image":["https://example.com/source.png","https://example.com/reference.png"],
"size":"1.5K",
"output_format":"png",
"watermark":false
}
Bei einer Eingabe kann image ein String sein. Bei aufeinanderfolgenden Bearbeitungen übergeben Sie die vorherige Ausgabe explizit als nächste Eingabe: Dies ist keine zustandsbehaftete Konversation, und jede Anfrage wird separat abgerechnet. Beschreiben Sie Koordinaten/Kästchen/Pfeile im Prompt oder zeichnen Sie Markierungen auf der Referenz; für diese Schnittstelle gibt es keinen separaten dokumentierten Positionierungsparameter mask.
Lassen Sie für die native transparente Generierung image weg, falls nicht erforderlich, und setzen Sie background: "transparent", output_format: "png", mit einem Prompt wie „a translucent blue glass butterfly, isolated asset, transparent background“. Die Bearbeitung kann bis zu zehn Referenzen verwenden; diese müssen nicht bereits Alphakanäle haben. transparent zusammen mit jpeg ist ungültig. Das background einer Antwort beschreibt die tatsächliche Transparenz (transparent oder opaque).
Zerlegung und Rich-Text-OCR
{
"model":"doubao-seedream-5-5-261028",
"image":"https://example.com/poster.png",
"prompt":"Separate the heading, circle and square into editable layers",
"layer_decomposition":true,
"layer_decomposition_options":{"max_images":4,"text_recognition":true},
"size":"auto",
"output_format":"png",
"watermark":false
}
Unterstützt eine Basis plus bis zu 99 Ebenen. max_images: 4 schließt die Basis ein. Lassen Sie background weg; jede Ebene ist transparentes PNG. Ein Fehler einer einzelnen Ebene lässt die gesamte Anfrage fehlschlagen, statt einen Teilerfolg zurückzugeben.
Lesen Sie alle data[]-Einträge:
url/b64_json,sizeundoutput_formatidentifizieren das Artefakt und seine tatsächlichen Abmessungen;backgroundist gegebenenfalls verfügbar.z_index: 0identifiziert die Basis; größere Indizes erscheinen über kleineren.nameunddescriptionbeschreiben die Ebene.bounding_box.absoluteist[left,top,right,bottom]in Pixeln der Ausgabebasis. Ändern Sie die Größe einer Ebene auf(right-left) × (bottom-top)und platzieren Sie sie bei(left,top); die Dateiabmessungen der Ebene können von ihrer Canvas-Ausdehnung abweichen.bounding_box.normalizedverwendet 0–1000-Koordinaten. Multiplizieren Sie horizontale/vertikale Koordinaten mit der Ziel-Canvas-Breite/-Höhe und teilen Sie durch 1000.text_recognitionerscheint nur, wenn angefordert und die Ebene erkannten regulären Text enthält. Handschrift, künstlerische Beschriftung und Nicht-Text-Ebenen können es weglassen.
OCR enthält text und lines[]; jede Zeile hat ihr eigenes bounding_box und gestyltes runs[]. Jeder Run hat text und style, die similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow und translucent enthalten können. Dies sind ungefähre visuelle Interpretationen, keine exakten ursprünglichen Designeigenschaften; die Schrifterkennung kann unknown zurückgeben.
Antwort, Speicherung und Fehler
Die Antwort enthält created, model, data[], usage.input_images und usage.generated_images. Die generierte Anzahl schließt Basis und Ebenen ein. Bewahren Sie die vollständigen Antwortmetadaten auf. Original-Download-URLs des Anbieters verfallen nach 24 Stunden; laden Sie Ihre Assets umgehend herunter/archivieren Sie sie.
Korrigieren Sie ungültige Abmessungen, Referenzanzahlen oder inkompatible Transparenzoptionen, bevor Sie es erneut versuchen. Behandeln Sie Authentifizierung, Berechtigungen, Moderation, Ratenbegrenzungen und Upstream-Fehler separat; interpretieren Sie einen Fehler niemals als erfolgreiche Generierung. IPM-Limits zählen generierte Bilder pro Konto/Modellversion; die Zerlegung reserviert max_images und gibt ungenutzte Kapazität nach Abschluss zurück, während die Abrechnung tatsächlich erzeugte Bilder verwendet.
Offizielle Quellen: Seedream 5.5, Bildgenerierungs-API, Preisgestaltung. Parameter am 2026-11-13 geprüft.
