Skip to main content
POST

Autentikasi

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

Parameter Permintaan

string
wajib
Nama model pembuatan video, tetap sebagai wan2.5-preview
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
Deskripsi konten videoWajib untuk teks-ke-video (tanpa image_urls), opsional tetapi direkomendasikan untuk gambar-ke-videoJelaskan adegan, aksi, dan gaya secara detail untuk hasil yang lebih baikContoh: "Sunset coastal highway, cinematic shot"
array<string>
Array URL gambar referensi (hanya 1 gambar didukung)Wajib untuk mode gambar-ke-video, mendukung URL gambar yang dapat diakses publik atau encoding Base64 (data:image/png;base64,...)Contoh: ["https://example.com/image.jpg"]
Sistem otomatis memilih mode teks-ke-video atau gambar-ke-video berdasarkan apakah image_urls disertakan. Jangan mengirim image_urls untuk mode teks-ke-video.
string
Prompt negatif, menjelaskan konten yang tidak diinginkanMaksimum 500 karakterContoh: "blurry, low quality, distorted"
string
default:"720p"
Resolusi videoOpsi:
  • 480p - SD, mendukung size: 16:9, 9:16, 1:1
  • 720p - HD (default), mendukung size: 16:9, 9:16, 1:1, 4:3, 3:4
  • 1080p - FHD, mendukung size: 16:9, 9:16, 1:1, 4:3, 3:4
Default: 720p
Resolusi secara langsung memengaruhi harga: 1080p > 720p > 480p.
480p hanya mendukung rasio 16:9, 9:16, 1:1. Mengirim 4:3 atau 3:4 akan menyebabkan error.
integer
default:"5"
Durasi video (detik)Hanya mendukung: 5 atau 10 detikDefault: 5
string
default:"16:9"
Rasio aspek, hanya berlaku untuk teks-ke-video (tanpa image_urls)Opsi tergantung pada resolution:480p:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 1:1 - Persegi
720p / 1080p:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Default: 16:9
Untuk gambar-ke-video, rasio aspek ditentukan oleh gambar input. Jangan mengirim size, jika tidak error akan dikembalikan.
integer
Random seed (≥0), menetapkan seed yang sama dapat mereproduksi hasil serupaContoh: 12345
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt yang lebih pendek, tetapi menambah waktu pemrosesanDefault: true
boolean
default:"true"
Apakah menambahkan audio secara otomatisJika diaktifkan, sistem akan membuat audio yang sesuai untuk videoDefault: true
Model ini hanya mendukung audio=true. Mengatur ke false untuk video tanpa suara tidak didukung.
string
URL audio kustom (wav/mp3, 3-30 detik, ≤ 15MB)Jika audio lebih panjang dari durasi video, audio akan dipotong secara otomatis; jika lebih pendek, bagian sisanya tanpa suara
Persyaratan file audio:
  • Format: wav, mp3
  • Durasi: 3-30 detik
  • Ukuran: ≤ 15MB
boolean
default:"false"
Apakah menambahkan watermark “AI Dihasilkan” (kanan bawah)Default: false

Kombinasi Resolusi dan Rasio Aspek

Kombinasi size dan resolution dipetakan ke dimensi piksel upstream (hanya berlaku untuk teks-ke-video):
480p hanya mendukung rasio 16:9, 9:16, 1:1. Mengirim 4:3 atau 3:4 akan menyebabkan error. 720p dan 1080p mendukung semua 5 rasio.

Respons

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

Kasus Penggunaan

Kasus 1: Teks-ke-Video (Sederhana)

Kasus 2: Teks-ke-Video (Parameter Lengkap)

Kasus 3: Gambar-ke-Video

Kasus 4: Gambar-ke-Video (Base64 Gambar)

Kasus 5: Audio Kustom

Deskripsi Mode

Teks-ke-Video

  • Parameter prompt wajib
  • Jangan mengirim image_urls
  • Gunakan size untuk menentukan rasio aspek

Gambar-ke-Video

  • Parameter image_urls wajib (hanya 1 gambar didukung)
  • prompt opsional, digunakan untuk menjelaskan aksi yang diharapkan
  • Rasio aspek ditentukan oleh gambar input, jangan mengirim size
Sistem otomatis memilih mode berdasarkan apakah image_urls disertakan
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.