Seedream 5.0 Pro

Seedream 5.0 Pro ist das Bildmodell von ByteDance. Eine Anfrage erstellt ein Bild aus einem Prompt oder einem Prompt mit bis zu 10 Referenzbildern oder teilt ein Bild in ein Hintergrundbild und bis zu 16 transparente Ebenen auf. Sende die Anfrage, behalte die zurückgegebene Aufgaben-ID und lies die fertigen Bilder aus der Aufgabe aus. Referenzbilder werden als URLs übergeben.

Modell-IDs

Aktuelle Preise findest du auf der Modellseite.

Kurzbeispiel

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Endpunkt

POST https://api.seedrouter.ai/v1/images/generations

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Bild. Frage GET /v1/tasks/{task_id} für das Ergebnis ab. Bewahre API-Schlüssel im serverseitigen Code auf. Referenzbilder und die Aufteilung in Ebenen werden in derselben Anfrage über image übergeben; /v1/images/edits wird für dieses Modell nicht verwendet und gibt 400 zurück.

Parameter

Felder außerhalb dieser Liste werden vor dem Weiterleiten der Anfrage entfernt; sie verursachen nie einen Fehler und verändern die Ausgabe nicht. n, stream, seed, response_format und sequenzielle Generierung sind nicht verfügbar. callback_url ist nicht verfügbar; frage stattdessen die Aufgabe ab.

Ausgabegröße

Eine Auflösungsstufe legt die Größe fest, der Prompt das Format. Nenne das Seitenverhältnis in prompt (zum Beispiel „ein Querformat in 16:9“), und das Modell wählt den Bildrahmen:

Sende für einen festen Bildrahmen exakte Pixelmaße statt einer Auflösungsstufe. 1K und 1.5K kosten gleich viel; 2K und jede Größe über 2,61 Millionen Pixel kosten mehr (siehe Preisdimensionen).

Referenzbilder

Übergib ein Bild, um es zu bearbeiten, oder 2–10, um sie zu kombinieren. Sage in prompt, was bleiben und was sich ändern soll. Beziehe dich anhand der Reihenfolge auf die Bilder („die Jacke aus Bild 1“).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Aufteilung in Ebenen

Sende genau ein Bild mit layer_decomposition: true. Die Aufgabe liefert zuerst das Hintergrundbild und danach jede Ebene als transparentes PNG.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Jede Ebene enthält z_index (das Hintergrundbild ist 0; höhere Werte liegen darüber), name, description und bounding_box. bounding_box.absolute ist [left, top, right, bottom] in Pixeln des Hintergrundbilds; bounding_box.normalized beschreibt denselben Rahmen in Tausendsteln der Breite und Höhe des Hintergrundbilds. Um das Bild wieder zusammenzusetzen, skaliere jede Ebene auf ihren Rahmen und platziere sie in aufsteigender z_index-Reihenfolge auf dem Hintergrundbild.

Mit size: "auto" behalten das Hintergrundbild und jede Ebene ihre Größe im Eingabebild. Die Eingabe muss PNG oder JPEG sein und eine Gesamtpixelzahl (Breite × Höhe) zwischen 262.144 (512 × 512) und 36.000.000 (6000 × 6000) haben.

Transparenter Hintergrund

Sende ein PNG mit Alphakanal und background: "transparent", um ein PNG mit transparentem Hintergrund zu erhalten:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Medieneingaben

Jedes Referenzbild ist eine öffentliche HTTP(S)-URL. Base64-Daten-URIs werden nicht akzeptiert: Lade die Datei in deinen eigenen Speicher hoch und übergib ihre URL. Akzeptierte Formate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF, mit jeweils bis zu 30 MB, einem Seitenverhältnis zwischen 1:16 und 16:1, einer Breite und Höhe von jeweils mehr als 14 Pixeln und insgesamt höchstens 36.000.000 Pixeln. Die Aufteilung in Ebenen nimmt nur PNG oder JPEG an.

Preisdimensionen

Aktuelle Tarife findest du im Preisabschnitt des Modells. Seedream 5.0 Pro wird je nach Anwendungsfall und Pixelstufe pro Ausgabebild berechnet, zuzüglich jedes Referenzbilds nach dem ersten:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• Die niedrigere Preisstufe gilt für Bilder mit bis zu 2,61 Millionen Pixeln (1.5K und kleiner); alles darüber fällt in die höhere Preisstufe.
• Bei der Aufteilung in Ebenen werden das Hintergrundbild und jede Ebene berechnet. Für die gesamte Anfrage gilt dieselbe Preisstufe: der niedrigere Preis nur dann, wenn jedes zurückgegebene Bild innerhalb von 2,61 Millionen Pixeln bleibt.
• Der bei Annahme einer Aufgabe reservierte Betrag deckt das größte Ergebnis ab: ein Bild in der angeforderten Preisstufe oder 17 Bilder bei der Aufteilung in Ebenen (auto zählt zur höheren Preisstufe). Anschließend werden die tatsächlich zurückgegebenen Bilder berechnet und die Differenz freigegeben.

Endgültige Kosten findest du im Nutzungsverlauf deines Kontos. Fehlgeschlagene Aufgaben werden nicht berechnet.

Ausgabeschema

Das Absenden liefert die Aufgabe:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Aufgabe abrufen

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Frage alle 10–20 Sekunden ab, bis status den Wert completed oder failed hat. Eine Zeitüberschreitung des Netzwerks während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist: Behalte die Aufgaben-ID und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.

Abgeschlossene Aufgabe

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Eine Aufgabe zur Aufteilung in Ebenen listet zuerst das Hintergrundbild und danach jede Ebene auf:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

In unseren Tests dauerte ein 1K-Bild etwa 35–55 Sekunden und eine Aufteilung in Ebenen mit 1K, die ein Hintergrundbild und 13 Ebenen lieferte, etwa 140 Sekunden.

Fehler

Anfragen, die vor der Erstellung einer Aufgabe abgelehnt werden, geben einen HTTP-Fehler mit einem error-Objekt zurück und werden nicht berechnet. Eine Aufgabe, die nach der Annahme fehlschlägt, gibt bei der Abfrage HTTP 200 zurück, zusammen mit status: "failed" und einem error-Objekt.

Codes, HTTP-Status und Hinweise zu Wiederholungen findest du im gemeinsamen Fehlerkatalog.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Kommt es beim Senden selbst zu einer Zeitüberschreitung, prüfe deine Aufgaben, bevor du erneut sendest: Die erste Anfrage wurde möglicherweise bereits angenommen.

Tipps

• Beginne zum Ausprobieren mit 1K oder 1.5K; 1.5K kostet genauso viel wie 1K.
• Nenne bei einer Auflösungsstufe das Format im Prompt oder sende exakte Pixelmaße für ein festes Layout.
• Sage bei mehreren Referenzbildern, was jeweils übernommen werden soll, und beziehe dich anhand der Reihenfolge auf sie.
• Setze watermark: false, wenn du ein Bild ohne Kennzeichnung brauchst; standardmäßig wird eine hinzugefügt.
• Liste bei der Aufteilung in Ebenen die zu trennenden Elemente auf, um die Anzahl der Ebenen klein zu halten.

Weiterführend

• Seedream 5.0 Pro Playground und Preise
• OpenAPI herunterladen
• Markdown zum Kopieren