Wan2.7
Pembuatan Video Wan2.7
- Model pembuatan video Alibaba Cloud Wanxiang 2.7 (entry terpadu)
- Dirutekan otomatis berdasarkan parameter: Teks-ke-Video / Gambar-ke-Video (frame pertama, frame pertama-terakhir, kelanjutan video)
- Mendukung resolusi 720P/1080P, durasi 2-15 detik
- Mendukung audio kustom (musik latar dalam mode teks-ke-video, audio pengarah dalam mode gambar-ke-video)
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.7boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
true: periksa prompt dan gambar input denganomni-moderation-latestfalseatau 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
"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)
image_with_rolesarray<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, defaultfirst_frame
array<string>
Array URL video. Menyediakannya masuk ke mode kelanjutan video (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
Prompt negatif yang menjelaskan konten yang tidak diinginkan, hingga 500 karakterContoh:
"blurry, distorted, low quality"string
default:"1080P"
Resolusi videoOpsi:
720P- Standar1080P- Definisi tinggi (default)
integer
default:"5"
Durasi video (detik)Rentang yang didukung:
2 ~ 15 detikDefault: 5string
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- Potret1:1- Persegi4:3- Lanskap3:4- Potret
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
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt pendek, tetapi menambah waktu pemrosesanDefault:
trueboolean
default:"false"
Apakah menambahkan watermark “AI Dihasilkan” ke video yang dihasilkan
true: tambahkan watermarkfalse: 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.