APIMaster.ai

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.