O modelu Vidu Q3 Turbo
Vidu Q3 Turbo to szybki poziom linii Q3 od Vidu i publikuje dwa endpointy: image-to-video i video-extend. Klatka początkowa, którą dostarczasz, ustala postać i kształt wyjścia, prompt prowadzi ruch, a klipy trwają od 1 do 16 sekund w 540p albo 720p, z dźwiękiem generowanym w tym samym przebiegu.
Wywołujesz go nazwą modelu vidu/q3-turbo/image-to-video w POST /jobs/createTask, od 32 kredyty za klip 5-sekundowy (0,32 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.
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 · 720p · 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,3 | 0,063 USD |
| resolution 720p | 9,9 | 0,099 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 32 kredyty za klip 5-sekundowy (0,32 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 Turbo 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-turbo/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-turbo/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": "720p"
}
}'
# 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 Turbo
Ile kosztuje API Vidu Q3 Turbo?
Vidu Q3 Turbo kosztuje od 32 kredyty (0,32 USD) za klip 5-sekundowy – najtańsze zadanie to „Obraz w wideo”. Ceny według opcji: 540p 6,3 kredytu za sekundę, 720p 9,9 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 Q3 Turbo w API?
Wpisz vidu/q3-turbo/image-to-video do zadania Obraz w wideo; vidu/q3-turbo/video-extend do zadania Wydłuż wideo w polu model żądania POST /jobs/createTask.
Jak sterować tym, ile się rusza?
Promptem i polem movement_amplitude. Napisz ruch wprost – przeniesienie ciężaru, pół obrotu, wyjście z kadru – dopasuj go do tego, co pokazuje klatka początkowa, a ogólną ilość ruchu ustaw w movement_amplitude (auto, small, medium, large). Zmienia się to, jak daleko bohater przemieszcza się w kadrze, a nie długość klipu.
Jak długi może być klip?
Od jednej do szesnastu pełnych sekund. Od jednej do czterech sekund to najlepszy zakres przy generowaniu wariantów; pełne szesnaście jest do dyspozycji, gdy jeden moment potrzebuje miejsca.
Jakie rozdzielczości są obsługiwane?
540p i 720p, domyślnie 720p. 540p to przebieg szkicowy, a 720p przebieg oddawany, i przejście między nimi to jedna wartość w tym samym żądaniu.
Czy generuje dźwięk?
Tak. generate_audio domyślnie ma wartość true, więc klip przychodzi ze zsynchronizowaną ścieżką. Ustaw false, gdy montaż idzie pod istniejący miks.
Jakie limity ma API Vidu Q3 Turbo?
Długość klipu: 1–16 s; Rozdzielczości: 540p · 720p. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Vidu Q3 Turbo bez pisania kodu?
Tak. Playground uruchamia Vidu Q3 Turbo 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