Einführung
Wan 3.0 Pro Prime Text-zu-Video erzeugt aus einem Prompt eine Einstellung von 2 bis 30 Sekunden und liefert sie in 1080p, 2K oder 4K mit Ton in derselben Datei. Die Feldliste entspricht exakt der von Wan 3.0 Pro Text-zu-Video, das Basis-Rendering ist jedoch Wan 3.0 Prime, das Alibaba als Hochgeschwindigkeitsversion mit denselben Fähigkeiten positioniert. Ein natives Prime-Rendering endet bei 1080p, die Stufen 2k und 4k werden daraus vergrößert statt nativ gerendert.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Aus einem schriftlichen Briefing entstehen Szene, Handlung, Kamerabewegung und gegebenenfalls Ton. | Wan 3.0 Pro Prime Text-zu-Video |
| Ein freigegebenes Startbild bestimmt Motiv und Komposition; die Beschreibung steuert die anschließende Bewegung. | Wan 3.0 Pro Prime Bild-zu-Video |
| Getrennte Referenzen können Identität, Ort, Bewegung oder Klang mit jeweils einer klaren Rolle leiten. | Wan 3.0 Pro Prime Referenz-zu-Video |
Wichtige Funktionen und Highlights
Derselbe Body wie bei Wan 3.0 Pro
prompt (bis zu 20.000 Zeichen) ist das einzige Pflichtfeld; resolution steht standardmäßig auf 1080p, aspect_ratio auf adaptive und enable_prompt_expansion auf true. Da der Vertrag identisch ist, läuft ein JSON-Body auf Pro und Pro Prime, wenn nur der Modellname geändert wird – senden Sie also eine Testeinstellung mit demselben Seed an beide, bevor Sie ein Projekt festlegen.
Den Bildausschnitt ins Briefing schreiben
Das Krypta-Beispiel verwendet ein Drittel seines Prompts allein auf den Ausschnitt: der ganze Kopf im Bild, klarer Raum über dem Haar, Bildkante an der Taille, das Gesicht jederzeit sichtbar. Bei einer Nahaufnahme ist der typische Fehler, dass das Modell das Gesicht aus dem eigenen Bild schneidet, und den Ausschnitt zu benennen ist die Abhilfe. Kerzenlicht ist das einzige Führungslicht, und der Ton – flackernde Flammen, eine ferne Eisentür – kommt im selben Durchgang.
Bewegung ohne Ruhepunkt
Das Unterwasser-Beispiel hat keinen Boden als Bezug: ein purpurrotes Seidenkleid, das sich beim Sinken entfaltet, fächerförmig treibendes Haar, Luftblasen von den Fingerspitzen und eine Kamera, die gleichzeitig einen Bogen fährt und neigt. Es setzt keine Auflösung und läuft daher mit dem Standard 1080p. Einstellungen, in denen nichts zur Ruhe kommt, profitieren am meisten von einer größeren Lieferstufe.
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.234 / Sekunde |
| $0.252 / Sekunde |
| $0.279 / Sekunde |
Anwendungsfälle
Bewegtes farbiges Licht im Hochformat
Das Polarlicht-Beispiel verlangt grünes Licht, das über Haut und Haar zweier Menschen läuft, die auf einem zugefrorenen See eine Decke teilen, im Format 9:16. Bewegtes farbiges Licht auf Haut ist die Stelle, an der Banding und Farbrauschen zuerst auftreten; beauftragen Sie für ein solches Motiv 2K oder 4K nur, wenn die Szene es wirklich braucht – ein statisches Motiv in 4K bringt nur eine größere Datei.
Szenen aus der Hand bei vorhandenem Licht
Das Nachtfähren-Beispiel ist bewusst schlicht: dokumentarischer Handkamera-Ausschnitt, ein Deckscheinwerfer und ferne Hafenlichter, zwei erwachsene Männer an der Heckreling, die die Stirn aneinanderlegen und sich küssen, während unten das Kielwasser schäumt. Ein Inhalts-Flag gibt es nicht, jede Szene wird wie jeder andere Prompt gesendet; Einwilligung, Rechte, Alter und lokales Recht bleiben Ihre Verantwortung.
Prompt-Leitfaden und Praxistipps
Klein erkunden, groß liefern
Stimmen Sie den Prompt in 1080p und bei 5 Sekunden mit festem seed ab. Sobald der Take funktioniert, senden Sie denselben Body mit resolution auf 4k erneut. Wer Auflösung und Seed zugleich ändert, ändert zwei Dinge auf einmal und verdeckt, was das Ergebnis bewegt hat.
In einer vergrößerten Datei zuerst hartes Licht prüfen
Eine einzelne harte Lichtquelle bei Nacht – eine hängende Glühbirne, ein Deckscheinwerfer – zeigt die Grenzen vergrößerten Materials zuerst: Banding im Abfall, wächserne Haut, nasser Stoff, der zu grauem Schlieren wird. Prüfen Sie diese Stellen in der gelieferten 2K- oder 4K-Datei, bevor Sie graden oder eine Sequenz daraus schneiden.
Die Formulierung vor dem finalen Rendering festschreiben
Die Prompt-Erweiterung ist in dieser Familie standardmäßig aktiv und schreibt detaillierte Briefings um. Schalten Sie enable_prompt_expansion ab, sobald sich der Prompt wie eine präzise Einstellungsbeschreibung liest, damit die abgestimmte Fassung auch ausgeführt wird. Schreiben Sie Motiv, eine Handlung, eine Kamerabewegung, dann Licht und Ton.
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-prime/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.
