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.
