Einführung
Wan 2.2 Text-zu-Video erzeugt einen Clip allein aus einem geschriebenen Prompt. Jede Anfrage liefert genau ein stummes Video von fünf Sekunden im Format 16:9 oder 9:16, gerendert in 480p oder 720p. Der Prompt darf bis zu 5.000 Zeichen lang sein und ist das einzige Pflichtfeld: Das Seitenverhältnis steht standardmäßig auf 16:9, die Auflösung auf 480p, und die Prompt-Erweiterung bleibt aus, solange Sie sie nicht einschalten.
Den passenden Wan-2.2-Modus nach Ausgangsmaterial wählen
| Was Sie zu Beginn haben | Modus | Was die Anfrage braucht |
|---|---|---|
| eine geschriebene Szene oder ein Skript | Wan 2.2 Text-zu-Video | einen Prompt; 16:9 oder 9:16 |
| ein Standbild, das erhalten bleiben soll | Wan 2.2 Bild-zu-Video | ein Bild und einen Prompt; das Bild bestimmt das Format |
Wichtige Funktionen und Highlights
Eine feste Länge von fünf Sekunden
Text-zu-Video hat keine Einstellung für die Dauer: Jeder Take ist genau fünf Sekunden lang, die Länge einer Anfrage steht also fest, bevor Sie sie senden. Fünf Sekunden tragen einen einzigen Beat – ein Motiv, eine Handlung, eine Kamerabewegung –, keine Abfolge mehrerer Ereignisse. Prompts, die auf diesen Umfang zugeschnitten sind, liefern die verlässlichsten Ergebnisse.
Zwei Formate, zwei Auflösungen
Das Seitenverhältnis ist standardmäßig 16:9, für Hochkant-Ausspielung 9:16. Quadratische Bilder und 4:3 gibt es nicht; rendern Sie für einen quadratischen Schnitt in 16:9 und beschneiden Sie im Schnitt. Die Auflösung ist 480p oder 720p, und sie ist die einzige Einstellung, die den Preis verändert – 480p ist damit die naheliegende Stufe für Entwürfe.
Nur Bild, kein Ton
Die Clips kommen ohne Tonspur, eine Audio-Einstellung gibt es nicht. Alles, was die Zuschauer spüren sollen, muss sichtbar sein: Das veröffentlichte Beispiel am verschneiten Bahnsteig baut seinen Rhythmus aus fallendem Schnee, Atemwolken in der Kälte und einer flackernden Bahnsteiglampe auf, statt sich auf Atmo zu verlassen.
Optionale Prompt-Erweiterung und Seed
Die Prompt-Erweiterung schreibt eine kurze Vorgabe vor der Generierung zu einer ausführlicheren um. Der Seed akzeptiert Werte von 0 bis 2147483647 und hält die Zufallsquelle fest, damit Sie jeweils nur eine Änderung vergleichen. Einen bildgenau identischen Clip bei einem zweiten Durchlauf garantiert er nicht.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Die Einstellung selbst, bis zu 5.000 Zeichen: wer, eine Handlung, eine Kamerabewegung, dann das Licht. Ein klares Verb bewegt das Ergebnis stärker als eine Reihe von Adjektiven. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | 16:9 oder 9:16, Standard 16:9. Quadratische oder 4:3-Formate gibt es an diesem Endpunkt nicht. |
resolution | Nein | 480p oder 720p, Standard 480p. Es ist die einzige Einstellung, die den Preis ändert. |
enable_prompt_expansion | Nein | Standardmäßig aus. Standardwert: |
seed | Nein | 0 bis 2147483647. Halten Sie ihn fest, wenn Sie jeweils nur eine Änderung vergleichen; lassen Sie ihn weg, wenn Sie Abwechslung wollen. |
Preis
Jede Anfrage liefert einen Clip von fünf Sekunden.
| Spezifikation | Preis |
|---|---|
| $0.24 / Anfrage |
| $0.48 / Anfrage |
Anwendungsfälle
Storyboard-Entwürfe in großer Zahl
Schreiben Sie jeden Storyboard-Beat als eigenen Prompt und rendern Sie die ganze Liste in 480p. Fünf Sekunden reichen, um Bildausschnitt und Bewegung zu beurteilen. Da jede Anfrage gleich lang ist und der Preis nur von der Auflösung abhängt, kennen Sie die Kosten eines Stapels schon vor dem Absenden. Die Takes, die Sie behalten, rendern Sie mit demselben Prompt und Seed in 720p neu.
Hochkant-Clips für Social-Media-Feeds
Stellen Sie das Seitenverhältnis auf 9:16 und beschreiben Sie eine durchgehende Handlung. Das veröffentlichte Nachtmarkt-Beispiel macht genau das in 720p: Eine junge Frau im gelben Regenmantel nimmt an einem Grillstand einen Spieß entgegen, Rauch und Dampf steigen durch Lichterketten auf, und sie dreht sich um und geht auf die Kamera zu, die langsam aus der Hand heranfährt.
Prüfen, ob eine Bildidee in Bewegung trägt
Bevor Sie einen Take in 720p angehen, lässt sich die Idee günstig testen. Das Beispiel mit der Leuchtturmtreppe ist als eine Handlung mit einer Kameraposition geschrieben – ein älterer Mann mit Laterne steigt die letzte Windung einer Wendeltreppe hinauf, eine tief angesetzte Kamera folgt ihm – und in 16:9 bei 480p gerendert.
Prompt-Leitfaden und Praxistipps
Einen Beat in fester Reihenfolge schreiben
Nennen Sie das Motiv, die eine Handlung, eine Kamerabewegung und zuletzt das Licht. Ein klares Verb bewegt das Ergebnis stärker als eine Reihe von Adjektiven: Ein Mann, der die letzte Windung einer Treppe hinaufsteigt und an einem Fenster stehen bleibt, gibt dem Clip innerhalb von fünf Sekunden einen Anfang und ein Ende.
Zeichen für Details nutzen, nicht für weitere Szenen
Die 5.000 Zeichen bieten Platz für Kostüm, Set, Wetter und Licht, aber fünf Sekunden tragen kein zweites Ereignis. Enthält eine Vorgabe mehrere Ereignisse, teilen Sie sie auf getrennte Anfragen auf und fügen Sie die Clips im Schnitt zusammen.
Den Seed beim Überarbeiten festhalten
Wählen Sie einen Seed und behalten Sie ihn, während Sie genau eine Sache ändern, etwa ein Verb, die Kamerabewegung oder das Seitenverhältnis. Das Nachtmarkt-Beispiel legt Seed 250728 fest, damit derselbe Bildausschnitt über mehrere Prompt-Fassungen hinweg vergleichbar bleibt. Wenn Sie Abwechslung wollen, lassen Sie den Seed weg.
Früh über die Prompt-Erweiterung entscheiden
Haben Sie nur eine Idee in einem Satz, schreibt der Dienst mit eingeschalteter Prompt-Erweiterung eine ausführlichere Vorgabe für Sie. Nennt Ihr Prompt bereits Motiv, Handlung, Kamera und Licht, lassen Sie sie aus, damit der Text so läuft, wie er geschrieben ist, und beurteilen Sie einen erweiterten Durchlauf immer im Vergleich zu einem ohne Erweiterung.
Erkennen, wann Text nicht reicht
Ein Prompt allein hält ein bestimmtes Gesicht oder Produkt nicht von Durchlauf zu Durchlauf stabil. Muss das Motiv einem freigegebenen Standbild entsprechen, wechseln Sie zu Wan 2.2 Bild-zu-Video und überlassen Sie das Aussehen dem Bild.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-2.2/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.




























