APIMaster.ai

Vidu Video Q4 Preview · Referensi API

Hasilkan video dari gambar atau referensi tunggal, kemudian jajak pendapat APIMaster tugas.

Gunakan POST /v1/wand/vidu/image-to-video untuk satu gambar awal atau POST /v1/wand/vidu/reference-to-video untuk generasi referensi-dipandu. Poll dengan GET /v1/wand/vidu/tasks/{task_id}. Gunakan JSON untuk pengiriman dan Bearer otentikasi untuk setiap permintaan. Generasi hanya teks dan titik akhir awal/akhir-akhir-frame terpisah tidak tersedia untuk model ini.

Kolom Tipe Deskripsi
model string Wajib. Gunakan vidu-video-q4-preview.
images string[] Image-to-video Membutuhkan tepat satu gambar. Reference-to-video menerima hingga 15 gambar atau subjects. Gunakan publik URLs atau URI data di PNG, JPEG/JP, atau WebP. Rasio aspek harus 1:4 ke 4:1. Setiap gambar URL dapat sampai ke 50 MB. Base64 gambar terbatas ke 15 MB sebelum pengkodean dan 20 MB dikodekan secara total.
subjects object[] For reference-to-video sebagai alternatif untuk images. Set setiap item name dan satu sampai tiga images. Refer ke subjek dengan @name dalam prompt.
prompt string Diperlukan untuk reference-to-video. Hingga karakter 2,000 untuk referensi gambar langsung atau 5,000 untuk subyek dan image-to-video. Image-to-video mengabaikan bidang ini ketika is_rec aktif.
auto_subjects boolean Pilihan pustaka subjek untuk reference-to-video. Nilai bawaan: false.
audio boolean Default ke true untuk image-to-video dan false untuk reference-to-video. Video referensi dengan audio membutuhkan subjects dan nilai true yang eksplisit.
audio_type string Ketika audio diaktifkan, gunakan all (bawaan), speech_only, atau sound_effect_only.
is_rec boolean Saran prompt otomatis bagi image-to-video. Mengaktifkannya meningkatkan penggunaan tugas.
duration integer Dari 3 ke 16 detik, dengan 5 sebagai default.
resolution string 540p, 720p (baku), 1080p, 2K, atau 4K.
aspect_ratio string Reference-to-video Hanya. Gunakan 16:9 (baku), 9:16, 3:4, 4:3, atau 1:1. Image-to-video mengikuti gambar masukan.
seed integer Hilangkan kolom atau gunakan 0 untuk seed acak.
payload string Data aplikasi opsional, hingga 1,048,576 karakter.
watermark boolean Nilai bawaan: false.
wm_url string Tanda air gubahan tambahan URL. Tanda air bawaan muncul di kiri atas. API tidak menerima 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"}'

Gunakan task_id dan akun yang sama untuk memeriksa status setiap 5–10 detik. Negara bagian created, queueing, processing, success, dan failed. Saat sukses, creations[].url adalah video dan creations[].cover_url adalah sampulnya. Unduh link sementara dalam 12 jam. Pertahankan request_id saat melaporkan kegagalan.

Gunakan Idempotency-Key dari 8–128 yang terlihat ASCII karakter untuk memulihkan penyerahan. Kunci dan parameter yang sama mengembalikan tanda terima pemulihan dengan HTTP 202. Parameter berbeda dengan kunci yang sama mengembalikan HTTP 409. Lihat Panduan pemulihan permintaan. Tenggat waktu Query dapat dicoba ulang tanpa membuat video baru.

Gateway menetap generasi sekali. tokenhub_usage.total_tokens laporan penggunaan tagihan. Lihat Vidu Video Q4 Preview model card saat ini untuk harga APIMaster.