Wan API

Acht Videomodelle, ein Schlüssel

Die vier Wan-Varianten — 3.0, 3.0 Prime, 3.0 Pro und 3.0 Prime Pro — stehen neben Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast und Seedance 2.0 Mini auf derselben Plattform. GET /v1/models zeigt, was der aktuelle Schlüssel darf; jedes Modell hat eine dokumentierte ID wie wan3.0-video oder w3.0-video-prime-pro.

Multimodale Eingabemodi

Eine Anfrage kann nur einen Textprompt enthalten, einen ersten oder letzten Frame, oder eine Referenzmenge: bis zu 10 Bilder, 5 Videoclips und 5 Audiodateien, zusätzlich ein Dokument oder eine öffentliche Webseite. Keyframe- und Referenzmodus sind getrennt und nicht kombinierbar; Prompts sind auf 20.000 Zeichen begrenzt.

Playground mit Vorschau des nativen Requests

Jede Modellseite bettet einen Playground ein, der den flachen nativen Request-Body des gewählten Modells aufbaut, leere optional Felder weglässt und die Verfügbarkeit vor dem Absenden prüft. Dabei nutzt er die Website-Session und dasselbe Guthaben — der Schlüssel muss nicht in den Browser eingefügt werden.

Asynchrone Task-API

Das Senden an einen Modell-Endpunkt liefert sofort eine öffentliche Task-ID; Statuswerte sind pending, processing, completed und failed, und die fertige Antwort enthält eine signierte Bunny-CDN-URL, die ohne Authorization-Header abgespielt oder geladen werden kann. POST /v1/responses unterstützt synchrones Warten, Hintergrundmodus und server-sent events.

Preissteuerung über die Prüfungsstufe

Das optionale Feld nsfw_checker wählt bei Wan 3.0 und Wan 3.0 Prime eine strenge oder mildere Inhaltsprüfung, und jede Stufe hat ihren eigenen Sekundenpreis. Pro-Varianten akzeptieren nur false. Eine abgelehnte Einsendung lässt sich mit dem anderen Wert und gleichbleibender öffentlicher Modell-ID erneut senden.

Guthaben und Task-Bereinigung

GET /v1/balance gibt das verfügbare Kontoguthaben und den Restbetrag des Limits des aufrufenden Schlüssels zurück. DELETE /v1/tasks/{task_id} löscht eine abgeschlossene Task samt gespeicherter Videos und letztem Frame. Die Website-Texte erscheinen zusätzlich maschinenlesbar unter /llms.txt und /llms-full.txt.

• Produkt- und E-Commerce-Teams: aus einem Standfoto eines Produkts eine langsame Umrundung oder einen Push-In machen und Form, Reflexionen und Labels prüfen, bevor der Clip in die Kampagne geht.
• Buch, Storyboard und Social-Schnitt: ohne Dreh und ohne Key-Art eine geschriebene Szene in eine bewegte Vorschau verwandeln und Licht, Kamerarichtung und Tempo am kurzen Clip beurteilen.
• Agenturen nach Brief: ein knappes Dokument oder eine öffentliche Seite als Input, damit aus einer schriftlichen Idee ein visueller Ausgangspunkt für eine Zielgruppe und eine Botschaft wird.
• Engineering-Teams mit Video-Integration: Raten, Laufzeiten und Referenzkontingente von Wan und Seedance nebeneinander vergleichen und das gewählte Modell weiter über einen Schlüssel und ein Guthaben nutzen.
• Figurenarbeit mit Referenzen: jedem hochgeladenen Asset eine Rolle zuweisen — Aussehen, Bewegung, Ton — damit auch längere Seedance-2.5-Szenen Figuren und Orte unterscheidbar halten.

Ist das ein offizieller Dienst von Alibaba oder ByteDance?

Nein. Wan API läuft unabhängig auf wanapi.app, ohne Verbindung zu oder Empfehlung von Alibaba, Wan oder ByteDance; diese Namen bezeichnen die eingebundenen Drittmodelle, deren Marken gehören ihren Inhabern.

Brauche ich ein Abo zum Generieren?

Ein monatliches Videopaket wird nicht angeboten. Zugang hat, wer ein aktiviertes Konto mit Guthaben hat, und der Preis ist der Auflösungspreis mal den abrechenbaren Sekunden.

Welche Sekunden werden berechnet?

Sekunden aus Referenzvideo plus Sekunden der generierten Ausgabe. Text, Bild und Audio fügen keine Sekunden hinzu, und generiertes Audio abzuschalten senkt den Preis nicht.

Kann ich einen Task abbrechen oder automatisch erneut senden?

Abbruch, Webhook und Idempotency-Key sind nicht ausgewiesen, Einsendungen werden weder automatisch erneut gesendet noch auf ein anderes Modell umgeschaltet. Nach Timeout oder fehlender ID erst die bestehende Task abfragen — ein weiteres POST könnte eine zweite kostenpflichtige erzeugen.

Wie lange bleiben die Videos verfügbar?

Der abgeschlossene Task liefert eine signierte CDN-URL ohne Schlüssel, doch Dateien folgen der Aufbewahrungsrichtlinie der Plattform. Abfragen verlängert diese Verfügbarkeit nicht, also Wichtiges selbst ablegen.

Welches Modell für den ersten Test?

Wan 3.0 deckt 480p bis 1080p mit dem niedrigsten Tarif ab; Prime ist ein eigenes Modell mit anderen Preisen; 2K und 4K gibt es nur bei den Pro-Varianten. Jede Seedance-Seite nennt eigene Dauer- und Referenzgrenzen, deshalb nach Deliverable wählen und nicht einfach höhere Auflösung beim günstigen Modell annehmen.

Lässt sich der Request-Body zwischen Modellen wiederverwenden?

Alle vier Wan-Modelle teilen die 14 nativen Generierungsfelder, aber Auflösungswerte, Modell-ID und nsfw_checker-Unterstützung unterscheiden sich: Pro-Varianten akzeptieren nur den milden Wert. Unbekannte Felder werden abgelehnt, also vorher die Seite des Zielmodells prüfen.

• Bei wanapi.app mit Google anmelden und im Konto Guthaben aufladen — ein Website-Konto allein schaltet die Generierung nicht frei.
• Schlüssel in API key settings anlegen und nur serverseitig aufbewahren; das Playground nutzt die Website-Session und dasselbe Guthaben.
• Modell im Überblick oder über GET /v1/models wählen, dann auf der Modellseite Auflösungswerte, Dauerbereich und Referenzlimits prüfen.
• Anfrage im Playground dieses Modells entwerfen und den angezeigten nativen Body kopieren, oder das JSON per dokumentierter Modell-ID selbst bauen.
• Nach dem Senden die zurückgegebene Task-ID sofort speichern und mit fünf Sekunden Intervall abfragen, bei temporären Fehlern verlängern.
• Über die signierte URL der fertigen Antwort abspielen oder laden und die Datei vor Ablauf der Aufbewahrung in den eigenen Speicher kopieren.