Vidu Video Q4 Preview · Dokumentacja API
Generuj film z jednego obrazu lub referencji, a następnie przeszukaj zadanie APIMaster.
Użyj POST /v1/wand/vidu/image-to-video dla pojedynczego obrazu startowego lub POST /v1/wand/vidu/reference-to-video dla generacji kierowanej referencjami. Sondaż z GET /v1/wand/vidu/tasks/{task_id}. Używaj JSON do składania i uwierzytelniania Bearer dla każdego żądania. Dla tego modelu nie ma możliwości uzyskania tylko generacji i oddzielnego punktu końcowego.
| Pole | Typ | Opis |
|---|---|---|
model |
string | Wymagane. Stosowanie vidu-video-q4-preview. |
images |
string[] | Image-to-video wymaga dokładnie jednego obrazu. Reference-to-video akceptuje do obrazów 15 lub subjects. Użyj publicznych URLs lub URI danych w PNG, JPEG / JPG lub WebP. Stosunek czasu do czasu musi być 1:4 do 4:1. Każdy obraz URL może być do 50 MB. Obrazy Base64 są ograniczone do 15 MB przed kodowaniem i 20 MB zakodowane w całości. |
subjects |
object[] | Dla reference-to-video jako alternatywy dla images. Ustaw każdy element name i jeden do trzech images. Zobacz temat z @name w wierszu. |
prompt |
string | Wymagane dla reference-to-video. Do znaków 2,000 dla bezpośrednich odniesień do obrazów lub 5,000 dla uczestników i image-to-video. Image-to-video ignoruje to pole, gdy jest włączone is_rec. |
auto_subjects |
boolean | Opcja biblioteki tematycznej dla reference-to-video. Wartość domyślna: false. |
audio |
boolean | Domyślnie true zamiast image-to-video oraz false zamiast reference-to-video. Referencyjne wideo z audio wymaga subjects i wyraźnej wartości true. |
audio_type |
string | Po włączeniu audio użyj all (domyślnie), speech_only lub sound_effect_only. |
is_rec |
boolean | Automatyczne zalecenie dla image-to-video. Włączenie zwiększa wykorzystanie zadań. |
duration |
integer | Od 3 do 16 sekund, z 5 jako domyślnym. |
resolution |
string | 540p, 720p (domyślnie), 1080p, 2K lub 4K. |
aspect_ratio |
string | Reference-to-video Tylko. Użyj 16:9 (domyślnie), 9:16, 3:4, 4:3 lub 1:1. Image-to-video podąża za obrazem wejściowym. |
seed |
integer | Pomiń pole lub ustaw 0, aby użyć losowego ziarna. |
payload |
string | Opcjonalne dane aplikacji, do znaków 1,048,576. |
watermark |
boolean | Wartość domyślna: false. |
wm_url |
string | Opcjonalny znak wodny URL. Domyślny znak wodny pojawia się w lewej górnej części. API nie akceptuje wm_position. |
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'
Sprawdzaj stan co 5–10 sekund za pomocą task_id i tego samego konta. Państwa to created, queueing, processing, success i failed. W sprawie sukcesu, creations[].url jest to film i creations[].cover_url to jego przykrywka. Pobierz tymczasowe linki w ciągu 12 godzin. Należy zachować request_id przy zgłaszaniu awarii.
Użyj Idempotency-Key z 8–128 widoczne ASCII znaki do odzyskania złożenia. Ten sam klucz i te same parametry zwracają potwierdzenie odzyskania z kodem HTTP 202. Ten sam klucz z innymi parametrami zwraca HTTP 409. Zob. Przewodnik odzyskiwania żądań. Czas oczekiwania może być ponownie wypróbowany bez tworzenia nowego filmu.
Brama raz ustawia pokolenie. tokenhub_usage.total_tokens raportuje billable use. Patrz Vidu Video Q4 Preview karta modelowa dla bieżącego APIMaster Cena.
