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:

Perutean Mode

wan2.7 adalah entry terpadu untuk teks-ke-video dan gambar-ke-video. Backend otomatis menentukan mode berdasarkan parameter yang masuk. Kedua mode ditagih dengan cara yang sama:

Parameter Permintaan

string
wajib
Nama model pembuatan video, tetap sebagai wan2.7
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 video, hingga 5000 karakter
  • Mode Teks-ke-Video (saat tidak ada gambar/video yang disediakan): wajib
  • Mode Gambar-ke-Video: opsional, tetapi direkomendasikan untuk memandu pergerakan kamera dan aksi
Contoh: "A cat chasing butterflies on the grass, bright sunshine, slow motion"
array<string>
Array URL gambar. Menyediakannya otomatis masuk ke mode Gambar-ke-Video
  • 1 gambar: frame pertama ke video
  • 2 gambar: frame pertama-terakhir ke video (ke-1 = frame pertama, ke-2 = frame terakhir)
Gunakan ini atau image_with_roles
image_urls bertentangan dengan audio_url; keduanya tidak dapat disediakan secara bersamaan
array<object>
Array gambar dengan peran, alternatif untuk image_urls, digunakan untuk menentukan peran setiap gambar secara tepatField untuk setiap objek:
  • url (string): URL gambar (mendukung http/https)
  • role (string): peran gambar, first_frame / last_frame, default first_frame
Contoh:
image_with_roles bertentangan dengan audio_url; keduanya tidak dapat disediakan secara bersamaan
array<string>
Array URL video. Menyediakannya masuk ke mode kelanjutan video (hanya video ke-1 yang digunakan)
video_urls bertentangan dengan audio_url; keduanya tidak dapat disediakan secara bersamaan
Batasan video:
  • Format: mp4, mov
  • Durasi: 2–10 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 karakterContoh: "blurry, distorted, low quality"
string
default:"1080P"
Resolusi videoOpsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 2 ~ 15 detikDefault: 5
string
default:"16:9"
Rasio aspek, hanya berlaku dalam Mode Teks-ke-Video (saat tidak ada gambar/video yang disediakan)Format yang didukung:
  • 16:9 - Lanskap layar lebar (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Parameter ini diabaikan dalam Mode Gambar-ke-Video; rasio aspek ditentukan secara otomatis oleh gambar input
string
URL audio kustom
  • Mode Teks-ke-Video: digunakan sebagai musik latar
  • Mode Gambar-ke-Video: digunakan sebagai audio pengarah, disinkronkan dengan aksi di layar
Format: wav / mp3, durasi 2-30 detik, ukuran file ≤ 15MB
audio_url bertentangan dengan video_urls, image_urls, dan image_with_roles; tidak dapat disediakan secara bersamaan
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt pendek, tetapi menambah waktu pemrosesanDefault: true
boolean
default:"false"
Apakah menambahkan watermark “AI Dihasilkan” ke video yang dihasilkan
  • true: tambahkan watermark
  • false: tanpa watermark (default)
integer
Seed integer yang digunakan untuk mengontrol keacakan konten yang dihasilkanRentang nilai: integer ≥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 serupa saat menerima nilai seed yang sama, tetapi konsistensi yang persis tidak dijamin

Respons

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

Kasus Penggunaan

Kasus 1: Teks-ke-Video (Permintaan Paling Sederhana)

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

Kasus 3: Frame Pertama ke Video

Kasus 4: Frame Pertama-Terakhir ke Video

Dengan 2 gambar: gambar ke-1 adalah frame pertama, gambar ke-2 adalah frame terakhir. Anda juga dapat menggunakan image_with_roles untuk spesifikasi yang tepat.

Kasus 5: Kelanjutan Video

Kasus 6: Gambar + Audio Pengarah

Panduan Pemilihan Mode

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