Model image-to-video Wan menghasilkan video yang mulus dari gambar frame pertama dan prompt teks .
Dokumen terkait: Panduan pengguna
Model, URL endpoint, dan Kunci API Anda harus berada di wilayah yang sama. Pemanggilan lintas wilayah akan gagal.
Tugas image-to-video menggunakan pemanggilan asinkron (biasanya 1–5 menit): buat tugas → polling hasil.
Ganti
Ganti
Nama parameter SDK sebagian besar konsisten dengan API HTTP, mengikuti konvensi masing-masing bahasa.
Tugas image-to-video biasanya memerlukan waktu 1–5 menit. SDK membungkus proses pemanggilan HTTP asinkron dan mendukung pemanggilan sinkron maupun asinkron.
Atur
Ganti
Atur
Ganti
Saat wan2.6-i2v-flash menghasilkan rotasi berkelanjutan objek melingkar (seperti cincin, roda gigi, atau jarum jam), video mungkin berhenti sekitar 1 detik pada sekitar tanda 3 detik. Untuk menghindari masalah ini, gunakan model Wan 2.7 - image-to-video sebagai gantinya.
Jika pemanggilan model mengembalikan pesan kesalahan, lihat Kode kesalahan.
J: Gambar frame pertama masukan (img_url) menentukan rasio aspek video keluaran. Namun, rasio tepat seperti 3:4 tidak dijamin, karena kemungkinan terjadi penyimpangan kecil.
J: Video yang dihasilkan model disimpan di OSS. API mengembalikan URL publik sementara. Untuk mengonfigurasi daftar izin firewall untuk URL unduhan ini, perhatikan hal berikut: Penyimpanan dasar dapat berubah secara dinamis. Topik ini tidak menyediakan daftar nama domain OSS tetap untuk mencegah masalah akses akibat informasi yang kedaluwarsa. Jika Anda memiliki persyaratan kontrol keamanan, hubungi manajer akun Anda untuk mendapatkan daftar nama domain OSS terbaru.
Wan 2.7 - image-to-video mendukung first-frame-to-video, first-and-last-frame-to-video, dan kelanjutan video. Kami merekomendasikan versi ini.Fitur image-to-video (berbasis frame pertama) untuk model Wan 2.6 dan sebelumnya hanya mendukung first-frame-to-video.
Ketersediaan
Model, URL endpoint, dan Kunci API Anda harus berada di wilayah yang sama. Pemanggilan lintas wilayah akan gagal.
- Pilih model: Konfirmasi wilayah tempat model tersedia.
- Pilih URL: Pilih URL endpoint untuk wilayah yang sesuai. URL HTTP dan SDK DashScope didukung.
- Konfigurasikan Kunci API: Dapatkan Kunci API untuk wilayah tersebut, lalu konfigurasikan Kunci API dalam variabel lingkungan Anda.
- Instal SDK: Untuk melakukan pemanggilan dengan SDK, instal SDK DashScope.
Kode contoh dalam topik ini ditujukan untuk wilayah Singapura.
Pemanggilan HTTP
Tugas image-to-video menggunakan pemanggilan asinkron (biasanya 1–5 menit): buat tugas → polling hasil.
Langkah 1: Buat tugas
- Singapura
- Virginia
- Beijing
- Frankfurt
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk menanyakan hasilnya.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.
Parameter permintaanHeaderContent-Typestring (Wajib)Tipe konten permintaan. Harus berupa application/json.Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung pemanggilan asinkron. Harus diatur ke enable.Isi permintaanmodelstring (Wajib)Nama model. Model yang tersedia dan harga: harga model.Contoh: wan2.6-i2v-flash.input object (Wajib)Bidang masukan termasuk prompt.
Properti prompt string (Opsional)Menjelaskan elemen visual dan karakteristik yang diinginkan dari video yang dihasilkan.Mendukung bahasa Tionghoa dan Inggris. Setiap karakter dihitung sebagai satu. Teks yang melebihi batas akan dipotong. Batas panjang berdasarkan model:
string (Opsional)Menjelaskan apa yang harus dikecualikan dari video, membatasi keluaran.Mendukung bahasa Tionghoa dan Inggris. Maksimal 500 karakter; teks yang lebih panjang akan dipotong.Contoh: resolusi rendah, kesalahan, kualitas terburuk, kualitas rendah, cacat bentuk, jari ekstra, proporsi buruk, dll.img_url string (Wajib)URL atau data terenkripsi Base64 dari gambar awal.Batasan gambar:
string (Opsional)Model yang didukung: Model seri Wan2.6 dan Wan2.5.URL file audio. Model menghasilkan video menggunakan audio ini.Format masukan yang didukung:
object (Opsional)Kontrol untuk resolusi, durasi, penulisan ulang prompt cerdas, dan watermark.
Properti resolution string (Opsional)Menentukan tingkat resolusi video keluaran. Model menskalakan keluaran ke jumlah total piksel yang serupa berdasarkan tingkat yang dipilih. Model mempertahankan rasio aspek keluaran sedekat mungkin dengan rasio aspek gambar masukan diimg_url. Untuk detail selengkapnya, lihat FAQ.Nilai default dan nilai enum yang tersedia untuk parameter ini bergantung pada parameter model, sebagai berikut:
integer (Opsional)Durasi video keluaran, dalam detik. Nilai valid bergantung pada parameter model:
boolean (Opsional)Apakah akan mengaktifkan penulisan ulang prompt. Saat diaktifkan, LLM menulis ulang prompt masukan. Ini meningkatkan kualitas generasi untuk prompt yang lebih pendek tetapi meningkatkan waktu pemrosesan.
string (Opsional)Model yang didukung: Model seri Wan2.6.Menentukan jenis shot video yang dihasilkan: satu shot berkelanjutan atau rangkaian beberapa shot.Parameter ini hanya berlaku saat "prompt_extend": true.Prioritas parameter: shot_type > prompt. Misalnya, jika shot_type diatur ke "single", meskipun prompt berisi "generate a multi-shot video", model tetap akan menghasilkan video single-shot.Nilai valid:
Gunakan parameter ini saat Anda memerlukan kontrol ketat atas struktur narasi, seperti single shot untuk demo produk atau multiple shot untuk film pendek. boolean (Opsional)Model yang didukung: wan2.6-i2v-flash.Menentukan apakah akan menghasilkan video dengan suara.Prioritas parameter: audio > audio_url. Saat audio=false, keluaran tetap berupa video tanpa suara meskipun audio_url disediakan, dan penagihan didasarkan pada video tanpa suara.Nilai valid:
boolean (Opsional)Menentukan apakah akan menambahkan watermark "AI Generated" di pojok kanan bawah video.
integer(Opsional)Bilangan acak seed. Rentang nilai: [0, 2147483647].Jika tidak ditentukan, sistem menghasilkan satu. Untuk reproduktibilitas yang lebih baik, gunakan seed tetap.Generasi bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda.Contoh: 12345. |
Fitur ini hanya didukung oleh model seri Wan2.6.Anda dapat mengaktifkannya dengan mengatur "prompt_extend": true dan "shot_type":"multi". |
Parameter responsoutputobjectInformasi tentang keluaran tugas.
Properti task_id stringID tugas. Berlaku untuk penanyakan selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringPengidentifikasi permintaan unik untuk pelacakan dan troubleshooting.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk menanyakan status dan hasil tugas. |
Langkah 2: Tanyakan hasil tugas
- Singapura
- Virginia
- China (Beijing)
- Frankfurt
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Rekomendasi polling: Pembuatan video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang wajar, misalnya 15 detik.
- Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
- Tautan hasil: Setelah tugas berhasil, URL video yang berlaku selama 24 jam dikembalikan. Unduh dan simpan video ke penyimpanan permanen, seperti OSS.
task_idmasa berlaku: 24 jam. Setelah periode ini, penanyakan akan mengembalikan status tugas sebagaiUNKNOWN.
Parameter permintaanHeaderAuthorizationstring (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Parameter jalurtask_idstring (Wajib)ID tugas. |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh pemanggilan API sebelumnya. task_id berlaku untuk penanyakan selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Parameter responsoutputobjectDetail keluaran tugas.
Properti task_id stringID tugas. Berlaku untuk penanyakan selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL video yang dihasilkan. Hanya dikembalikan saat task_status bernilai SUCCEEDED.Berlaku selama 24 jam. Video dalam format MP4 dengan encoding H.264.orig_prompt stringPrompt masukan asli, sesuai dengan parameter permintaan prompt.actual_prompt stringJika prompt_extend bernilai true, sistem menulis ulang prompt, dan bidang ini berisi versi yang dioptimalkan.
stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.objectStatistik penggunaan tugas, yang hanya dihitung untuk tugas yang berhasil.
Properti
Parameter yang dikembalikan oleh model seri wan2.6 input_video_duration integerDurasi video masukan dalam detik. Nilai ini selalu 0, karena masukan video saat ini tidak didukung.output_video_duration integerHanya dikembalikan saat menggunakan model wan2.6.Durasi video keluaran dalam detik. Nilai ini sesuai dengan input.duration.duration integerTotal durasi video, digunakan untuk penagihan.Rumus penagihan: duration=input_video_duration+output_video_duration.SR integerHanya dikembalikan saat menggunakan model wan2.6. Tingkat resolusi video yang dihasilkan. Contoh: 720.video_count integerJumlah video yang dihasilkan. Nilai ini tetap 1.audiobooleanHanya dikembalikan saat menggunakan model wan2.6-i2v-flash. Menunjukkan apakah keluaran berupa video dengan audio.
Parameter yang dikembalikan oleh model seri wan2.2 dan wan2.5 duration integerDurasi video yang dihasilkan dalam detik. Nilai yang mungkin: 5, 10.Rumus penagihan: Biaya = Durasi video dalam detik × Harga satuan.SR integerResolusi video yang dihasilkan. Nilai yang mungkin: 480, 720, 1080.video_count integerJumlah video yang dihasilkan. Nilai ini tetap 1.
Parameter yang dikembalikan oleh model seri wan2.1 video_duration integerDurasi video yang dihasilkan dalam detik. Nilai yang mungkin: 3, 4, 5.Rumus penagihan: Biaya = Durasi video dalam detik × Harga satuan.video_ratio stringRasio aspek video yang dihasilkan. Nilai ini selalu "standard".video_count integerJumlah video yang dihasilkan. Nilai ini tetap 1.stringPengidentifikasi permintaan unik untuk pelacakan dan troubleshooting. |
URL video hanya berlaku selama 24 jam lalu secara otomatis dihapus. Segera simpan video yang dihasilkan. |
Pemanggilan SDK DashScope
Nama parameter SDK sebagian besar konsisten dengan API HTTP, mengikuti konvensi masing-masing bahasa.
Tugas image-to-video biasanya memerlukan waktu 1–5 menit. SDK membungkus proses pemanggilan HTTP asinkron dan mendukung pemanggilan sinkron maupun asinkron.
Waktu pemrosesan bergantung pada antrian tugas dan status layanan.
SDK Python
Atur base_http_api_url sesuai wilayah model:
- Singapura
- Virginia
- Beijing
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'{WorkspaceId} dengan ID ruang kerja aktual Anda.
Kode contoh
- Pemanggilan sinkron
- Pemanggilan asinkron
Pemanggilan sinkron memblokir hingga pembuatan video selesai. Contoh ini menunjukkan tiga metode masukan gambar: URL publik, enkode Base64, dan jalur file lokal.
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Unduh video sebelum kedaluwarsa.
SDK Java
Atur baseHttpApiUrl sesuai wilayah model:
- Singapura
- Virginia
- Beijing
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} dengan ID ruang kerja aktual Anda.
Kode contoh
- Pemanggilan sinkron
- Pemanggilan asinkron
Pemanggilan sinkron memblokir hingga pembuatan video selesai. Contoh ini menunjukkan tiga metode masukan gambar: URL publik, enkode Base64, dan jalur file lokal.
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Unduh video sebelum kedaluwarsa.
Batasan
- Retensi data:
task_iddan URL video disimpan selama 24 jam. Setelah periode ini, Anda tidak dapat menanyakan atau mengunduhnya. - Moderasi konten: Semua masukan (prompt, gambar) dan video keluaran dikenai moderasi konten. Pelanggaran menghasilkan kesalahan
IPInfringementSuspectatauDataInspectionFailed. Kode kesalahan.
Batasan yang diketahui
Saat wan2.6-i2v-flash menghasilkan rotasi berkelanjutan objek melingkar (seperti cincin, roda gigi, atau jarum jam), video mungkin berhenti sekitar 1 detik pada sekitar tanda 3 detik. Untuk menghindari masalah ini, gunakan model Wan 2.7 - image-to-video sebagai gantinya.
Kode kesalahan
Jika pemanggilan model mengembalikan pesan kesalahan, lihat Kode kesalahan.
FAQ
T: Bagaimana cara menghasilkan video dengan rasio aspek tertentu?
J: Gambar frame pertama masukan (img_url) menentukan rasio aspek video keluaran. Namun, rasio tepat seperti 3:4 tidak dijamin, karena kemungkinan terjadi penyimpangan kecil.
-
Mengapa terjadi penyimpangan?
Model menggunakan rasio aspek gambar masukan sebagai garis dasar dan menggabungkannya dengan jumlah total piksel dari tingkat resolusi yang dipilih (
resolution) untuk menghitung resolusi valid terdekat. Karena lebar dan tinggi video harus merupakan kelipatan 16, model menyesuaikan resolusi akhir sesuai kebutuhan. Akibatnya, rasio aspek keluaran tidak dijamin tepat 3:4, tetapi akan sangat mendekati.- Sebagai contoh, gambar masukan berukuran 750×1000 (rasio aspek 3:4 = 0,75) dengan
resolutiondiatur ke "720P" (target sekitar 920.000 piksel total) menghasilkan keluaran 816×1104 (rasio aspek ≈ 0,739, sekitar 900.000 piksel total).
- Sebagai contoh, gambar masukan berukuran 750×1000 (rasio aspek 3:4 = 0,75) dengan
-
Rekomendasi:
- Kontrol masukan: Untuk hasil terbaik, gunakan gambar frame pertama yang sudah memiliki rasio aspek target Anda.
- Pasca-pemrosesan: Jika Anda memerlukan rasio aspek ketat, potong video atau tambahkan bilah hitam menggunakan alat pengeditan setelah pembuatan.