Wprowadzenie
Wan 2.2 tekst na wideo generuje klip wyłącznie na podstawie napisanego promptu. Każde żądanie zwraca jedno nieme, pięciosekundowe wideo w formacie 16:9 lub 9:16, renderowane w 480p lub 720p. Prompt może mieć do 5000 znaków i jest jedynym wymaganym polem: domyślne proporcje to 16:9, domyślna rozdzielczość to 480p, a rozszerzanie promptu pozostaje wyłączone, dopóki go nie włączysz.
Wybierz tryb Wan 2.2 według materiału wyjściowego
| Co masz na starcie | Tryb | Czego wymaga żądanie |
|---|---|---|
| napisaną scenę lub scenariusz | Wan 2.2 tekst na wideo | promptu; 16:9 lub 9:16 |
| kadr, który chcesz zachować | Wan 2.2 obraz na wideo | obrazu i promptu; format wynika z obrazu |
Najważniejsze funkcje
Stałe ujęcie o długości pięciu sekund
Tryb tekst na wideo nie ma ustawienia długości: każde ujęcie trwa dokładnie pięć sekund, więc długość wyniku znasz jeszcze przed wysłaniem żądania. W pięciu sekundach mieści się jeden moment (obiekt, jedna czynność i jeden ruch kamery), a nie ciąg zdarzeń. Najpewniejsze wyniki dają prompty pisane właśnie w tej skali.
Dwa formaty i dwie rozdzielczości
Domyślne proporcje to 16:9, a do publikacji pionowej 9:16. Kadrów kwadratowych ani 4:3 nie ma, więc wersję kwadratową generuj w 16:9 i przytnij w montażu. Rozdzielczość to 480p lub 720p i jest to jedyne ustawienie, które zmienia cenę, dlatego 480p jest naturalnym poziomem dla szkiców.
Wyłącznie obraz
Klipy są zwracane bez ścieżki dźwiękowej i nie ma żadnego ustawienia dźwięku. Wszystko, co widz ma poczuć, musi być widoczne: opublikowany przykład z zaśnieżonym peronem buduje rytm z padającego śniegu, pary oddechu na mrozie i migoczącej lampy na peronie, zamiast polegać na dźwięku otoczenia.
Opcjonalne rozszerzanie promptu i seed
Rozszerzanie promptu przepisuje krótkie polecenie na pełniejszą wersję przed generowaniem. Seed przyjmuje wartości od 0 do 2147483647 i utrwala źródło losowości, dzięki czemu porównujesz jedną zmianę naraz; nie gwarantuje jednak identycznego klipu klatka po klatce przy ponownym uruchomieniu.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Samo ujęcie, do 5000 znaków: kto, jedna akcja, jeden ruch kamery, potem światło. Jeden wyraźny czasownik zmienia wynik bardziej niż stos przymiotników. od 1 znaków · do 5000 znaków |
aspect_ratio | Nie | 16:9 albo 9:16, domyślnie 16:9. Ten endpoint nie ma opcji kwadratowej ani 4:3. |
resolution | Nie | 480p albo 720p, domyślnie 480p. To jedyne ustawienie, które zmienia cenę. |
enable_prompt_expansion | Nie | Domyślnie wyłączone. Po włączeniu krótki brief jest przed generowaniem przepisywany na pełniejszy; zostaw je wyłączone, gdy twój prompt jest już precyzyjnym opisem ujęcia. Domyślnie: |
seed | Nie | Od 0 do 2147483647. Trzymaj go bez zmian, kiedy porównujesz po jednej poprawce; pomiń go, jeśli zależy ci na różnorodności. |
Cennik
Każde żądanie zwraca jeden pięciosekundowy klip.
| Specyfikacja | Cena |
|---|---|
| $0.24 / żądanie |
| $0.48 / żądanie |
Zastosowania
Szkice storyboardu hurtem
Zapisz każdy moment storyboardu jako osobny prompt i wyrenderuj całą listę w 480p. Pięć sekund wystarcza, by ocenić kadrowanie i ruch, a ponieważ każde żądanie ma tę samą długość, a cena zależy tylko od rozdzielczości, koszt całej partii znasz przed jej wysłaniem. Ujęcia, które zostawiasz, wyrenderuj ponownie w 720p z tym samym promptem i seedem.
Pionowe klipy do mediów społecznościowych
Ustaw proporcje 9:16 i opisz jedną ciągłą czynność. Opublikowany przykład z nocnym targiem robi dokładnie to w 720p: młoda kobieta w żółtym płaszczu przeciwdeszczowym bierze szaszłyk ze stoiska z grillem, dym i para unoszą się między girlandami żarówek, a potem ona odwraca się i idzie w stronę kamery, która powoli najeżdża z ręki.
Sprawdzenie, czy pomysł na ujęcie działa w ruchu
Zanim przejdziesz do ujęcia w 720p, możesz tanio przetestować pomysł. Przykład ze schodami latarni morskiej jest zapisany jako jedna czynność i jedna pozycja kamery (starszy mężczyzna z latarnią pokonuje ostatni zakręt krętych schodów, a nisko ustawiona kamera podąża za nim) i wyrenderowany w 16:9 przy 480p.
Wskazówki
Pisz jeden moment w stałej kolejności
Wymień obiekt, jedyną czynność, jeden ruch kamery, a na końcu światło. Wyraźny czasownik zmienia wynik bardziej niż stos przymiotników: mężczyzna, który wchodzi na ostatni zakręt schodów i zatrzymuje się przy oknie, daje klipowi początek i koniec w ciągu pięciu sekund.
Wykorzystaj znaki na szczegóły, a nie na kolejne sceny
Limit 5000 znaków zostawia miejsce na kostium, scenografię, pogodę i światło, ale pięć sekund nie udźwignie drugiego zdarzenia. Jeśli polecenie zawiera kilka zdarzeń, rozdziel je na osobne żądania i połącz klipy w montażu.
Trzymaj stały seed podczas poprawek
Wybierz seed i zachowaj go, zmieniając tylko jedną rzecz, na przykład czasownik, ruch kamery albo proporcje. Przykład z nocnym targiem ma ustalony seed 250728, aby to samo kadrowanie dało się porównać między wersjami promptu. Gdy zależy Ci na różnorodności, pomiń seed.
Zdecyduj wcześnie o rozszerzaniu promptu
Jeśli masz tylko pomysł w jednym zdaniu, włączenie rozszerzania promptu sprawi, że usługa napisze za Ciebie pełniejsze polecenie. Gdy Twój prompt już określa obiekt, czynność, kamerę i światło, zostaw tę opcję wyłączoną, aby tekst został wykonany dokładnie tak, jak go napisano, i oceniaj wersję rozszerzoną zawsze w porównaniu z wersją bez rozszerzenia.
Rozpoznaj, kiedy sam tekst nie wystarczy
Sam prompt nie utrzyma konkretnej twarzy ani produktu w niezmienionej postaci między kolejnymi uruchomieniami. Gdy obiekt musi zgadzać się z zatwierdzonym kadrem, przejdź na Wan 2.2 obraz na wideo i powierz wygląd obrazowi.
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-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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.




























