Wprowadzenie
Vidu Q4 Preview Reference to video buduje jedną scenę z 1–15 obrazów referencyjnych i do 3 klipów głosowych. Vidu Q4 Preview to publiczna wersja podglądowa modelu wideo Q4 od Vidu. Klipy trwają 3–16 sekund, od 540p do 4k, w pięciu proporcjach, z dźwiękiem generowanym razem z obrazem. Ten punkt końcowy ma lekki filtr: od poziomu Umiarkowany większość żądań jest łagodzona lub odrzucana.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| zdjęcie do animacji | Vidu Q4 Preview Obraz na wideo |
| osoby, stroje, produkty lub miejsca jako obrazy, z opcjonalnymi nagraniami głosu | Vidu Q4 Preview Referencje na wideo |
Najważniejsze funkcje
Do 15 referencji
Osoby, stroje, produkty i miejsca mogą trafić do modelu razem. W naszych przebiegach twarz, ubiór i wnętrze wróciły jako jedna scena.
Dwie osoby, obie rozpoznawalne
Dwa portrety jako referencje zachowały obie twarze w jednym kadrze.
Głos referencyjny
Do 3 nagrań audio wyznacza głos. Słowa nadal pochodzą z promptu, więc wpisz kwestię w cudzysłowie.
Pięć kształtów i pięć poziomów
aspect_ratio oferuje 16:9, 9:16, 1:1, 3:4 i 4:3; resolution sięga od 540p do 4k, przy czym 2k i 4k to 10-bitowy HEVC.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagany, do 20 000 znaków. Opisz scenę i odwołuj się do referencji po pozycji, np. od 1 znaków · do 20000 znaków |
reference_image_urls | Tak | Wymagane, od 1 do 15 obrazów osób, strojów, produktów lub miejsc. Żądanie bez żadnego zostaje odrzucone. od 1 elementów · do 15 elementów |
reference_audio_urls | Nie | Opcjonalne, do 3 nagrań głosu (Vidu prosi o MP3 po 3–12 sekund każde). od 1 elementów · do 3 elementów |
aspect_ratio | Nie | 16:9 (domyślnie), 9:16, 1:1, 3:4 lub 4:3. Nie zmienia ceny. |
resolution | Nie | 540p, 720p (domyślnie), 1080p, 2k lub 4k. To ona wyznacza cenę za sekundę: 2k kosztuje więcej niż 1080p, a 4k mniej więcej dwa razy tyle co 2k. |
duration_seconds | Nie | Pełne sekundy, od 3 do 16, domyślnie 5. Rozliczane za sekundę razem z rozdzielczością. |
generate_audio | Nie | Domyślnie włączone: dialogi, efekty i ambient powstają razem z obrazem. Wyłącz, jeśli klip ma nie mieć ścieżki dźwiękowej. Domyślnie: |
seed | Nie | Pozwala porównywać przebiegi, gdy zmieniasz jedną rzecz naraz. Nie gwarantuje klipu identycznego co do klatki. |
Cennik
Rozliczane za sekundę wyniku przy wybranej rozdzielczości. Dźwięk, liczba obrazów referencyjnych i liczba referencyjnych nagrań audio nie zmieniają ceny. Odrzucone żądania nie są obciążane opłatą.
| Specyfikacja | Cena |
|---|---|
| $0.045 / sekundę |
| $0.095 / sekundę |
| $0.12 / sekundę |
| $0.19 / sekundę |
| $0.39 / sekundę |
Zastosowania
Sceny modowe i produktowe
Model, ubiór i lokacja w jednym klipie.
Ujęcia z dwiema osobami
Rozmowa, powitanie albo prawie pocałunek z zachowaniem obu twarzy.
Postacie z głosem
Portret, nagranie głosu i cytowana kwestia.
Wskazówki
Odwołuj się po pozycji
Napisz „kobieta z pierwszego obrazu” i „szlafrok z drugiego obrazu”.
Wpisz kwestię
Nagranie głosu nie dostarcza słów. Ujmij kwestię w cudzysłów i dopisz, że ma zabrzmieć głosem z nagrania referencyjnego.
Poznaj filtr
Żądania poziomu Łagodny przeszły, podobnie jak jeden z dwóch promptów poziomu Maksymalny; od poziomu Umiarkowany pozostałe w naszych testach były odrzucane lub łagodzone, a odmowy nie są obciążane. Do scen wykraczających poza te ograniczenia użyj obraz–wideo z kadru z osobami.
Szkicuj w 540p
Przetestuj prompt w 540p, potem skończ w 1080p. Po 2k lub 4k sięgaj tylko wtedy, gdy poradzisz sobie z plikami HEVC.
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": "vidu/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# 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.












