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-videoedit
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)
array<string>
wajib
Array URL video sumber untuk pengeditan
Hanya video ke-1 yang digunakan
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
Instruksi pengeditan yang menjelaskan perubahan yang diinginkan, hingga 5000 karakter
Jika dihilangkan, model akan melakukan transfer gaya default
Contoh: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
string
Prompt negatif yang menjelaskan konten yang tidak diinginkan, hingga 500 karakter
array<string>
Array URL gambar referensi, hingga 4 gambarDigunakan untuk menentukan gaya atau tampilan target (misalnya, gaya referensi untuk transfer gaya)
string
default:"1080P"
Resolusi video outputOpsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
integer
default:"0"
Durasi video output (detik)
  • 0 (default): pertahankan durasi penuh video asli
  • Bilangan bulat antara 2-10: ambil durasi yang ditentukan dari awal
Ketika duration=0, penagihan didasarkan pada durasi aktual video outputDurasi yang ditentukan tidak boleh melebihi durasi video video_urls asli
string
Rasio aspek outputFormat yang didukung:
  • 16:9 - Lanskap layar lebar
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Jika dihilangkan, rasio aspek mengikuti video input
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
object
Objek parameter tambahan

Respons

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

Kasus Penggunaan

Kasus 1: Pengeditan Video Dasar (Paling Sederhana)

Kasus 2: Transfer Gaya (Dengan Gambar Referensi)

Kasus 3: Pertahankan Audio Video Asli

Cocok untuk video dengan suara latar atau dialog penting:

Kasus 4: Parameter Lengkap

Penanganan Audio

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