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 · 9:16 · 1:1 · 3:4 · 4:3 · Domyślnie: 16:9 |
duration_seconds | Nie | Długość klipu. Płacisz za każdą sekundę. ≥ 3 · ≤ 16 · Domyślnie: 5 |
generate_audio | Nie | Dodaje dźwięk pasujący do obrazu: głosy, tło i efekty. Domyślnie: true |
prompt | Tak | Describe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image". |
reference_audio_urls | Nie | Dźwięk do dopasowania: głos, muzyka lub rytm. |
reference_image_urls | Tak | Obrazy osób, ubrań lub miejsc, które wynik ma zachować. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 540p · 720p · 1080p · 2k · 4k · Domyślnie: 720p |
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 540p | 6,75 | 0,068 USD |
| resolution 720p | 14,25 | 0,14 USD |
| resolution 1080p | 18 | 0,18 USD |
| resolution 2K | 28,5 | 0,29 USD |
| resolution 4K | 58,5 | 0,59 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 34 kredyty za klip 5-sekundowy (0,34 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Vidu Q4 Preview 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 vidu/q4-preview/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": "vidu/q4-preview/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"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 Vidu Q4 Preview
Ile kosztuje API Vidu Q4 Preview?
Vidu Q4 Preview kosztuje od 34 kredyty (0,34 USD) za klip 5-sekundowy – najtańsze zadanie to „Wideo z referencji”. Ceny według opcji: 540p 6,75 kredytu za sekundę, 720p 14,25 kredytu za sekundę, 1080p 18 kredytów za sekundę, 2K 28,5 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 Vidu Q4 Preview w API?
Wpisz vidu/q4-preview/image-to-video do zadania Obraz w wideo; vidu/q4-preview/reference-to-video do zadania Wideo z referencji; vidu/q4-preview/video-extend do zadania Wydłuż wideo w polu model żądania POST /jobs/createTask.
Czym jest Vidu Q4 Preview?
To publiczny podgląd modelu wideo Q4 od Vidu, wydany 7 października 2026 przed pełnym modelem Q4. Oferuje obraz na wideo, referencje na wideo i video-extend. Trybu tekst na wideo nie ma.
Jak długie są klipy i w jakiej rozdzielczości?
Od 3 do 16 pełnych sekund przy 24 klatkach na sekundę, w 540p, 720p (domyślnie), 1080p, 2k lub 4k. Obraz na wideo zachowuje kształt twojego kadru; referencje na wideo przyjmują 16:9, 9:16, 1:1, 3:4 lub 4:3.
Czy generuje dźwięk i czy potrafi mówić kwestie?
Tak. Dialogi, efekty i ambient powstają razem z obrazem, a przełącznik je wyłącza. Kwestie wpisuj w prompcie w podwójnych cudzysłowach; w naszych przebiegach cytowana kwestia została wypowiedziana. Przy referencyjnym nagraniu głosu też wpisz kwestię w prompcie.
Ile referencji mogę użyć?
Referencje na wideo przyjmują od 1 do 15 obrazów referencyjnych (osoby, stroje, produkty lub miejsca) i do 3 nagrań audio; Vidu prosi o MP3 po 3–12 sekund każde. W naszych przebiegach trzy referencje złożyły się w jedną scenę, a dwa portrety zachowały obie twarze.
Dlaczego plik 4k nie odtwarza się w przeglądarce?
Klipy 2k i 4k to 10-bitowe pliki HEVC (H.265), których część przeglądarek nie odtwarza w osadzonym odtwarzaczu. Otwórz je w odtwarzaczu lub programie do montażu na komputerze albo transkoduj. 540p, 720p i 1080p to H.264 i działają prawie wszędzie.
Jakie limity ma API Vidu Q4 Preview?
Długość klipu: 3–16 s; Rozdzielczości: 540p · 720p · 1080p · 2K · 4K; Proporcje obrazu: 16:9 · 9:16 · 1:1 · 3:4 · 4:3; Audio referencyjne: 3; Obrazy referencyjne: 15. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Vidu Q4 Preview bez pisania kodu?
Tak. Playground uruchamia Vidu Q4 Preview na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Vidu
Vidu Q3 to sprawdzony model do ożywiania obrazów, z sufitem 1080p. Q4 Preview dodaje sceny z referencji, wydłużanie klipów i wyjście do 4K, a cena za sekundę zaczyna się niżej.
- API Vidu Q4 PreviewKlipy do 4K z dźwiękiem i mówionymi dialogamiOd 34 kredytów za klip 5-sekundowy
- API Vidu Q3 TurboSzybka animacja obrazu z dźwiękiem, do 16 sekundOd 32 kredytów za klip 5-sekundowy
- API Vidu Q3Animuje kadr nawet do 16 sekund w 1080pOd 53 kredytów za klip 5-sekundowy
- API Vidu Q3 ProAnimuje kadr z dźwiękiem domyślnie włączonym, do 16 sekundOd 41 kredytów za klip 5-sekundowy

