Seedream 5 Pro API Guide

Seedream 5 Pro API für KI-Bildgenerierung

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.

Auflösung
1K / 2K

1K- oder 2K-Ausgabe

Seitenverhältnisse
7

1:1 bis 16:9, 9:16, 2:3, 3:2

Eingaben
T2I + I2I

Prompt oder bis zu 10 Referenzbilder

Schnittstelle
REST

JSON über HTTPS

Starter-Request

Seedream-5-Pro-Bildtask erstellen

seedream-5-pro
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.

Warum die Seedream 5 Pro API integrieren

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.

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.

Ein stabiler Modell-Alias

Du rufst model "seedream-5-pro" auf. Routing, Kapazität und Fallbacks bleiben auf unserer Seite — deine Integration bekommt Upstream-Änderungen nicht mit.

Planbare Credit-Preise

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.

Seedream 5 Pro API-Fähigkeiten

Die öffentliche Schnittstelle bildet ab, was das Modell wirklich kann: Text-zu-Bild und referenzgeführtes Editing mit bis zu zehn Eingabebildern.

Text-zu-Bild

Prompt bis zu 3000 Zeichen plus Seitenverhältnis und Auflösung senden — Komposition, Licht und Bildtypografie übernimmt das Modell.

Multi-Referenz-Editing

1–10 öffentliche HTTPS-Bild-URLs in image_urls übergeben, um vorhandene Visuals zu bearbeiten, zu compositen oder umzustylen.

2K-Hochauflösung

resolution auf "2k" setzen für druckreife Renderings und finale Assets. 1K deckt Previews und Iterationen ab.

Mehrsprachiger Bildtext

Eine der stärksten Fähigkeiten — lesbarer Text auf Postern und Schildern in Englisch, Chinesisch, Japanisch und mehr.

Asynchrone Job-Architektur

Die Erstellung liefert sofort eine task_id. Status pollen, im eigenen Rhythmus wiederholen, UI reaktionsfähig halten.

Provider-unabhängige Responses

Das Antwortformat bleibt stabil, egal wie das Upstream-Routing aussieht — consumed_credits, status und Bild-URLs sind normalisiert.

So rufst du die Seedream 5 Pro API auf

Drei Schritte vom API-Key zur fertigen Bild-URL.

1

API-Key erstellen

Einloggen, API-Keys-Seite öffnen, Key für den Serverbetrieb kopieren. Im Backend halten — niemals im Browser-Code ausliefern.

2

Generierungstask absenden

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.

3

Pollen und rendern

GET /v1/images/generations/:task_id aufrufen. Bei status SUCCESS images[0].url lesen und das Ergebnis anzeigen oder archivieren.

Endpunkt-Referenz

Zwei Endpunkte decken den kompletten Lebenszyklus ab — erstellen und pollen.

POST /v1/images/generations

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.

GET /v1/images/generations/:task_id

Liefert IN_PROGRESS, SUCCESS mit images[].url oder FAILED mit Fehlerobjekt. Meldet nach Abschluss auch consumed_credits.

Fehler und Limits

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.

Request-Parameter

ParameterWert
modelMuss "seedream-5-pro" sein — das einzige öffentliche Modell auf dieser Route.
promptText-Prompt oder Editing-Anweisung, 1–3000 Zeichen.
aspect_ratioEines 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_urls0–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.

Credit-Preise

Pauschalpreise pro Bild in Seedance-API-Credits. Die Create-Response enthält estimated_credits, der finale Status consumed_credits.

ModusCreditsHinweise
Text-zu-Bild · 1K9 Credits / BildStandardauflösung — für Iterationen und Previews.
Text-zu-Bild · 2K18 Credits / BildDruckqualität für finale Assets.
Referenz-Editing+0,8 Credits / ZusatzbildErstes Referenzbild im Basispreis enthalten; Bilder 2–10 kosten je 0,8.

Seedream 5 Pro API FAQ

Antworten für Entwickler, die die Seedream 5 Pro API auf Seedance API evaluieren.

Ist das die offizielle ByteDance Seedream 5 Pro API?

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.

Was unterscheidet Text-zu-Bild von Referenz-Editing?

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.

Welche Seitenverhältnisse unterstützt Seedream 5 Pro?

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.

Was kostet ein Seedream-5-Pro-Bild?

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.

Wie lange dauert eine Generierung?

Typische 1K-Tasks brauchen etwa 15–25 Sekunden; 2K und Multi-Referenz länger. Status pollen — Tasks sind asynchron ausgelegt.

Kann ich die API aus dem Browser aufrufen?

Nein — und solltest du nicht. Bearer-Key im Backend halten, unsere Endpunkte serverseitig aufrufen und nur eigene sichere Routen exposen.

Rendert Seedream 5 Pro Text im Bild?

Ja — mehrsprachiger Bildtext ist eine seiner Stärken. Poster, Preisschilder und lokalisierte Ads kommen mit lesbarem Text heraus.

Wo ist die vollständige API-Doku?

Das komplette Request-Schema, Response-Beispiele, Fehlertabelle und Preisdetails stehen in /docs/images. Diese Seite ist der Integrationsüberblick.

Erstelle dein erstes Seedream-5-Pro-Bild

API-Key holen, ersten Generierungstask absenden und Flaggschiff-Bildgenerierung noch heute ins Produkt integrieren.