Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
bgm | Nie | Add a background music bed that fits the scene. Domyślnie: true |
duration_seconds | Nie | Długość klipu. Płacisz za każdą sekundę. ≥ 1 · ≤ 16 · Domyślnie: 5 |
generate_audio | Nie | Dodaje dźwięk pasujący do obrazu: głosy, tło i efekty. Domyślnie: true |
image_url | Tak | Obraz, od którego zaczynasz. |
movement_amplitude | Nie | Jak mocno ruszają się obiekt i kamera. auto · small · medium · large · Domyślnie: auto |
prompt | Tak | Describe what happens after the opening frame: the action, the camera, and the mood. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 540p · Domyślnie: 540p |
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 |
|---|---|---|
| Standard | 8,1 | 0,081 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 41 kredytów za klip 5-sekundowy (0,41 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 Q3 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 vidu/q3-pro/image-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/q3-pro/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"movement_amplitude": "auto",
"duration_seconds": 5,
"resolution": "540p"
}
}'
# 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 Q3 Pro
Ile kosztuje API Vidu Q3 Pro?
Vidu Q3 Pro kosztuje 41 kredytów (0,41 USD) za klip 5-sekundowy. 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 Q3 Pro w API?
Wpisz vidu/q3-pro/image-to-video do zadania Obraz w wideo w polu model żądania POST /jobs/createTask.
Co robi Vidu Q3 Pro?
Ożywia dostarczoną przez ciebie klatkę początkową. Obraz decyduje o podmiocie, wyglądzie i kształcie; prompt opisuje ruch, pracę kamery i dźwięk. Klipy trwają od 1 do 16 pełnych sekund w 540p.
Jak steruję kształtem klipu?
Przez kadr. Pionowy obraz wraca jako pionowy klip, a kwadratowy jako kwadratowy, więc kształt materiału do dostarczenia rozstrzyga się na etapie obrazu.
Czym Vidu Q3 Pro różni się od Vidu Q3 Turbo?
W image-to-video przyjmują te same pola. Różnica leży w oferowanej rozdzielczości: Pro pracuje w 540p, a Turbo ma 540p i 720p.
Jakie limity ma API Vidu Q3 Pro?
Długość klipu: 1–16 s; Rozdzielczości: 540p. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Vidu Q3 Pro bez pisania kodu?
Tak. Playground uruchamia Vidu Q3 Pro na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Vidu
- 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

