Flaggschiff-Bildqualität
Seedream 5 Pro rendert fotorealistische Szenen, Editorial-Produktshots und präzisen Bildtext in 1K oder 2K — auf Augenhöhe mit GPT Image und NanoBanana.
Seedream 5 Pro API Guide
Seedream 5 Pro ist ByteDances Flaggschiff-Bildmodell — starke mehrsprachige Textwiedergabe, Multi-Referenz-Editing und sauberer Fotorealismus. Auf Seedance API rufst du es als stabilen Alias über einfache REST-Endpunkte mit asynchronem Task-Polling und Preisen pro Bild auf.
1K- oder 2K-Ausgabe
1:1 bis 16:9, 9:16, 2:3, 3:2
Prompt oder bis zu 10 Referenzbilder
JSON über HTTPS
Starter-Request
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations liefert eine task_id. Polle GET /v1/images/generations/:task_id bis status SUCCESS ist und lies images[].url.
Teams wählen die Seedream 5 Pro API, wenn sie Flaggschiff-Bildqualität hinter einer vorhersehbaren REST-Oberfläche brauchen — ohne Provider-SDK und überraschende Schemaänderungen.
Seedream 5 Pro rendert fotorealistische Szenen, Editorial-Produktshots und präzisen Bildtext in 1K oder 2K — auf Augenhöhe mit GPT Image und NanoBanana.
Du rufst model "seedream-5-pro" auf. Routing, Kapazität und Fallbacks bleiben auf unserer Seite — deine Integration bekommt Upstream-Änderungen nicht mit.
9 Credits pro 1K-Bild, 18 pro 2K, plus 0,8 pro Referenzbild ab dem zweiten. estimated_credits kommt in jeder Create-Response zurück.
Die öffentliche Schnittstelle bildet ab, was das Modell wirklich kann: Text-zu-Bild und referenzgeführtes Editing mit bis zu zehn Eingabebildern.
Prompt bis zu 3000 Zeichen plus Seitenverhältnis und Auflösung senden — Komposition, Licht und Bildtypografie übernimmt das Modell.
1–10 öffentliche HTTPS-Bild-URLs in image_urls übergeben, um vorhandene Visuals zu bearbeiten, zu compositen oder umzustylen.
resolution auf "2k" setzen für druckreife Renderings und finale Assets. 1K deckt Previews und Iterationen ab.
Eine der stärksten Fähigkeiten — lesbarer Text auf Postern und Schildern in Englisch, Chinesisch, Japanisch und mehr.
Die Erstellung liefert sofort eine task_id. Status pollen, im eigenen Rhythmus wiederholen, UI reaktionsfähig halten.
Das Antwortformat bleibt stabil, egal wie das Upstream-Routing aussieht — consumed_credits, status und Bild-URLs sind normalisiert.
Drei Schritte vom API-Key zur fertigen Bild-URL.
Einloggen, API-Keys-Seite öffnen, Key für den Serverbetrieb kopieren. Im Backend halten — niemals im Browser-Code ausliefern.
POST /v1/images/generations mit model "seedream-5-pro", Prompt, aspect_ratio, resolution und optionalem image_urls aufrufen. Zurück kommen task_id und estimated_credits.
GET /v1/images/generations/:task_id aufrufen. Bei status SUCCESS images[0].url lesen und das Ergebnis anzeigen oder archivieren.
Zwei Endpunkte decken den kompletten Lebenszyklus ab — erstellen und pollen.
Erstellt einen Seedream-5-Pro-Task. Leeres image_urls = Text-zu-Bild; 1–10 URLs = Referenz-Editing. Antwort 202 mit task_id und estimated_credits.
Liefert IN_PROGRESS, SUCCESS mit images[].url oder FAILED mit Fehlerobjekt. Meldet nach Abschluss auch consumed_credits.
400 ungültige Parameter, 401 ungültiger Key, 402 zu wenig Credits, 404 Task unbekannt, 429 Rate-Limit, 503 Upstream nicht verfügbar. Volle Tabelle in den Docs.
| Parameter | Wert |
|---|---|
| model | Muss "seedream-5-pro" sein — das einzige öffentliche Modell auf dieser Route. |
| prompt | Text-Prompt oder Editing-Anweisung, 1–3000 Zeichen. |
| aspect_ratio | Eines von 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. Standard 1:1. |
| resolution | "1k" (Standard, 9 Credits) oder "2k" (18 Credits). |
| image_urls | 0–10 öffentliche HTTPS-URLs. Leeres Array = reines Text-zu-Bild. |
Unbekannte Parameter werden mit 400 UNKNOWN_PARAMETER abgelehnt — der Vertrag bleibt explizit. Vollständiges Schema in /docs/images.
Pauschalpreise pro Bild in Seedance-API-Credits. Die Create-Response enthält estimated_credits, der finale Status consumed_credits.
| Modus | Credits | Hinweise |
|---|---|---|
| Text-zu-Bild · 1K | 9 Credits / Bild | Standardauflösung — für Iterationen und Previews. |
| Text-zu-Bild · 2K | 18 Credits / Bild | Druckqualität für finale Assets. |
| Referenz-Editing | +0,8 Credits / Zusatzbild | Erstes Referenzbild im Basispreis enthalten; Bilder 2–10 kosten je 0,8. |
Antworten für Entwickler, die die Seedream 5 Pro API auf Seedance API evaluieren.
Seedance API stellt Seedream 5 Pro hinter einer stabilen REST-Oberfläche bereit — volle Modellfähigkeiten mit normalisierter Auth, Abrechnung und Responses, ohne Provider-Credentials selbst zu verwalten.
Leeres image_urls-Array für Text-zu-Bild. 1–10 öffentliche HTTPS-Bild-URLs für Editing oder Compositing — derselbe Endpunkt für beide Modi.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 und 3:2. Wähle das Verhältnis passend zur Platzierung — das Modell komponiert nativ, ohne zu croppen.
9 Credits pro 1K-Bild, 18 pro 2K. Referenz-Editing kostet 0,8 Credits pro Bild ab dem zweiten. estimated_credits steht vor dem Polling fest.
Typische 1K-Tasks brauchen etwa 15–25 Sekunden; 2K und Multi-Referenz länger. Status pollen — Tasks sind asynchron ausgelegt.
Nein — und solltest du nicht. Bearer-Key im Backend halten, unsere Endpunkte serverseitig aufrufen und nur eigene sichere Routen exposen.
Ja — mehrsprachiger Bildtext ist eine seiner Stärken. Poster, Preisschilder und lokalisierte Ads kommen mit lesbarem Text heraus.
Das komplette Request-Schema, Response-Beispiele, Fehlertabelle und Preisdetails stehen in /docs/images. Diese Seite ist der Integrationsüberblick.
API-Key holen, ersten Generierungstask absenden und Flaggschiff-Bildgenerierung noch heute ins Produkt integrieren.