Einführung
Wan 3.0 Pro Text-zu-Video schreibt eine Einstellung aus einem Prompt und liefert sie in 1080p, 2K oder 4K für 2 bis 30 Sekunden, mit generiertem Ton in derselben Datei. prompt ist das einzige Pflichtfeld und nimmt bis zu 20.000 Zeichen auf. Ein natives Wan-3.0-Rendering endet bei 1080p; die Stufen 2k und 4k werden daher aus diesem Rendering vergrößert, nicht in dieser Größe gezeichnet. Eine 480p- oder 720p-Stufe gibt es auf diesem Endpunkt nicht – diese Größen deckt Wan 3.0 ab.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Aus einem schriftlichen Briefing entstehen Szene, Handlung, Kamerabewegung und gegebenenfalls Ton. | Wan 3.0 Pro Text-zu-Video |
| Ein freigegebenes Startbild bestimmt Motiv und Komposition; die Beschreibung steuert die anschließende Bewegung. | Wan 3.0 Pro Bild-zu-Video |
| Getrennte Referenzen können Identität, Ort, Bewegung oder Klang mit jeweils einer klaren Rolle leiten. | Wan 3.0 Pro Referenz-zu-Video |
Wichtige Funktionen und Highlights
Drei Liefergrößen aus einem nativen Rendering
resolution akzeptiert 1080p (Standard), 2k oder 4k. Die beiden größeren Stufen strecken, was das Modell gezeichnet hat, statt mehr zu zeichnen; sie eignen sich für Material, das beschnitten, getrackt oder projiziert wird, und sind nur so gut wie das Rendering darunter. Finden Sie die Einstellung zuerst in 1080p und behandeln Sie 4K als Lieferschritt.
Prompt-Erweiterung ist von Anfang an aktiv
In dieser Familie steht enable_prompt_expansion standardmäßig auf true. Die Erweiterung ergänzt ein dünnes Briefing, was beim Skizzieren praktisch ist, schreibt ein detailliertes aber um. Sobald Ihr Prompt eine präzise Einstellungsbeschreibung ist, setzen Sie das Feld auf false, damit genau Ihre abgestimmte Formulierung ausgeführt wird.
Adaptives Format, solange Sie keines festlegen
aspect_ratio steht standardmäßig auf adaptive, das Modell wählt also das Format. Nennen Sie 16:9, 4:3, 1:1, 3:4 oder 9:16, wenn das Lieferformat feststeht: Das Zaun-Beispiel verlangt 9:16 für ein Hochformat, während Parfum-, Schwarzweiß- und Tattoo-Beispiel alle 16:9 festlegen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Motiv, eine Handlung, eine Kamerabewegung, dann Licht und Ton. Bei 4K kostet ein vages Briefing echtes Geld – schreiben Sie den Shot, nicht die Stimmung. mindestens 1 Zeichen · höchstens 20000 Zeichen |
resolution | Nein | 1080p, 2k oder 4k, Vorgabe 1080p. |
aspect_ratio | Nein | 16:9, 4:3, 1:1, 3:4, 9:16 oder adaptive. Vorgabe ist adaptive, womit das Modell wählt; nennen Sie ein Verhältnis, wenn das Ausgabeformat feststeht. |
duration_seconds | Nein | Jede ganze Zahl von 2 bis 30, Vorgabe 5, oder -1 für die automatische Dauer, bei der das Modell die Länge wählt: Das Maximum von 30 Sekunden wird vorab reserviert, abgerechnet w… |
generate_audio | Nein | Standardmäßig an. Der Ton entsteht zusammen mit dem Bild und kommt in derselben Datei. Standardwert: |
enable_prompt_expansion | Nein | In dieser Familie standardmäßig an. Sie füllt dünne Briefings auf und schreibt ausführliche um – ausschalten, sobald Ihr Prompt eine präzise Shot-Beschreibung ist. Standardwert: |
seed | Nein | 0 bis 2147483647. Festhalten, während Sie Auflösung oder Dauer abstimmen, sonst ändert jede Wiederholung zwei Dinge gleichzeitig. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.144 / Sekunde |
| $0.16 / Sekunde |
| $0.184 / Sekunde |
Anwendungsfälle
Parfum- und Beauty-Spots unter hartem Licht
Das Parfum-Beispiel ist ein Fünf-Sekunden-Spot in Zeitlupe: Eine erwachsene Frau im rückenfreien schwarzen Kleid dreht sich von einem regengepeitschten Fenster weg, ein einzelnes hartes Führungslicht läuft ihre Wirbelsäule hinab, Tropfen fliegen aus ihrem Haar, auf der Tonspur ein tiefer Celloton und Regen. Glänzender Stoff, eine harte Lichtquelle und kleine schnelle Partikel zerfallen beim Vergrößern zuerst – prüfen Sie genau diese Stellen in einer 2K- oder 4K-Lieferung.
Stoff, bewegt von einer äußeren Kraft
Zwei Beispiele führen Kleidung über eine einzige Kraft, statt zu beschreiben, wie sie sitzt. Im Schwarzweiß-Modefilm peitscht drei Meter Seidenchiffon vor einer industriellen Windmaschine um den Körper und windet sich unter hartem Führungslicht vor schwarzem Hintergrund um eine Schulter. Im Zaun-Beispiel drückt der Abgasstrahl eines landenden Flugzeugs die Kleidung zweier Menschen flach an ihre Körper. Wer die Kraft benennt, gibt dem Stoff eine Ursache, der er folgen kann.
Prompt-Leitfaden und Praxistipps
In 1080p erkunden, dann den gewählten Seed neu rendern
Finden Sie die Einstellung bei 5 Sekunden und 1080p mit festem seed, ändern Sie pro Lauf ein Feld und senden Sie erst dann denselben Prompt mit demselben Seed und resolution auf 4k. Wer Auflösung und Formulierung im selben Lauf ändert, kann nicht mehr erkennen, was das Ergebnis bewegt hat.
Die Einstellung schreiben, nicht die Stimmung
Motiv, eine Handlung, eine Kamerabewegung, dann Licht und Ton. Der Tattoo-Studio-Prompt ist ein gutes Vorbild: Kerzen und eine Schreibtischlampe als einziges Licht, behandschuhte Hände, die ein Motiv über den Rippen schattieren, ein Zucken, ein langsames Ausatmen und ein Grinsen über die Schulter, eine surrende Maschine, eine sehr langsame Ranfahrt. In 4K ist ein vages Briefing ein teurer Weg herauszufinden, was Sie gemeint haben.
Die gewünschten Geräusche benennen
Ton entsteht mit dem Bild, also listen Sie seine Quellen auf: Der Parfum-Spot verlangt „low cello note and rain“, der Windmaschinen-Film „the roar of the fan and snapping cloth“. Setzen Sie generate_audio auf false, wenn ein Komponist den Spot vertont. Die Familie nimmt unzensierte Prompts ohne Erklärung pro Request an; Einwilligung, Rechte, Alter und lokales Recht aller dargestellten Personen liegen in Ihrer Verantwortung.
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-3.0-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.
