Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Parameter Permintaan

string
wajib
Nama model pembuatan videoModel yang didukung:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Prompt teks, maksimum 2000 karakterWajib untuk teks-ke-video. Opsional untuk mode gambar-ke-video dan frame pertama-terakhir.Contoh: "A cat playing piano, camera slowly zooms in"
integer
default:"5"
Durasi video (detik)Rentang: 1 hingga 16Default: 5
string
default:"720p"
Resolusi videoOpsi:
  • 540p - Definisi standar
  • 720p - HD (default)
  • 1080p - Full HD
Default: 720p
string
Rasio aspek video (hanya untuk mode teks-ke-video)Opsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 4:3 - Tradisional
  • 3:4 - Potret tradisional
  • 1:1 - Persegi
Parameter ini hanya tersedia dalam mode teks-ke-video (saat image_urls tidak disediakan).
array<url>
Array URL gambar untuk pembuatan gambar-ke-videoSistem otomatis menentukan mode pembuatan berdasarkan jumlah gambar:
  • 0 gambar (tidak disediakan): Mode teks-ke-video
  • 1 gambar: Mode gambar-ke-video (gambar digunakan sebagai frame awal)
  • 2 gambar: Mode frame pertama-terakhir (gambar pertama = frame pertama, gambar kedua = frame terakhir)
Contoh: ["https://example.com/photo.jpg"]
  • Maksimum 2 gambar didukung
  • Untuk mode frame pertama-terakhir, tepat 2 gambar harus disediakan
  • Saat image_urls disediakan (baik 1 atau 2 gambar), parameter aspect_ratio tidak dapat digunakan — rasio aspek video akan ditentukan otomatis oleh gambar
boolean
default:"true"
Apakah membuat audio (dialog, efek suara)Default: trueAtur ke false jika Anda membutuhkan video tanpa suara.
integer
Seed integer untuk mengontrol keacakan konten yang dihasilkanRentang: integer antara -1 dan 2^32-1
  • Dengan permintaan yang sama, nilai seed berbeda (termasuk tidak ditentukan atau -1 yang menggunakan angka acak) akan menghasilkan hasil yang berbeda
  • Dengan permintaan yang sama, nilai seed yang sama akan menghasilkan hasil yang serupa, namun reproduktifitas persis tidak dijamin

Perutean Otomatis

Sistem otomatis menentukan mode pembuatan berdasarkan jumlah gambar dalam image_urls:

Matriks Dukungan Parameter

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Kasus Penggunaan

Kasus 1: Teks-ke-Video

Kasus 2: Gambar-ke-Video (Gambar Tunggal)

Kasus 3: Video Frame Pertama-Terakhir

Kasus 4: Video Tanpa Suara (Audio Dinonaktifkan)

Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.