APIMaster.ai

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, size und output_format identifizieren das Artefakt und seine tatsächlichen Abmessungen; background ist gegebenenfalls verfügbar.
  • z_index: 0 identifiziert die Basis; größere Indizes erscheinen über kleineren.
  • name und description beschreiben die Ebene.
  • bounding_box.absolute ist [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.normalized verwendet 0–1000-Koordinaten. Multiplizieren Sie horizontale/vertikale Koordinaten mit der Ziel-Canvas-Breite/-Höhe und teilen Sie durch 1000.
  • text_recognition erscheint 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.