LogoWan API – Dokumentation
Startseite
X (Twitter)
Startseite

Erste Schritte

ÜberblickIntegrationsleitfadenGuthaben prüfenAufgabe löschen

Wan-Modelle

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance-Modelle

Seedance 2.5Seedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Bildmodelle

Seedream 5.0 Pro
X (Twitter)

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.

EinstellungSeedream 5.0 Pro
Modell-IDbytedance/seedream-5.0-pro
size1K, 1.5K, 2K (Standard) oder WIDTHxHEIGHT mit 921.600–4.624.220 Pixeln und einem Seitenverhältnis von 1:16 bis 16:1.
imageBis zu 10 Referenzbilder.
AusgabeEin 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.

Aktuelle TarifeUSD pro Bild
Seedream 5.0 Pro: Preise
Abgerechnete PositionOffizieller PreisWan 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 MP0,0225 $Nicht verfügbar
Ebenenergebnis mit einem größeren Bild: jedes Bild bis zu 2,61 MP0,0225 $Nicht verfügbar
Ebenenergebnis mit einem größeren Bild: jedes Bild über 2,61 MP0,045 $Nicht verfügbar
Jedes Referenzbild nach dem ersten0,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.

FeldTypVorgaben
modelstringErforderlich: bytedance/seedream-5.0-pro.
promptstringWas 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.
imagestring 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.
sizestringBildgenerierung: 1K, 1.5K, 2K (Standard) oder WIDTHxHEIGHT. Ebenenzerlegung: 1K, 1.5K, 2K oder auto (Standard).
layer_decompositionbooleanStandard false. true zerlegt genau ein PNG- oder JPEG-Bild in ein Basisbild und bis zu 16 Ebenen.
optimize_prompt_optionsobject{"mode": "standard"} (Standard) oder {"mode": "fast"}. Der schnelle Modus verkürzt die Generierungszeit bei etwas geringerer Qualität.
output_formatstringjpeg (Standard) oder png. Bei der Ebenenzerlegung legt es das Format des Basisbildes fest; Ebenen sind immer PNG.
backgroundstringopaque (Standard) oder transparent. Transparent benötigt genau ein Eingabebild mit Alphakanal und eine PNG-Ausgabe; es kann nicht mit Ebenenzerlegung kombiniert werden.
watermarkbooleanStandard true: Fügt eine kleine Kennzeichnung als KI-generiert hinzu. Sende false, um sie zu entfernen.
nsfw_checkerbooleanStandard true lässt die Inhaltsprüfung aktiviert. false sendet die Anfrage ohne diese Prüfung; der Preis bleibt gleich.
response_formatstringurl (Standard) oder b64_json.
nintegerOptional; 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"}}.

HTTPcodeBedeutung
400invalid_request oder eine ValidierungsmeldungEin Feld oder eine Kombination wird nicht unterstützt. Korrigiere die Anfrage; es wurde nichts berechnet.
400content_policy_violationDer Prompt, ein Eingabebild oder die Ausgabe wurde aufgrund der Inhaltsrichtlinie abgelehnt. Es wurde nichts berechnet.
402insufficient quotaLade vor dem erneuten Senden Guthaben auf.
429rate_limitedZu viele Anfragen. Versuche es später erneut.
502submission_unknownDas Ergebnis wurde nicht empfangen und die Anfrage wurde nicht berechnet. Prüfe deine Nutzungsprotokolle, bevor du sie erneut sendest.
503upstream_unavailableDie 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.

Seedance 2.0 Mini

Seedance 2.0 Mini API-Dokumentation: Videogenerierung, Einzelbilder und Referenzen, Anfragebeispiele, Statusabfragen, Downloads und Preise.

Inhaltsverzeichnis

Verbindung zu Wan API herstellenEin Bild generierenSeedream 5.0 Pro: PreiseAnfragefelderReferenzbilder bearbeiten und kombinierenEbenenzerlegungFehler