Wprowadzenie
Wan 3.0 Pro Prime Tekst na wideo tworzy na podstawie promptu ujęcie o długości od 2 do 30 sekund i dostarcza je w 1080p, 2K lub 4K z dźwiękiem w tym samym pliku. Lista pól jest dokładnie taka sama jak w Wan 3.0 Pro Tekst na wideo, ale bazowym renderem jest Wan 3.0 Prime, który Alibaba przedstawia jako szybką wersję o tych samych możliwościach. Natywny render Prime kończy się na 1080p, więc poziomy 2k i 4k powstają przez jego powiększenie, a nie przez natywny render.
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 Pro Prime Tekst na wideo |
| Zatwierdzony obraz początkowy ustala postać i kompozycję, a instrukcja kieruje późniejszym ruchem. | Wan 3.0 Pro Prime 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 Pro Prime Referencje na wideo |
Najważniejsze funkcje
To samo ciało żądania co w Wan 3.0 Pro
Jedynym wymaganym polem jest prompt (do 20 000 znaków); resolution ma domyślnie wartość 1080p, aspect_ratio – adaptive, a enable_prompt_expansion – true. Kontrakt jest identyczny, więc jedno ciało JSON działa w Pro i w Pro Prime po zmianie samej nazwy modelu; zanim przypiszesz projekt do jednego z nich, wyślij do obu ujęcie testowe z tym samym seedem.
Kadr zapisany w briefie
Przykład z kryptą poświęca jedną trzecią promptu samemu kadrowi: cała głowa w kadrze, wyraźny zapas nad włosami, krawędź kadru na wysokości talii, twarz widoczna przez cały czas. Typowy błąd zbliżenia to model wycinający twarz z własnego kadru, a nazwanie kadru jest na to lekarstwem. Jedynym światłem kluczowym są świece, a dźwięk – migoczące płomienie, odległe żelazne drzwi – przychodzi w tym samym przebiegu.
Ruch bez punktu oparcia
Przykład podwodny nie ma dna jako odniesienia: szkarłatna jedwabna suknia rozkwita, gdy postać opada, włosy rozchodzą się wachlarzem, z opuszków palców ciągną się pęcherzyki, a kamera jednocześnie zatacza łuk i się pochyla. Rozdzielczość nie jest ustawiona, więc obowiązuje domyślne 1080p. Najwięcej na większym poziomie dostawy zyskują ujęcia, w których nic się nie uspokaja.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Bohater, jedno działanie, jeden ruch kamery, a potem światło i dźwięk. W 4K ogólnikowy brief kosztuje realne pieniądze, więc opisuj ujęcie, a nie nastrój. od 1 znaków · do 20000 znaków |
resolution | Nie | 1080p, 2k lub 4k, domyślnie 1080p. |
aspect_ratio | Nie | 16:9, 4:3, 1:1, 3:4, 9:16 albo adaptive. Domyślnie adaptive, czyli wybór po stronie modelu; podaj konkretne proporcje, kiedy format dostawy jest ustalony. |
duration_seconds | Nie | Dowolna liczba całkowita od 2 do 30, domyślnie 5, albo -1 dla inteligentnej długości, przy której długość wybiera model: z góry rezerwowane jest maksimum 30 sekund, a rozliczeni… |
generate_audio | Nie | Domyślnie włączone. Dźwięk powstaje razem z obrazem i trafia do tego samego pliku. Domyślnie: |
enable_prompt_expansion | Nie | W tej rodzinie domyślnie włączone. Uzupełnia ubogie briefy i przepisuje szczegółowe, więc wyłącz je, gdy prompt jest już precyzyjnym opisem ujęcia. Domyślnie: |
seed | Nie | Od 0 do 2147483647. Trzymaj go na stałe, gdy dobierasz rozdzielczość albo czas trwania, inaczej każde powtórzenie zmienia dwie rzeczy naraz. |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.234 / sekundę |
| $0.252 / sekundę |
| $0.279 / sekundę |
Zastosowania
Ruchome kolorowe światło w pionowym kadrze
Przykład z zorzą prosi o zielone światło przesuwające się po skórze i włosach dwojga ludzi dzielących jeden koc na zamarzniętym jeziorze, w formacie 9:16. Ruchome kolorowe światło na skórze to miejsce, gdzie banding i szum barwny pojawiają się najpierw, więc zamawiaj 2K lub 4K dla takiego motywu tylko wtedy, gdy scena naprawdę tego potrzebuje; statyczny motyw w 4K daje jedynie większy plik.
Sceny z ręki w zastanym świetle
Przykład z nocnym promem jest celowo prosty: dokumentalny kadr z ręki, reflektor pokładowy i odległe światła portu, dwóch dorosłych mężczyzn przy rufowym relingu, którzy stykają się czołami i całują, gdy w dole kotłuje się kilwater. Nie ma żadnej flagi treści do ustawienia, bo każdą scenę wysyła się jak każdy inny prompt; za zgodę, prawa, wiek i lokalne prawo odpowiadasz ty.
Wskazówki
Szukaj w małym, dostarczaj w dużym
Dopracuj prompt w 1080p przy 5 sekundach ze stałym seed. Gdy ujęcie działa, wyślij dokładnie to samo ciało żądania z resolution ustawionym na 4k. Jednoczesna zmiana rozdzielczości i seeda zmienia dwie rzeczy naraz i ukrywa, co przesunęło wynik.
W powiększonym pliku najpierw sprawdź twarde światło
Pojedyncze twarde źródło w nocy – wisząca żarówka, reflektor pokładowy – to miejsce, gdzie powiększony materiał najpierw pokazuje swoje granice: banding w spadku światła, woskowa skóra, mokra tkanina zamieniająca się w szarą smugę. Sprawdź te miejsca w dostarczonym pliku 2K lub 4K przed korekcją barwną lub montażem sekwencji.
Zamknij treść przed finalnym renderem
W tej rodzinie rozszerzanie promptu jest domyślnie włączone i przepisuje szczegółowe briefy. Wyłącz enable_prompt_expansion, gdy prompt czyta się jak precyzyjny opis ujęcia, żeby wykonana została dopracowana wersja. Napisz postać, jedną akcję, jeden ruch kamery, a potem światło i dźwięk.
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-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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.



























