Wprowadzenie
Wan 3.0 Tekst na wideo tworzy klip o długości od 2 do 30 sekund z dźwiękiem wyłącznie na podstawie napisanego promptu. Jedynym wymaganym polem jest prompt; duration_seconds, resolution (480p, 720p lub 1080p, domyślnie 720p), aspect_ratio (domyślnie 16:9), generate_audio, enable_prompt_expansion i seed to jawne ustawienia, które możesz zostawić na wartościach domyślnych. Ponieważ żaden obraz nie zakotwicza ujęcia, model wymyśla każdą twarz, każde ubranie i każdą scenografię na podstawie tekstu. To tryb Wan 3.0 o największej swobodzie twórczej i najmniejszej kontroli nad konkretną osobą.
Wybierz tryb według materiału początkowego
| Materiał początkowy | Tryb |
|---|---|
| Pisany brief określa scenę, działanie, kamerę i w razie potrzeby dźwięk. | Wan 3.0 Tekst na wideo |
| Zatwierdzony obraz początkowy ustala postać i kompozycję, a instrukcja kieruje późniejszym ruchem. | Wan 3.0 Obraz na wideo |
| Oddzielne materiały referencyjne mogą prowadzić tożsamość, miejsce, ruch lub dźwięk, gdy każdy ma jasną rolę. | Wan 3.0 Referencje na wideo |
Najważniejsze funkcje
Dźwięk opisany w tym samym żądaniu
generate_audio jest domyślnie włączone, więc zwrócony plik ma już dźwięk zsynchronizowany z obrazem. Przykład ze zbrojownią wykorzystuje to celowo: prompt kończy się linią „Audio:” – skórzana rękawica uderzająca o drewno, skrzypiące sznurowanie, trzaskająca pochodnia – i te dźwięki wracają razem z czynnościami, które je wywołują. Ustaw pole na false tylko wtedy, gdy ujęcie dostanie osobną ścieżkę muzyczną.
Dowolna pełna długość od 2 do 30 sekund
duration_seconds przyjmuje każdą liczbę całkowitą od 2 do 30, domyślnie 5, albo -1 dla inteligentnej długości, gdy model sam wybiera długość na podstawie promptu. Przykład z wydmą trwa domyślne 5 sekund w 720p i 16:9 – wystarczy na jeden lot z powietrza od ściany burzy aż do jej twarzy. Dłuższe klipy bardziej dryfują w wyglądzie postaci i geometrii, dlatego najpierw ustal wygląd przy 5 sekundach.
Sceny bez cenzury z samego tekstu
Rodzina działa bez cenzury i żadna scena nie wymaga flagi ani deklaracji w każdym żądaniu. Przykład z kinem samochodowym – dwie dorosłe kobiety na otwartej klapie kombi, oświetlone tylko wiązką projektora, aż do powolnego pocałunku – powstał z samego tekstu promptu przy 5 sekundach i 720p. Za zgodę, prawa, wiek i lokalne prawo wszystkich przedstawionych osób odpowiadasz ty.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Samo ujęcie: podmiot, jedna akcja, jeden ruch kamery, a potem światło i dźwięk. Długie listy przymiotników zmieniają wynik mniej niż jedna wyraźna akcja. od 1 znaków |
aspect_ratio | Nie | 16:9, 9:16, 1:1, 4:3, 3:4 albo adaptive, przy którym wybiera model. Domyślnie 16:9. |
enable_thinking | Nie | Każe modelowi przemyśleć polecenie i materiały referencyjne przed generowaniem. Domyślnie: |
resolution | Nie | 480p, 720p lub 1080p. Domyślnie 720p. |
duration_seconds | Nie | Dowolna liczba całkowita od 2 do 30 albo -1 dla inteligentnej długości, przy której długość wybiera model: z góry rezerwowane jest maksimum 30 sekund, a rozliczenie ustala się n… |
generate_audio | Nie | Domyślnie włączone. Klip wraca z dźwiękiem już zsynchronizowanym z obrazem. Domyślnie: |
enable_prompt_expansion | Nie | Domyślnie wyłączone. Po włączeniu prompt jest przepisywany przed generowaniem: pomaga przy ubogich briefach, a przy szczegółowych działa przeciwko tobie. Domyślnie: |
seed | Nie | Od 0 do 2147483647. Trzymaj go na stałe, aby porównywać po jednym zmienionym polu; pomiń go, gdy chcesz różnorodności. |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.045 / sekundę |
| $0.09 / sekundę |
| $0.18 / sekundę |
Zastosowania
Klimatyczne sceny bez obrazu źródłowego
Gdy nie ma zdjęcia miejsca, prompt musi je zbudować. Przykład z wydmą opisuje grzbiet wydmy o zachodzie słońca, nadciągającą ogromną burzę piaskową, szmaragdową jedwabną suknię powiewającą na wietrze i kamerę, która z widoku z lotu ptaka zjeżdża aż do jej twarzy – wszystko z samego zdania. Takie żądania sprawdzają się w filmach nastrojowych i materiałach do pitchu, gdzie otoczenie liczy się bardziej niż konkretna twarz.
Perspektywa pierwszoosobowa
Przykład z perspektywy pierwszej osoby napisano jako jedno ciągłe ujęcie: kamera to oczy widza, jedynym światłem jest żarówka wolframowa, a brief mówi wprost, że strój do końca pozostaje dokładnie taki, jak opisano. Określenie, co się nie zmienia, jest równie przydatne jak opis tego, co się rusza – dzięki temu model nie rozstrzyga niejednoznacznego promptu po swojemu.
Wskazówki
Kolejność w prompcie: postać, akcja, kamera, światło, dźwięk
Napisz jedną postać, jedną akcję, jeden ruch kamery, a potem po jednej uwadze o świetle i dźwięku. Długa lista przymiotników zmienia wynik mniej niż jedna wyraźna akcja. Klip referencyjny rodziny trzyma się dokładnie tej kolejności: dwie kobiety pod jednym parasolem, kosmyk włosów założony za ucho i pocałunek, powolny najazd kamery, neon rozlewający się po mokrej ziemi, deszcz na parasolu.
Określ kadr, gdy scenę niesie detal
Prompt ze zbrojownią nazywa kadr – średnie zbliżenie od bioder, niski kąt trzy czwarte, 85 mm – bo w planie ogólnym zniknęłyby rękawica, sznurowanie i światło pochodni na ramionach. Gdy detal ma znaczenie, napisz, jak duży ma być w kadrze, zamiast liczyć, że model sam wybierze zbliżenie.
Przy precyzyjnym briefie nie włączaj rozszerzania promptu
Tutaj enable_prompt_expansion ma domyślnie wartość false. Po włączeniu prompt jest przepisywany przed generowaniem, co pomaga pomysłowi w dwóch linijkach i przeszkadza szczegółowemu briefowi jak te powyżej. Przy kontrolowanych powtórkach zablokuj seed i zmieniaj jedno pole naraz; stały seed zapewnia uczciwe porównanie, ale nie gwarantuje identycznych klatek. Sam tekst nie utrzyma tej samej twarzy między uruchomieniami, więc dla powracających postaci używaj reference-to-video.
Szybki start z API
# 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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.



























