> ## Documentation Index > Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream ## 1. Übersicht Die Seedream-Bildgenerierungs-API verwendet das OpenAI-artige Anfrageformat für die Bildgenerierung und unterstützt Text-zu-Bild, Bild-zu-Bild sowie Bildbearbeitung. Alle vier Modelle nutzen dieselbe Schnittstelle; der Client muss lediglich im Feld `model` des Anfrage-Bodys das gewünschte Modell auswählen. ### Unterstützte Modelle | Client-Modell-ID | Modell | Ausgabeart | | ------------------------------ | ----------------- | -------------------------------- | | `seedream-4-0-250828` | Seedream 4.0 | Einzelbild oder Bildserie | | `seedream-4-5-251128` | Seedream 4.5 | Einzelbild oder Bildserie | | `seedream-5-0-260128` | Seedream 5.0 Lite | Einzelbild oder Bildserie | | `dola-seedream-5-0-pro-260628` | Seedream 5.0 Pro | Einzelbild oder Ebenenaufteilung | ## 2. Schnittstelle und Authentifizierung ```http theme={null} POST https://{api_domain}/v3/bytedance/api/v3/images/generations ``` Anfrage-Header: ```http theme={null} Authorization: Bearer Content-Type: application/json ``` Verwenden Sie für `{api_domain}` die API-Domain Ihrer Plattform. Die Anfrage muss mit POST gesendet werden, der Body muss JSON sein. ## 3. Anfrageparameter ### 3.1 Allgemeine Parameter Verwenden Sie eine Modell-ID aus der obigen Tabelle. Beschreibung des Bildes; Chinesisch und Englisch werden unterstützt. URL eines Referenzbilds oder Base64-Data-URL. Sie können ein einzelnes Bild oder ein Array übergeben. Anzahl und Bildbeschränkungen richten sich nach den Grenzen des ausgewählten Modells. Verwenden Sie eine vom Modell unterstützte Auflösungsstufe oder `BreitexHöhe`. Wird der Parameter nicht übergeben, gilt der Standardwert des Modells. `url` oder `b64_json`, Standardwert ist `url`. Wird nur von Seedream 5.0 Lite und 5.0 Pro unterstützt: `jpeg` oder `png`. Seedream 4.0 und 4.5 geben stets JPEG aus; die Übergabe von `output_format` wird abgelehnt. Gibt an, ob ein KI-Generierungswasserzeichen hinzugefügt wird. Der Bild-Endpunkt unterstützt keine Streaming-Ausgabe; übergeben Sie nicht `true`. ### 3.2 Modellabhängige Parameter | Parameter | Verwendbare Modelle | Beschreibung | | ------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sequential_image_generation` | 4.0, 4.5, 5.0 Lite | Schalter für die Generierung von Bildserien. Bei Bedarf gemäß dem Upstream-Protokoll des jeweiligen Modells ausfüllen; weglassen, wenn keine Bildserie erzeugt wird. | | `sequential_image_generation_options` | 4.0, 4.5, 5.0 Lite | Optionen für die Bildserien-Generierung, zusammen mit `sequential_image_generation` zu verwenden. | | 1K-, 1.5K- und 2K-Stufen von `size` | 5.0 Pro | Pro unterstützt diese Stufen sowie explizite `BreitexHöhe`-Angaben. Pro unterstützt keine Bildserien-Parameter. Im Szenario der Ebenenaufteilung werden nur Stufen unterstützt (einschließlich auto); aktiviert wird sie über `layer_decomposition: true` (siehe Modellbeschränkungen). | Seedream 5.0 Pro unterstützt `sequential_image_generation` und `sequential_image_generation_options` nicht; die Übergabe eines dieser Felder wird abgelehnt. Senden Sie modellspezifische Parameter anderer Modelle nicht an Pro. ### 3.3 Beispiel für Text-zu-Bild Die folgende Anfrage dient als Beispiel mit Seedream 5.0 Pro. Alle vier Modelle nutzen dieselbe Schnittstelle; bei Seedream 4.0 oder 4.5 muss `output_format` entfernt werden, das Feld darf nur bei Seedream 5.0 Lite/Pro übergeben werden: ```bash theme={null} curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "dola-seedream-5-0-pro-260628", "prompt": "Ein Golden Retriever mit rotem Schal, bei natürlichem Licht an einem Bergsee vor schneebedeckten Bergen, filmische Fotografie", "size": "2K", "response_format": "url", "output_format": "jpeg", "watermark": true }' ``` ### 3.4 Beispiel für Bild-zu-Bild `image` kann eine einzelne URL, eine einzelne Base64-Data-URL oder ein Array aus Zeichenketten sein: ```json theme={null} { "model": "seedream-4-5-251128", "prompt": "Platzieren Sie die Person und die Kleidung aus dem Referenzbild in einer einheitlichen nächtlichen Stadtszene und bewahren Sie dabei die Merkmale der Person konsistent", "image": [ "https://example.com/person.png", "https://example.com/outfit.png" ], "size": "2560x1440", "response_format": "url" } ``` ### 3.5 Beispiel für Bildserien (nur 4.0, 4.5 und 5.0 Lite) Die Bildserien-Parameter gehören zu den ersten drei Modellen. Beispiel: ```json theme={null} { "model": "seedream-5-0-260128", "prompt": "Erstellen Sie drei Poster der vier Jahreszeiten in einem einheitlichen Stil", "sequential_image_generation": "auto", "sequential_image_generation_options": { "max_images": 3 }, "response_format": "url" } ``` Die verfügbaren Werte und Mengenbeschränkungen der Bildserien-Parameter entnehmen Sie bitte dem Upstream-Protokoll des ausgewählten Modells. ## 4. Antwort Beispiel einer erfolgreichen Antwort: ```json theme={null} { "created": 1786000000, "model": "seedream-4-5-251128", "data": [ { "url": "https://example.com/generated-image.jpeg", "size": "2560x1440", "output_format": "jpeg" } ], "usage": { "generated_images": 1, "input_images": 0 } } ``` * Bei `response_format=url` wird `data[].url` zurückgegeben; bei `response_format=b64_json` wird `data[].b64_json` zurückgegeben. * Seedream 4.0, 4.5 und 5.0 Lite können im Bildserien-Modus mehrere `data`-Einträge zurückgeben. * Seedream 5.0 Pro gibt im Bildgenerierungs-Szenario einen `data`-Eintrag zurück; bei aktivierter Ebenenaufteilung werden mehrere `data`-Einträge zurückgegeben (ein Basisbild + mehrere Ebenen). Jeder Eintrag enthält zusätzlich die Stapelreihenfolge der Ebene `z_index` (Basisbild: 0), den Namen `name`, die Beschreibung `description` und das Begrenzungsrechteck `bounding_box` (mit absoluten / normalisierten Koordinaten; das Basisbild gibt dieses Feld nicht zurück). * `model` gibt die für diese Anfrage verwendete Client-Modell-ID zurück. * Die Gültigkeitsdauer der Bild-URLs wird von der Plattform und dem Upstream-Dienst bestimmt; laden und speichern Sie die Bilder bitte umgehend nach Erhalt. ## 5. Modellbeschränkungen ### Seedream 4.0 / 4.5 / 5.0 Lite * Unterstützt Text-zu-Bild, Bild-zu-Bild und die Generierung von Bildserien. * Für Bildserien werden `sequential_image_generation` und das zugehörige options-Feld verwendet. * Anzahl der Eingabebilder, Bildgröße, Auflösung und Seitenverhältnis richten sich nach der Upstream-Dokumentation des jeweiligen Modells. Seedream 4.0 und 4.5 geben stets JPEG aus und unterstützen den Anfrageparameter `output_format` nicht; Seedream 5.0 Lite unterstützt `jpeg` und `png`. ### Seedream 5.0 Pro * Unterstützt Text-zu-Bild, Bild-zu-Bild mit einem einzelnen Bild sowie die Verschmelzung mehrerer Bilder. * Im Bildgenerierungs-Szenario wird ein erfolgreich generiertes Bild zurückgegeben. Bei aktivierter Ebenenaufteilung (`layer_decomposition: true`) werden ein Basisbild und mehrere Ebenen (maximal 16 Ebenen) zurückgegeben; in diesem Fall enthält `data` mehrere Einträge. Die Generierung von Bildserien (`sequential_image_generation`) wird nicht unterstützt. * `sequential_image_generation` und `sequential_image_generation_options` werden nicht unterstützt. * Für `size` können 1K, 1.5K, 2K oder eine explizite `BreitexHöhe`-Angabe verwendet werden. * Bei expliziter Angabe von Breite und Höhe müssen Seitenverhältnis und Gesamtpixelzahl die Modellbeschränkungen erfüllen; die tatsächliche Größe des Ausgabebilds ergibt sich aus `data[].size` in der Antwort. * Ebenenaufteilung wird unterstützt: Bei `layer_decomposition: true` wird ein einzelnes Eingabebild in ein Basisbild und bis zu 16 unabhängig bearbeitbare Ebenen zerlegt (jede Ebene ist ein PNG mit Alpha-Kanal). In diesem Szenario ist `image` erforderlich, und es darf nur ein Bild übergeben werden; mehrere Bilder führen zu einem Fehler. Die Ebenenaufteilung folgt dem Alles-oder-nichts-Prinzip: Schlägt eine einzige Ebene fehl, schlägt die gesamte Anfrage fehl; Teilerfolge werden nicht unterstützt. * `size`-Regeln für die Ebenenaufteilung: Die Auflösung des Basisbilds entspricht `size`; die Auflösung der einzelnen Ebenen liegt nahe an `size`, wobei jede Ebene das Seitenverhältnis ihres jeweiligen Bereichs im Originalbild beibehält, sodass die tatsächliche Pixelzahl der Ebenen unterschiedlich ausfällt. Dies bedeutet, dass die Ausgabebilder derselben Anfrage in unterschiedliche Pixel-Preisstufen fallen können. Für `size` sind 1K, 1.5K, 2K und auto möglich; Standard ist auto. ## 6. Abrechnung und Nutzung * 4.0, 4.5 und 5.0 Lite werden nach der Anzahl der erfolgreich generierten Bilder abgerechnet; bei der Generierung von Bildserien zählt die tatsächlich erfolgreiche Anzahl der Ausgaben. * 5.0 Pro wird nach erfolgreich ausgegebenen Bildern abgerechnet; bei mehreren Eingabebildern ist das erste Referenzbild kostenlos, zusätzliche Referenzbilder werden separat erfasst. Unterschiedliche Ausgabegrößen entsprechen unterschiedlichen Preisstufen. Bei aktivierter Ebenenaufteilung zählen das Basisbild und jede Ebene jeweils als ein erfolgreich ausgegebenes Bild und werden anhand der Pixel von `data[].size` der entsprechenden Preisstufe zugeordnet und separat abgerechnet (z. B. das Basisbild in einer Stufe mit hohen Pixelzahlen, einzelne Ebenen in Stufen mit niedrigeren Pixelzahlen); die endgültige Abrechnung ergibt sich aus der Summe der Mengen je Stufe. * Die Nutzungseinheit ist „Bild“ bzw. item. * Die genauen Preise entnehmen Sie bitte der Produkt-Preisseite Ihrer Plattform. ## 7. Fehlerbehebung | Szenario | Empfehlung | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | Modell nicht unterstützt | Prüfen Sie, ob `model` exakt mit der obigen Tabelle übereinstimmt. | | Prompt fehlt | Der Body muss einen nicht leeren Prompt enthalten. | | Bild kann nicht gelesen werden | Prüfen Sie Erreichbarkeit, Format, Größe und Pixelbeschränkungen der URL. | | `stream=true` | Der Bild-Endpunkt unterstützt keine Streaming-Ausgabe; entfernen Sie das Feld oder setzen Sie es auf `false`. | | Pro erhält Bildserien-Felder | Entfernen Sie die beiden Felder `sequential_image_generation*`. | | size ungültig | Verwenden Sie eine vom ausgewählten Modell unterstützte Stufe oder eine `BreitexHöhe`-Angabe innerhalb der Beschränkungen. |