Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
aspect_ratio | Nie | Kształt kadru: szeroki, kwadratowy albo pionowy. 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive · Domyślnie: adaptive |
duration_seconds | Nie | Długość klipu. Płacisz za każdą sekundę. -1–30 · Domyślnie: 5 |
enable_prompt_expansion | Nie | Model dopisuje szczegóły do krótkiego promptu. Domyślnie: true |
generate_audio | Nie | Dodaje dźwięk pasujący do obrazu: głosy, tło i efekty. Domyślnie: true |
prompt | Nie | Describe the subject, motion and camera. |
reference_audio_urls | Nie | Dźwięk do dopasowania: głos, muzyka lub rytm. |
reference_file_url | Nie | One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action. |
reference_image_urls | Nie | Obrazy osób, ubrań lub miejsc, które wynik ma zachować. |
reference_link_url | Nie | One public web page the model reads for reference. It must open without a login. |
reference_video_urls | Nie | Klipy, których ruch, kamerę lub styl ma powtórzyć wynik. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 1080p · 2k · 4k · Domyślnie: 1080p |
seed | Nie | Ta sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647 |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.
| Opcja | Kredyty za sekundę | ≈ USD |
|---|---|---|
| resolution 1080p | 21,6 | 0,22 USD |
| resolution 2K | 24 | 0,24 USD |
| resolution 4K | 27,6 | 0,28 USD |
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Wan 3.0 Pro w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model alibaba/wan-3.0-pro/reference-to-video i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-3.0-pro/reference-to-video",
"input": {
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Wan 3.0 Pro
Ile kosztuje API Wan 3.0 Pro?
Wan 3.0 Pro kosztuje od 108 kredytów (1,08 USD) za klip 5-sekundowy – najtańsze zadanie to „Wideo z referencji”. Ceny według opcji: 1080p 21,6 kredytu za sekundę, 2K 24 kredyty za sekundę, 4K 27,6 kredytu za sekundę. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.
Jaka jest nazwa modelu Wan 3.0 Pro w API?
Wpisz alibaba/wan-3.0-pro/text-to-video do zadania Utwórz wideo; alibaba/wan-3.0-pro/image-to-video do zadania Obraz w wideo; alibaba/wan-3.0-pro/reference-to-video do zadania Wideo z referencji; alibaba/wan-3.0-pro/video-extend do zadania Wydłuż wideo w polu model żądania POST /jobs/createTask.
Czy 4K w Wan 3.0 Pro jest natywne?
Nie. Natywny render Wan 3.0 sięga najwyżej 1080p, więc plik 4K, który dostajesz, powstaje przez powiększenie tego renderu, a nie przez rysowanie w 4K. Dodatkowy detal pochodzi z powiększenia i dlatego czyste ujęcie powiększa się lepiej niż miękkie. Progi są tu trzy: 1080p, 2k i 4k, domyślnie 1080p. Nie ma 480p ani 720p – do tych rozmiarów użyj Wan 3.0.
Czym różnią się Wan 3.0 i Wan 3.0 Pro?
Rozmiary, o które możesz poprosić. Wan 3.0 renderuje natywnie w 480p, 720p lub 1080p. Wan 3.0 Pro rezygnuje z tych dwóch mniejszych progów i dostarcza 1080p, 2K lub 4K, przy czym wszystko powyżej 1080p jest powiększane z natywnego renderu. Oba przyjmują referencje obrazu, wideo i audio w reference-to-video, a długość klipu, od 2 do 30 sekund, jest taka sama.
Czy model generuje dźwięk?
Tak, w tym samym przebiegu i domyślnie, więc dostajesz jeden plik z dźwiękiem już zsynchronizowanym z obrazem. Ustaw generate_audio na false, gdy materiał dostanie osobną ścieżkę muzyczną.
Dlaczego mój prompt jest przepisywany?
W tej rodzinie enable_prompt_expansion jest domyślnie ustawione na true. Pomaga przy skąpych opisach i przeszkadza przy rozbudowanych. Ustaw je na false, gdy prompt jest już precyzyjnym opisem ujęcia.
Czy mogę podać pierwszą i ostatnią klatkę?
Tak, w image-to-video: image_url otwiera ujęcie, a last_image_url to opcjonalna klatka końcowa. Przypięcie obu końców to sposób, w jaki produkt wraca do swojego głównego ujęcia w ciągu pięciu sekund.
Jakie limity ma API Wan 3.0 Pro?
Długość klipu: 2–30 s; Rozdzielczości: 1080p · 2K · 4K; Proporcje obrazu: 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive; Audio referencyjne: 5; Obrazy referencyjne: 10. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Wan 3.0 Pro bez pisania kodu?
Tak. Playground uruchamia Wan 3.0 Pro na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Wan
Wan 3.0 renderuje natywnie w 480p, 720p lub 1080p znacznie taniej. Pro wybieraj tylko wtedy, gdy dostawa wymaga 2K lub 4K.
- API Wan 3.0Klipy do 30 sekund ze zsynchronizowanym dźwiękiemOd 34 kredytów za klip 5-sekundowy
- API Wan 3.0 PrimeSzybszy Wan 3.0, do 30 sekund z dźwiękiemOd 46 kredytów za klip 5-sekundowy
- API Wan 3.0 Pro PrimeSzybszy Wan 3.0 Pro z obrazem 2K i 4KOd 176 kredytów za klip 5-sekundowy
- API Wan 3.0 ProWan 3.0 w 1080p, 2K lub 4K, do 30 sekundOd 108 kredytów za klip 5-sekundowy
- API Wan 2.7 ProDuże płótna w 4K i kompozycje z dziewięciu obrazówOd 12 kredytów za obraz
- API Wan 2.7Najpierw przemyśla kompozycję, potem rysuje do czterech obrazówOd 5 kredytów za obraz
- API Wan 2.6 FlashSzybkie klipy z wielu ujęć z jednego obrazuOd 17 kredytów za klip 5-sekundowy
- API Wan 2.6Sekwencje z wielu ujęć z dźwiękiem, do 1080pOd 49 kredytów za klip 5-sekundowy
- API Wan 2.5Klipy 1080p z dźwiękiem, które mogą podążać za twoim audioOd 34 kredytów za klip 5-sekundowy
- API Wan 2.2 AnimatePorusza zdjęciem postaci według wideo referencyjnegoOd 7,95 kredytu za sekundę
- API Wan 2.2 LoRAWideo Wan 2.2 z twoimi LoRA na dowolnym z przebiegów eksperckichOd 18 kredytów za klip 5-sekundowy
- API Wan 2.2Proste pięciosekundowe klipy w 480p lub 720pOd 36 kredytów za generację
- API Wan 2.2 5B LoRALekkie klipy Wan 2.2 w 720p, wczytują twoje LoRAOd 18 kredytów za generację
- API Wan 2.2 Image LoRAKadry Wan 2.2 z maksymalnie dziewięcioma LoRA w trzech slotachOd 5 kredytów za obraz
- API Wan 2.1 LoRAWideo i edycja Wan 2.1 z twoimi LoRA, łącznie z ruchem kameryOd 36 kredytów za generację
- API Wan 2.1 Image LoRAFotorealistyczne kadry i zmiana stylu w Wan 2.1 z twoimi LoRAOd 5 kredytów za obraz

