Einführung
Wan 3.0 Prime Bild-zu-Video animiert einen Startframe für 2 bis 30 Sekunden mit dem Prime-Rendering, mit denselben Feldern wie Wan 3.0 Bild-zu-Video. image_url ist Pflicht und wird exakt zum ersten Frame; der Prompt ist optional und muss nur die Bewegung beschreiben; last_image_url legt optional den letzten Frame fest. Die Auflösung ist 480p, 720p oder 1080p mit 720p als Standard, und Ton wird mit dem Bild erzeugt, sofern Sie generate_audio nicht auf false setzen.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Aus einem schriftlichen Briefing entstehen Szene, Handlung, Kamerabewegung und gegebenenfalls Ton. | Wan 3.0 Prime Text-zu-Video |
| Ein freigegebenes Startbild bestimmt Motiv und Komposition; die Beschreibung steuert die anschließende Bewegung. | Wan 3.0 Prime Bild-zu-Video |
| Getrennte Referenzen können Identität, Ort, Bewegung oder Klang mit jeweils einer klaren Rolle leiten. | Wan 3.0 Prime Referenz-zu-Video |
Wichtige Funktionen und Highlights
Set und Garderobe aus dem Standbild, Handlung aus dem Prompt
Da das Bild den Look schon liefert, kann die ganze Anfrage auf Bewegung und Ton ausgerichtet werden. Das Saunabeispiel beginnt mit einem Standbild, das Kulisse und Outfit bereits enthält; der Prompt beschreibt eine Kelle Wasser, die auf heißen Stein trifft, eine Dampfwolke, die Innenseite eines Handgelenks über das Schlüsselbein und eine Tonzeile mit Zischen, knarrender Zeder und langsamem Atmen.
Ein festes Ende macht lange Veränderungen sicher
last_image_url lässt den Clip exakt auf einem gelieferten Bild enden. Das Tanzflächen-Beispiel beginnt auf einer leeren Fläche und endet auf einem gelieferten Frame eines vollen Raums, 10 Sekunden in 1080p und 3:4 ohne Ton – das Modell erfindet also, wie sich der Raum füllt, nicht, womit er am Ende gefüllt ist.
Standardmäßig das Format des Frames
Lassen Sie aspect_ratio weg, behält der Clip das Format des Startframes; ein abweichender Wert beschneidet. Zulässig sind JPEG, PNG ohne Transparenz, BMP oder WEBP mit 240 bis 8000 Pixeln pro Seite, bis 20 MB und nicht breiter als 8:1. Für den Schlussframe gelten dieselben Dateigrenzen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Nein | Optional: Ohne Prompt animiert das Modell das Startbild von sich aus. mindestens 1 Zeichen |
image_url | Ja | Das Startbild – es wird exakt als erster Frame verwendet und ist die eigentliche Qualitätsgrenze der Einstellung. |
last_image_url | Nein | Optional und nur zusammen mit |
aspect_ratio | Nein | 16:9, 9:16, 1:1, 4:3, 3:4 oder adaptive, womit das Modell wählt. Weglassen, um die Form des Startbilds zu erben; ein widersprechender Wert beschneidet. |
enable_thinking | Nein | Lässt das Modell den Auftrag und das Referenzmaterial vor der Generierung durchdenken. Standardwert: |
resolution | Nein | 480p, 720p oder 1080p. Vorgabe 720p. |
duration_seconds | Nein | Jede ganze Zahl von 2 bis 30 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 wird die tats… |
generate_audio | Nein | Standardmäßig an. Der Clip kommt mit bereits am Bild verankertem Ton zurück. Standardwert: |
enable_prompt_expansion | Nein | Standardmäßig aus. Eingeschaltet wird der Prompt vor der Generierung umgeschrieben, was dünnen Briefings hilft und bei ausführlichen gegen Sie arbeitet. Standardwert: |
seed | Nein | 0 bis 2147483647. Festhalten, um ein geändertes Feld nach dem anderen zu vergleichen; weglassen für Vielfalt. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.0612 / Sekunde |
| $0.126 / Sekunde |
| $0.252 / Sekunde |
Anwendungsfälle
Schnelle Action aus einem Standbild
Das Strand-Beispiel beginnt mit einer Reiterin und verlangt, dass der Kanter in einen Galopp übergeht, Sand und flaches Wasser hinter den Hufen aufspritzen und eine schnelle Parallelfahrt sie begleitet, während sie in eine tiefe Sonne reitet. Bei diesem Tempo hilft der Startframe nicht mehr; der Prompt trägt die Physik: was aufgeworfen wird, in welche Richtung und wie die Kamera mithält.
Eine Geste mit fixiertem Ende
Das Maskenball-Beispiel fixiert beide Enden – ein gelieferter erster und letzter Frame derselben Frau auf derselben Marmortreppe – und beschreibt den Auftritt dazwischen: Sie nimmt die goldene Maske ab, rafft ihr Kleid und schreitet ein paar Stufen auf die Kamera zu, während die maskierten Gäste die Gläser heben. Weil das Schlussbild aus dem Startbild entstanden ist, bleiben Kleid, Kronleuchter und Gäste an ihrem Platz. Der Clip läuft 5 Sekunden in 720p mit Ton.
Prompt-Leitfaden und Praxistipps
Den Endframe zuerst als Standbild freigeben
Wenn das Ende zählt, erstellen Sie den letzten Frame vor dem Rendering, am selben Set und im selben Ausschnitt wie den ersten. Ihn als Standbild freizugeben ist weit günstiger als Iterationen über einen langen Mittelteil, und die Aufgabe des Prompts wird zur Beschreibung eines Übergangs statt zur Erfindung eines Ziels.
Ton als Liste von Quellen schreiben
Der Sauna-Prompt endet mit einer Zeile „Audio:“, die jede Quelle nennt. Das ist verlässlicher als ein Stimmungswort und bindet jedes Geräusch an die Handlung, die es auslöst. Setzen Sie generate_audio auf false – wie im Tanzflächen-Beispiel –, wenn der Clip im Schnitt vertont wird.
Kurz festlegen, dann verlängern
Lassen Sie die Bewegung bei 5 Sekunden mit festem seed laufen und verlängern Sie danach. Längere Clips driften stärker in Identität und Geometrie, und schnelle Überkreuzungen von Armen und Beinen bei 30 Sekunden sind die Stellen, an denen Artefakte zuerst auftreten. Lassen Sie enable_prompt_expansion auf dem Standardwert false, damit ein präzises Bewegungsbriefing vor der Generierung nicht umgeschrieben wird.
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-prime/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
