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-mix - Kualitas premium, transisi cerdas lebih kuat, mendukung video pendek 1 detik
  • viduq3 - Pilihan default, peralihan kamera lebih cerdas
Cara memilih: Gunakan viduq3 untuk penggunaan sehari-hari; gunakan viduq3-mix untuk kualitas premium atau efek gerakan 1-2 detik.
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 5000 karakterJelaskan aksi dan pergerakan kamera, bukan penampilan (penampilan ditentukan oleh gambar referensi).Contoh: "Santa Claus and the bear hug by the lakeside"
array<url>
wajib
Array URL gambar referensi, 1-7 gambarMendukung URL gambar yang dapat diakses publik (http:// atau https://)Contoh: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Jumlah: 1-7 gambar
  • Format yang didukung: PNG, JPEG, JPG, WebP
  • Ukuran minimum: 128×128
  • Rasio aspek: antara 1:4 dan 4:1
  • Ukuran file maksimum: ≤ 50MB per gambar
  • Harus berupa URL yang dapat diakses publik
integer
default:"5"
Durasi video (detik)
  • viduq3-mix: 1 hingga 16
  • viduq3: 3 hingga 16
Default: 5
viduq3 mendukung minimum 3 detik, viduq3-mix mendukung minimum 1 detik. Harap kirim durasi yang valid berdasarkan model yang dipilih.
string
default:"720p"
Resolusi video
  • viduq3-mix: 720p (default) / 1080p
  • viduq3: 540p / 720p (default) / 1080p
viduq3-mix tidak mendukung 540p, Gunakan 720p atau 1080p.
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 4:3 - Tradisional
  • 3:4 - Potret tradisional
  • 1:1 - Persegi
integer
Seed acak untuk mengontrol keacakan pembuatanJika tidak disediakan, seed acak akan digunakan.
Menggunakan seed yang sama dengan parameter yang identik akan menghasilkan hasil serupa, tetapi tidak dijamin persis sama.

Perbandingan Model

Respons

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

Kasus Penggunaan

Kasus 1: Referensi-ke-Video Dasar viduq3

Kasus 2: Referensi-ke-Video Kualitas Tinggi viduq3-mix

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