Seedream 5.5 API
Generiere und bearbeite Bilder oder zerlege Ebenen mit Seedream 5.5. Anfrageparameter, asynchrone Aufgaben, Bildmetadaten und aktuelle Preise pro Bild.
Seedream 5.5 generiert ein Bild aus Text oder bis zu 10 Referenzbildern. Die Ebenenzerlegung nimmt ein Bild entgegen und liefert ein Basisbild plus transparente Ebenen sowie optional ein Ergebnis der Drucktexterkennung.
Playground testen · OpenAPI JSON · Integrationsanleitung
Authentifizierung und Endpunkte
Verwende deinen Wan API-Schlüssel als Bearer-Token. Ein Schlüssel greift auf alle verfügbaren Modelle und Gruppen zu; am Schlüssel wählst du keine Gruppe aus.
| Methode | URL | Zweck |
|---|---|---|
| POST | https://api.wanapi.app/seedream55/v1/images/generations | Eine Bildaufgabe senden |
| GET | https://api.wanapi.app/seedream55/v1/tasks/{id} | Diese Aufgabe abfragen |
Die Modell-ID lautet seedream-5-5. Diese Endpunkte sind asynchron. Sende einmal, speichere die Aufgaben-ID und frage sie bis completed oder failed ab. Eine ungewisse Netzwerkantwort ist keine Erlaubnis zum erneuten Senden.
Ein Bild generieren
curl https://api.wanapi.app/seedream55/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
"size": "1K"
}'Eine akzeptierte Anfrage liefert eine Aufgabe statt Bilddaten:
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
-H "Authorization: Bearer $WAN_API_KEY"Frage dieselbe ID alle paar Sekunden ab. Bewahre sie auf, wenn deine Anwendung nicht weiter wartet, damit sie später fortfahren kann. Aufgaben-IDs und Zeitstempel dieser Anleitung dienen der Veranschaulichung.
Parameter
| Parameter | Typ | Standard | Regeln |
|---|---|---|---|
model | string | erforderlich | seedream-5-5 |
prompt | string | für Generierung erforderlich | Für Ebenenzerlegung optional. |
image | URL oder URL-Array | keiner | Bis zu 10 Referenzen; genau eine für Ebenen. Jede Referenz wird berechnet. |
size | string | 2K oder auto für Ebenen | Siehe Größenregeln unten. |
output_format | string | png | png oder jpeg. Steuert bei Ebenen nur das Basisbild. |
background | string | auto | auto, opaque, transparent. Transparent erfordert PNG. Lasse dieses Feld im Ebenenmodus vollständig weg. |
layer_decomposition | boolean | false | Eine Referenz in ein Basisbild und transparente PNG-Ebenen zerlegen. |
layer_decomposition_options.max_images | integer | 30 | Gesamtbildobergrenze, 2–100, einschließlich Basisbild. Nur im Ebenenmodus. |
layer_decomposition_options.text_recognition | boolean | false | Drucktextmetadaten in Ebenen anfordern. Nur im Ebenenmodus. |
optimize_prompt_options.mode | string | standard | Nur standard wird unterstützt. |
watermark | boolean | false | Ein Wasserzeichen für KI-generierte Inhalte anfordern. |
content_filter | boolean | true | Die Kunden-API akzeptiert false. Im Playground dürfen nur Administratoren die Prüfung deaktivieren. |
Die Parameter n, seed, stream, resolution, aspect_ratio, image_urls und response_format werden nicht unterstützt. Undokumentierte Felder werden verworfen und aktivieren diese Funktionen nicht. Multipart-Uploads, Base64 und data-URIs werden abgelehnt.
Ausgabegröße
Die Generierung akzeptiert 1K, 1.5K, 2K oder genaue WIDTHxHEIGHT-Pixelangaben. Genaue Größen müssen insgesamt 921.600–4.624.220 Pixel und ein Seitenverhältnis von 1:16 bis 16:1 haben. Beispielsweise ist 2048x1152 gültig. Ein Verhältnis wie 16:9 ist kein Größenwert.
Die Ebenenzerlegung akzeptiert auto, 1K, 1.5K oder 2K; genaue Pixelangaben werden in diesem Modus nicht unterstützt. auto richtet sich nach der Eingabe und reserviert den höheren Ausgabetarif. Das Modell hat keine 3K- oder 4K-Vorgabe.
Referenzbilder und Bearbeitung
Gib von dir gehostete öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten an. Unterstützt werden JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF, bis zu 30 MB pro Bild und höchstens 36.000.000 Pixel insgesamt. AVIF und JP2 werden nicht unterstützt. Eine URL muss direkt ein Bild ohne Anmeldung oder Browserprüfung bereitstellen.
{
"model": "seedream-5-5",
"prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
"image": "https://your-cdn.example/lighthouse.jpg",
"size": "2K"
}Übergib für mehrere Referenzen ein URL-Array und erkläre die Rolle jedes Bildes im Prompt. Das Ergebnis bleibt ein Bild. Referenz-URLs in Beispielen sind Platzhalter: Ersetze sie durch deine eigenen erreichbaren Dateien.
Ebenenzerlegung und Texterkennung
{
"model": "seedream-5-5",
"image": "https://your-cdn.example/poster.png",
"size": "1K",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 4,
"text_recognition": true
}
}Die Obergrenze umfasst das Basisbild; 4 bedeutet höchstens vier zurückgegebene Bilder, nicht vier Ebenen plus Basisbild. Das Modell kann weniger liefern. Lasse prompt für eine automatische Zerlegung weg oder benenne die zu trennenden Elemente. Ein Prompt kann Text unterdrücken, den er ausschließt.
Ebenen sind PNG-Dateien mit Transparenz. Baue das Bild in aufsteigender z_index-Reihenfolge auf, mit dem Basisbild bei 0. Falls ein Begrenzungsrahmen angegeben ist, skaliere die Ebene vor der Platzierung auf diesen Rahmen: Die Pixelabmessungen der Ebenendatei können von ihren Platzierungsabmessungen abweichen.
Das optionale text_recognition enthält den vollständigen text und lines. Jede Zeile kann eine bounding_box und formatierte runs enthalten. Der style eines Runs kann similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow und translucent umfassen. Dies sind Modellschätzungen. Künstlerische oder handschriftliche Schrift kann ohne Textergebnis bleiben; behandle das Feld als optional.
Abgeschlossene Antwort
{
"id": "task_example",
"model": "seedream-5-5",
"status": "completed",
"created_at": 1794432000,
"output": {
"data": [
{
"url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
"size": "1248x832",
"output_format": "png"
}
]
}
}Jedes Bild hat eine url und size. Weitere mögliche Felder sind output_format, background, z_index, name, description, bounding_box und text_recognition. bounding_box.absolute ist [left, top, right, bottom] in Pixeln des Basisbildes. bounding_box.normalized verwendet dieselben Koordinaten, skaliert auf 0–1000. Gehe nicht davon aus, dass optionale Metadaten bei jedem Bild vorhanden sind.
Behandle Bild-URLs als private Downloadlinks und speichere benötigte Dateien. Eine URL mit einem access-Token kann geöffnet werden, ohne deinen Konto-API-Schlüssel offenzulegen.
Preise
| Abrechenbares Bild | USD pro Bild |
|---|---|
| Ausgabe bis 2,61 MP (1K / 1.5K) | 0,017 $ |
| Ausgabe über 2,61 MP (2K) | 0,02975 $ |
| Jedes Referenzbild, auch das erste | 0,0068 $ |
Tarife werden automatisch aktualisiert. Ein API-Schlüssel funktioniert mit allen Modellen und Gruppen.
Die Ausgabegrenze liegt bei 2.610.000 Pixeln. Berechne die Kosten so:
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rateJede Referenz wird berechnet, einschließlich der ersten und des Ausgangsbildes für Ebenen. Für Generierung und Ebenen gelten dieselben Ausgabetarife. Beim Senden wird eine Ausgabe beziehungsweise die Ebenenobergrenze max_images plus Referenzen reserviert. Beim Abschluss zählen die eigenen Pixelabmessungen jedes zurückgegebenen Bildes; die ungenutzte Reservierung wird freigegeben. Die akzeptierte Aufgabe behält ihren Preisschnappschuss, auch wenn sich die Tarife während der Ausführung ändern. Fehlgeschlagene Aufgaben werden erstattet.
Fehler und Wiederholungsverhalten
Ungültige Parameter werden vor dem Senden abgelehnt. Unzureichendes Guthaben oder Schlüsselkontingent verhindert die Generierung. Authentifizierung und Eigentumsprüfung gelten sowohl beim Senden als auch beim Abfragen. Eine fehlgeschlagene Aufgabe liefert status: "failed" mit einem error-Objekt.
Wiederhole eine fehlgeschlagene Statusabfrage mit derselben Aufgaben-ID. Wiederhole einen Generierungs-POST nicht automatisch, auch nicht nach einem Timeout: Er könnte bereits akzeptiert worden sein. Solange der vorgelagerte Dienst normalen Fortschritt meldet, bleibt die Aufgabe ausstehend. Eine Aufgabe ohne normalen vorgelagerten Status oder erfolgreiche Auslieferung während drei aufeinanderfolgenden Stunden schlägt fehl und wird erstattet.
Die Seedream 5.5 Anleitung zeigt eine Anwendungsschleife, die die Aufgaben-ID speichert und wieder aufnimmt.
Seedream 5.0 Pro
Seedream 5.0 Pro API: Bilder aus Text, Bearbeitung mit Referenzen, Ebenenzerlegung, transparente PNGs, Anfragefelder, Antworten und Preise.
Claude API
Claude per Anthropic Messages oder OpenAI Chat Completions aufrufen: Modell-IDs, Streaming und aktuelle Token- und Cache-Preise nach Gruppe.