Wan API Integrationsanleitung

Wan API anbindenÜberschriftenlink kopieren

Verwende https://api.wanapi.app als API-Basis-URL. Erstelle einen Schlüssel in den API-Schlüsseleinstellungen und sende ihn als Authorization: Bearer YOUR_API_KEY. Bewahre Schlüssel auf deinem Server auf. Der Playground verwendet deine Sitzung auf der Website und belastet dasselbe Kontoguthaben; du musst keinen Schlüssel in den Browser einfügen.

Der Zugang erfordert ein freigeschaltetes Konto mit ausreichendem Guthaben. Die aktuellen Tarife findest du unter Preise. Jedes Modell hat einen eigenen Endpunkt und eine eigene Modellseite.

GET /v1/models listet die Modelle auf, die deinem Schlüssel zur Verfügung stehen. Eine höhere Auflösung wechselt das Modell nicht automatisch.

AnfragefelderÜberschriftenlink kopieren

Alle vier Modelle verwenden dieselben 14 nativen Felder. Gib einen Prompt oder mindestens eine Medieneingabe an. Start- und Endbilder lassen sich nicht mit Referenzeingaben, file oder link kombinieren; file und link schließen sich gegenseitig aus.

Verwende stabile, direkt erreichbare Medien-URLs, die bis zum Abschluss der Aufgabe verfügbar bleiben. Die Prüfung der Videodauer liest begrenzte Datenbereiche per HTTP-Range-Anfrage; Videoserver müssen diese Anfragen unterstützen und lesbare MP4/MOV-Metadaten zur Dauer bereitstellen. Die Dauerprüfung folgt keinen Weiterleitungen. URLs in privaten Netzwerken werden nicht unterstützt. Referenz- und Ausgabedauer dürfen zusammen 30 Sekunden nicht überschreiten. Der Playground akzeptiert einen JSON-Anfrageinhalt von bis zu 32 MiB; verwende für größere Eingaben URLs.

Status abfragen und Video herunterladenÜberschriftenlink kopieren

Der Endpunkt zum Starten einer Aufgabe gibt bei jedem Modell eine öffentliche Aufgaben-ID zurück. Speichere sie, bevor du weitere Schritte ausführst.

{
  "task_info": {
    "id": "task_EXAMPLE",
    "status": "pending"
  }
}

Verwende das Abfragebeispiel im Kapitel des jeweiligen Modells. Beginne mit einem Intervall von fünf Sekunden und verlängere die Wartezeit nach vorübergehenden Fehlern. Bewahre die Modell-ID jeder Aufgabe zusammen mit ihrer Aufgaben-ID auf; frage sie nicht über den Endpunkt eines anderen Modells ab.

Die nativen Statuswerte sind pending, processing, completed und failed. Eine abgeschlossene Antwort enthält videos, ein Array mit einer vollständigen signierten Bunny-CDN-URL.

{
  "task_info": { "id": "task_EXAMPLE", "status": "completed" },
  "videos": ["https://reapiflexible.b-cdn.net/flexible/v1/expires/2026-11/20261113T06/wanapi-task_EXAMPLE/video.mp4?token=HS256_SIGNATURE&expires=1794550071"]
}

Verwende die zurückgegebene URL direkt zum Abspielen oder Herunterladen; dafür sind weder API-Schlüssel noch Authorization-Header erforderlich. Für Dateien gilt die bestehende Aufbewahrungsrichtlinie des Speichers. Eine erneute Aufgabenabfrage erzeugt kein weiteres Video, verursacht keine weiteren Kosten und verlängert die Verfügbarkeit der Datei nicht. Speichere benötigte Dateien in deinem eigenen Speicher. Aufgabenabfragen benötigen deinen API-Schlüssel und liefern nur Aufgaben deines Kontos.

Synchrone Responses und HintergrundverarbeitungÜberschriftenlink kopieren

Für Clients mit der Responses API akzeptiert POST /v1/responses eine Modell-ID, einen String als input und dieselben nativen Generierungsfelder. Verwende input statt prompt. Native Medienfelder wie reference_images bleiben Felder auf der obersten Ebene.

{
  "model": "wan3.0-video",
  "input": "A blue ball rolls across a white table.",
  "resolution": "480p",
  "duration": 2,
  "background": true
}

Speichere bei background: true die Response-ID und frage GET /v1/responses/{response_id} ab. Ohne background wartet die HTTP-Anfrage bis zum Abschluss. Mit stream: true werden während des Wartens Server-Sent Events verwendet. Die abschließende Assistentenausgabe enthält eine signierte Video-URL; behandle sie als privaten Link, der Zugriff gewährt, und veröffentliche sie nicht versehentlich. Für lange Generierungen und kurze Proxy-Zeitlimits empfehlen sich native Aufgabenanfragen oder Responses im Hintergrund.

Eine unterbrochene oder wegen Zeitüberschreitung beendete synchrone Anfrage bricht die Generierung nicht ab. Die Aufgabe bleibt auf dem Server bestehen. Sende dieselbe Generierung nicht automatisch erneut.

Abrechnung und FehlerbehandlungÜberschriftenlink kopieren

Der Preis ergibt sich aus dem Auflösungstarif des Modells multipliziert mit den abrechenbaren Sekunden. Sowohl Referenzvideosekunden als auch Ausgabesekunden zählen; Text-, Bild- und Audioeingaben fügen keine Videosekunden hinzu. Anfragen mit fester Dauer ohne Referenzvideo reservieren den Betrag für die angeforderte Ausgabedauer. Anfragen mit automatischer Dauer oder Referenzvideo reservieren zunächst bis zu 30 abrechenbare Sekunden. Anschließend wird anhand der gemessenen Nutzung abgerechnet und der nicht genutzte Betrag freigegeben. Schlägt die Generierung fehl, wird die Reservierung freigegeben. Statusabfragen starten keine weitere Generierung und verursachen keine erneute Belastung.

• Ungültige Parameter: Korrigiere die Anfrage vor dem erneuten Senden. Unbekannte native Felder werden abgelehnt.
• Unzureichendes Guthaben: Lade vor einer neuen kostenpflichtigen Anfrage Guthaben auf. Das Limit eines Schlüssels stellt kein Kontoguthaben bereit.
• Anfragelimits oder vorübergehende Fehler bei Statusabfragen: Wiederhole nur die Abfrage, mit zunehmenden Wartezeiten und einer begrenzten Gesamtdauer.
• Zeitüberschreitung beim Senden, Netzwerkunterbrechung oder fehlende Aufgaben-ID: Das Ergebnis kann unklar sein. Wiederhole den POST nicht automatisch; dadurch könnte eine zweite kostenpflichtige Aufgabe entstehen.
• Fehlgeschlagene Aufgabe: Zeige einen Fehler der Aufgabe getrennt von einer nicht verfügbaren Statusabfrage an.
• Downloadfehler: Wiederhole den Download der bereits abgeschlossenen Aufgabe, bevor du eine neue Generierung startest.

Generierungsanfragen werden weder automatisch wiederholt noch an ein anderes Modell umgeleitet. Es gibt keine zugesicherte Schnittstelle für Abbruch, Webhooks oder Idempotenzschlüssel. Bewahre die Aufgaben-ID auf und wende dich an den Support, wenn eine Anfrage mit unklarem Ergebnis untersucht werden muss.