Seedream 5.0 Pro
Seedream 5.0 Pro API: Bilder aus Text, Bearbeitung mit Referenzen, Ebenenzerlegung, transparente PNGs, Anfragefelder, Antworten und Preise.
Seedream 5.0 Pro generiert ein Bild aus einem Prompt, bearbeitet oder kombiniert bis zu 10 Referenzbilder und zerlegt ein Bild in ein Basisbild mit bis zu 16 transparenten Ebenen. Die Ausgabe erfolgt in 1K, 1.5K, 2K oder exakten Pixelmaßen. Modelldetails und Playground.
Verbindung zu Wan API herstellen
Verwende https://api.wanapi.app als API-Basis-URL. Erstelle in den API-Schlüsseleinstellungen einen Schlüssel mit der Modellfamilie Wan und sende ihn als Authorization: Bearer YOUR_API_KEY. Bewahre Schlüssel auf deinem Server auf. Der Playground nutzt deine Website-Sitzung und belastet dasselbe Kontoguthaben.
GET /v1/models listet die für deinen Schlüssel verfügbaren Modelle auf. Seedream 5.0 Pro nutzt die OpenAI Images API: POST /v1/images/generations mit JSON oder POST /v1/images/edits mit JSON oder Multipart-Uploads. Die Anfrage liefert ihre Antwort, sobald das Bild fertig ist; es gibt keine Aufgabe, deren Status du abfragen musst.
| Einstellung | Seedream 5.0 Pro |
|---|---|
| Modell-ID | bytedance/seedream-5.0-pro |
size | 1K, 1.5K, 2K (Standard) oder WIDTHxHEIGHT mit 921.600–4.624.220 Pixeln und einem Seitenverhältnis von 1:16 bis 16:1. |
image | Bis zu 10 Referenzbilder. |
| Ausgabe | Ein Bild pro Anfrage oder ein Basisbild mit bis zu 16 Ebenen bei layer_decomposition. |
Ein Bild generieren
Setze WAN_API_KEY auf deinem Server auf deinen Schlüssel. Sende die Anfrage einmal; die Generierung ist normalerweise innerhalb einer Minute abgeschlossen. Setze daher das Zeitlimit des Clients auf mindestens vier Minuten.
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'Die Antwort folgt dem OpenAI Images-Format. Die Beispielwerte dienen der Veranschaulichung:
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}Bild-URLs bleiben 30 Tage lang verfügbar. Speichere die Dateien selbst, wenn du sie länger benötigst. Sende "response_format": "b64_json", um jedes Bild zusätzlich als Base64 in b64_json zu erhalten.
Seedream 5.0 Pro: Preise
Jedes generierte Bild wird nach seiner Pixelgröße pro Bild abgerechnet, zu einem Preis von 30 % unter dem offiziellen Tarif: Bis zu 2,61 Millionen Pixel (1K und 1.5K) gilt der niedrigere Tarif, für größere Bilder der höhere. Das erste Referenzbild ist kostenlos; für jedes weitere Referenzbild kommt der Referenztarif hinzu. Eine Anfrage, die vor der Generierung eines Bildes abgelehnt wird, wird nicht berechnet.
| Abgerechnete Position | Offizieller Preis | Wan API-Preis |
|---|---|---|
| Bild bis zu 2,61 MP (1K, 1.5K) | 0,045 $ | Nicht verfügbar |
| Bild über 2,61 MP (2K) | 0,09 $ | Nicht verfügbar |
| Ebenenzerlegung, jedes zurückgegebene Bild bis zu 2,61 MP | 0,0225 $ | Nicht verfügbar |
| Ebenenergebnis mit einem größeren Bild: jedes Bild bis zu 2,61 MP | 0,0225 $ | Nicht verfügbar |
| Ebenenergebnis mit einem größeren Bild: jedes Bild über 2,61 MP | 0,045 $ | Nicht verfügbar |
| Jedes Referenzbild nach dem ersten | 0,003 $ | Nicht verfügbar |
Wan API bietet Bilder mit Seedream 5.0 Pro, zusätzliche Referenzen und Ebenenzerlegung in 1K oder 1.5K zu einem Preis von 30 % unter dem offiziellen Preis pro Bild an. Enthält ein Ebenenergebnis ein Bild mit mehr als 2,61 MP, gilt der offizielle Tarif.
Bei der Ebenenzerlegung werden das Basisbild und jede zurückgegebene Ebene berechnet. Hat jedes zurückgegebene Bild höchstens 2,61 MP, gilt für jedes der ermäßigte Ebenentarif. Ist ein Bild größer, gilt für jedes Bild der offizielle Ebenentarif für seine jeweilige Größe. Die Schätzung deckt das Maximum von 17 Bildern ab.
Offizielle Preise: BytePlus ModelArk. Geprüft am 2026-10-23.
Bei der Ebenenzerlegung werden das Basisbild und jede zurückgegebene Ebene berechnet. Hat jedes zurückgegebene Bild höchstens 2,61 Millionen Pixel, kostet jedes 30 % weniger als zum offiziellen Ebenentarif. Ist eines der zurückgegebenen Bilder größer, was bei 2K immer der Fall ist, wird jedes Bild zum offiziellen Ebenentarif für seine jeweilige Größe abgerechnet. Dein Guthaben muss das Maximum von 17 Bildern abdecken; du zahlst nur für die zurückgegebenen Bilder.
Anfragefelder
Sende ein JSON-Objekt. model ist erforderlich; prompt ist erforderlich, außer wenn layer_decomposition auf true gesetzt ist. Unbekannte Felder werden abgelehnt.
| Feld | Typ | Vorgaben |
|---|---|---|
model | string | Erforderlich: bytedance/seedream-5.0-pro. |
prompt | string | Was generiert werden soll oder welche Elemente bei der Ebenenzerlegung getrennt werden sollen. Unterstützt Englisch, Chinesisch und weitere Sprachen; die besten Ergebnisse erzielst du mit weniger als etwa 600 englischen Wörtern. |
image | string oder string[] | Bis zu 10 Referenzbilder als HTTP(S)-URLs oder data:image/<format>;base64,... mit kleingeschriebener Formatangabe. Formate: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF; jeweils bis zu 30 MB; Seitenverhältnis 1:16 bis 16:1. |
size | string | Bildgenerierung: 1K, 1.5K, 2K (Standard) oder WIDTHxHEIGHT. Ebenenzerlegung: 1K, 1.5K, 2K oder auto (Standard). |
layer_decomposition | boolean | Standard false. true zerlegt genau ein PNG- oder JPEG-Bild in ein Basisbild und bis zu 16 Ebenen. |
optimize_prompt_options | object | {"mode": "standard"} (Standard) oder {"mode": "fast"}. Der schnelle Modus verkürzt die Generierungszeit bei etwas geringerer Qualität. |
output_format | string | jpeg (Standard) oder png. Bei der Ebenenzerlegung legt es das Format des Basisbildes fest; Ebenen sind immer PNG. |
background | string | opaque (Standard) oder transparent. Transparent benötigt genau ein Eingabebild mit Alphakanal und eine PNG-Ausgabe; es kann nicht mit Ebenenzerlegung kombiniert werden. |
watermark | boolean | Standard true: Fügt eine kleine Kennzeichnung als KI-generiert hinzu. Sende false, um sie zu entfernen. |
nsfw_checker | boolean | Standard true lässt die Inhaltsprüfung aktiviert. false sendet die Anfrage ohne diese Prüfung; der Preis bleibt gleich. |
response_format | string | url (Standard) oder b64_json. |
n | integer | Optional; muss 1 sein. |
stream, sequential_image_generation, tools, seed, guidance_scale und mask werden von diesem Modell nicht unterstützt und abgelehnt.
Referenzbilder bearbeiten und kombinieren
Übergib ein Bild mit einer Bearbeitungsanweisung oder mehrere Bilder zum Kombinieren:
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}POST /v1/images/edits akzeptiert dieselben Felder. Lade bei Multipart Dateien in den Feldern image oder image[] hoch und sende optimize_prompt_options als JSON-String.
Ebenenzerlegung
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}Die Antwort führt das Basisbild zuerst auf. Jede Ebene ergänzt ihre Stapelreihenfolge, Position und Beschreibung:
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}Schlägt eine Ebene fehl, schlägt die gesamte Anfrage fehl. Fordert der Prompt mehr Ebenen als das Limit an, können einzelne Ebeneninhalte entfallen.
Fehler
Fehler verwenden das OpenAI-Fehlerformat {"error": {"message", "type", "code"}}.
| HTTP | code | Bedeutung |
|---|---|---|
| 400 | invalid_request oder eine Validierungsmeldung | Ein Feld oder eine Kombination wird nicht unterstützt. Korrigiere die Anfrage; es wurde nichts berechnet. |
| 400 | content_policy_violation | Der Prompt, ein Eingabebild oder die Ausgabe wurde aufgrund der Inhaltsrichtlinie abgelehnt. Es wurde nichts berechnet. |
| 402 | insufficient quota | Lade vor dem erneuten Senden Guthaben auf. |
| 429 | rate_limited | Zu viele Anfragen. Versuche es später erneut. |
| 502 | submission_unknown | Das Ergebnis wurde nicht empfangen und die Anfrage wurde nicht berechnet. Prüfe deine Nutzungsprotokolle, bevor du sie erneut sendest. |
| 503 | upstream_unavailable | Die Bildgenerierung ist vorübergehend nicht verfügbar; die Anfrage wurde nicht berechnet. |
Wiederhole eine Anfrage nach einer Zeitüberschreitung niemals automatisch, ohne zuerst deine Nutzungsprotokolle zu prüfen.