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 video, tetap sebagai wan2.7-r2v
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
Deskripsi konten video, hingga 5000 karakterUntuk beberapa gambar/video, gunakan “gambar 1”, “gambar 2”, “video 1”, dll. untuk merujuk ke aset referensi terkait (sesuai urutan input)Contoh: "The character in image 1 enters the scene in image 2 and looks around"
array<object>
Array gambar dengan role; setidaknya salah satu dari field ini dan video_urls harus disediakanField untuk setiap objek:
  • url (string): URL gambar
  • role (string): role gambar
    • reference_image - gambar referensi (default)
    • first_frame - bingkai pertama yang ditentukan (saat disediakan, size diabaikan dan rasio aspek mengikuti gambar bingkai pertama)
  • reference_voice (string, opsional): URL sampel audio suara untuk karakter referensi tersebut, digunakan untuk mengontrol suara karakter dalam video yang dihasilkan
Contoh:
array<string>
Array URL video referensi, hingga 5 video (total gambar + video ≤ 5)Setidaknya salah satu dari field ini dan image_with_roles harus disediakan
Batasan video:
  • Format: mp4, mov
  • Durasi: 1–30 detik
  • Resolusi: lebar dan tinggi dalam rentang [240, 4096] piksel
  • Rasio aspek: 1:8 – 8:1
  • Ukuran file: hingga 100MB
string
Prompt negatif yang menjelaskan konten yang tidak diinginkan, hingga 500 karakter
string
default:"1080P"
Resolusi videoOpsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 2 ~ 15 detikDefault: 5
Ketika aset referensi mencakup video: bilangan bulat antara [2, 10].Ketika aset referensi tidak mencakup video: bilangan bulat antara [2, 15].
string
default:"16:9"
Rasio aspekFormat yang didukung:
  • 16:9 - Lanskap layar lebar (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Saat first_frame disediakan melalui image_with_roles, parameter ini diabaikan dan rasio aspek mengikuti gambar frame pertama
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt pendek, namun menambah waktu pemrosesanDefault: true
boolean
default:"false"
Apakah akan menambahkan watermark “AI Generated” ke video yang dihasilkan
  • true: tambahkan watermark
  • false: tanpa watermark (default)
integer
Seed bilangan bulat yang digunakan untuk mengontrol keacakan konten yang dihasilkanRentang nilai: bilangan bulat ≥0
  • Untuk permintaan yang identik, model menghasilkan hasil yang berbeda saat menerima nilai seed yang berbeda (misalnya, menghilangkan seed)
  • Untuk permintaan yang identik, model menghasilkan hasil yang serupa saat menerima nilai seed yang sama, namun konsistensi yang tepat tidak dijamin

Respons

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

Kasus Penggunaan

Kasus 1: Satu Gambar Referensi (Paling Sederhana)

Kasus 2: Beberapa Gambar Referensi

Kasus 3: Pembuatan Berdasarkan Video Referensi

Kasus 4: Bingkai Pertama Ditentukan + Gambar Referensi

Kasus 5: Gambar Referensi + Suara Referensi (Presisi)

Aturan Referensi Gambar

Dengan beberapa gambar referensi, gunakan indeks numerik dalam prompt untuk merujuknya:
  • Gambar ke-1 → “gambar 1” atau “gambar pertama”
  • Video ke-1 → “video 1” atau “video pertama”
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.