Wan2.5
Pembuatan Video wan2.5-preview
- Model pembuatan video pratinjau Wanxiang 2.5
- Mendukung Teks-ke-Video dan Gambar-ke-Video
- Mendukung resolusi 480p/720p/1080p, durasi 5 atau 10 detik
- Mendukung ekstensi prompt otomatis, audio otomatis, dan audio kustom
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-previewboolean
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 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:1720p- HD (default), mendukung size:16:9,9:16,1:1,4:3,3:41080p- FHD, mendukung size:16:9,9:16,1:1,4:3,3:4
720pResolusi secara langsung memengaruhi harga: 1080p > 720p > 480p.
integer
default:"5"
Durasi video (detik)Hanya mendukung:
5 atau 10 detikDefault: 5string
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- Potret1:1- Persegi
16:9- Lanskap (default)9:16- Potret1:1- Persegi4:3- Lanskap3:4- Potret
16:9integer
Random seed (≥0), menetapkan seed yang sama dapat mereproduksi hasil serupaContoh:
12345boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt yang lebih pendek, tetapi menambah waktu pemrosesanDefault:
trueboolean
default:"true"
Apakah menambahkan audio secara otomatisJika diaktifkan, sistem akan membuat audio yang sesuai untuk videoDefault:
truestring
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
boolean
default:"false"
Apakah menambahkan watermark “AI Dihasilkan” (kanan bawah)Default:
falseKombinasi Resolusi dan Rasio Aspek
Kombinasisize 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
promptwajib - Jangan mengirim
image_urls - Gunakan
sizeuntuk menentukan rasio aspek
Gambar-ke-Video
- Parameter
image_urlswajib (hanya 1 gambar didukung) promptopsional, digunakan untuk menjelaskan aksi yang diharapkan- Rasio aspek ditentukan oleh gambar input, jangan mengirim
size
Sistem otomatis memilih mode berdasarkan apakah
image_urls disertakanKueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan
task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.