Model text-to-video Wan menghasilkan video yang mulus dari text prompts .
Referensi: Panduan pengguna
Untuk memastikan pemanggilan berhasil, model, URL Endpoint, dan Kunci API harus berada di wilayah yang sama. Pemanggilan lintas-wilayah akan gagal.
Karena tugas text-to-video memerlukan waktu lama (biasanya 1 hingga 5 menit), API ini menggunakan pemanggilan asinkron. Seluruh proses mencakup dua langkah utama: Buat tugas → Polling hasil. Alurnya sebagai berikut:
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP, dan struktur parameter dienkapsulasi agar sesuai dengan fitur bahasa pemrograman.
Karena tugas text-to-video memerlukan waktu lama untuk diselesaikan (biasanya 1 hingga 5 menit), SDK mengenkapsulasi proses pemanggilan asinkron HTTP dan mendukung metode pemanggilan sinkron maupun asinkron.
Atur
Atur
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk penyelesaian.
J: Anda tidak dapat mengonversi tautan secara langsung. Prosedur yang benar adalah layanan backend Anda mengambil URL tersebut, mengunduh file videonya, lalu mengunggahnya ke layanan penyimpanan objek permanen, seperti Alibaba Cloud Object Storage Service (OSS), untuk menghasilkan tautan akses permanen baru.
J: Tidak. Anda sebaiknya tidak memutar tautan tersebut langsung di browser karena akan kedaluwarsa setelah 24 jam. Sebagai gantinya, Anda harus mengunduh dan menyimpan video tersebut, lalu menggunakan tautan permanen untuk pemutaran.
Ketersediaan
Untuk memastikan pemanggilan berhasil, model, URL Endpoint, dan Kunci API harus berada di wilayah yang sama. Pemanggilan lintas-wilayah akan gagal.
- Pilih model: Konfirmasi wilayah model tersebut.
- Pilih URL: Gunakan URL Endpoint regional yang sesuai. Didukung URL HTTP dan URL SDK DashScope.
- Konfigurasikan Kunci API: Pilih wilayah, dapatkan Kunci API, lalu konfigurasikan Kunci API sebagai Variabel lingkungan (fitur ini akan segera digabung ke dalam konfigurasi Kunci API).
- Instal SDK: Untuk melakukan pemanggilan menggunakan SDK, Anda harus menginstal SDK DashScope.
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.
HTTP
Karena tugas text-to-video memerlukan waktu lama (biasanya 1 hingga 5 menit), API ini menggunakan pemanggilan asinkron. Seluruh proses mencakup dua langkah utama: Buat tugas → Polling hasil. Alurnya sebagai berikut:
Langkah 1: Buat tugas dan dapatkan ID tugas
- Singapura
- Virginia
- Frankfurt
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisGanti {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 permintaanHeader permintaanContent-Typestring (Wajib)Tipe konten permintaan. Harus 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 enable.Body permintaanmodelstring (Wajib)Nama model yang akan digunakan. Untuk daftar model yang tersedia, lihat daftar model.Contoh: wan2.6-t2v.input object (Wajib)Berisi informasi input dasar, seperti prompt.
Properti prompt string (Wajib)Text prompt. Menggambarkan elemen dan karakteristik visual yang diinginkan dari video yang dihasilkan.Prompt dapat dalam bahasa Tiongkok atau Inggris. Panjang diukur dalam karakter, di mana setiap karakter Tiongkok atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas karakter akan dipotong secara otomatis. Batas panjang bervariasi berdasarkan versi model:
string (Opsional)Prompt yang menggambarkan konten yang harus dikecualikan dari video. Ini membantu memperhalus konten yang dihasilkan.Prompt dapat dalam bahasa Tiongkok atau Inggris. Panjang maksimum 500 karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.Contoh: resolusi rendah, error, kualitas terburuk, kualitas rendah, cacat, jari ekstra, proporsi buruk.audio_url string (Opsional)Model yang didukung: model seri wan2.6 dan wan2.5.URL file audio. Model akan menggunakan audio ini untuk menghasilkan video.Format input yang didukung:
object (Opsional)Parameter pemrosesan video, seperti mengatur resolusi video, mengaktifkan penulisan ulang prompt, dan menambahkan Watermark.
Properti size string (Opsional)Menentukan resolusi video yang dihasilkan dalam format lebar*tinggi. Nilai default dan nilai yang valid untuk parameter ini bergantung pada parameter model, seperti dijelaskan di bawah ini:
integer (Opsional)Durasi video yang dihasilkan dalam detik. Nilai yang valid untuk parameter ini bergantung pada parameter model:
boolean (Opsional)Menentukan apakah akan mengaktifkan penulisan ulang prompt. Saat diaktifkan, model secara cerdas menulis ulang prompt input. Ini secara signifikan meningkatkan kualitas video yang dihasilkan untuk prompt yang lebih pendek tetapi meningkatkan waktu eksekusi.
string (Opsional)Model yang didukung: model wan2.6.Menentukan jenis shot video yang dihasilkan, yaitu apakah video terdiri dari satu shot berkelanjutan atau beberapa shot yang berubah.Nilai yang valid:
"prompt_extend": true diatur.Prioritas parameter: shot_type > prompt. Misalnya, jika shot_type diatur ke "single", model menghasilkan video single-shot meskipun prompt berisi "generate a multi-shot video".watermark boolean (Opsional)Menentukan apakah akan menambahkan Watermark. Watermark ditempatkan di pojok kanan bawah video dengan teks tetap "AI Generated".
integer (Opsional)Bilangan acak seed harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dihasilkan. Seed tetap meningkatkan kemampuan reproduksi.Karena generasi model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
|
Parameter responsoutputobjectBerisi informasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringPengidentifikasi permintaan unik untuk pelacakan dan troubleshooting.code stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk menanyakan status dan hasil tugas. |
Langkah 2: Tanyakan hasil berdasarkan ID tugas
- Singapura
- Virginia
- Frankfurt
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Rekomendasi polling: Pembuatan video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang masuk akal, 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, kueri mengembalikan status tugas sebagaiUNKNOWN.
Parameter permintaanHeader permintaanAuthorizationstring (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Parameter path URLtask_idstring (Wajib)ID tugas. |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh pemanggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Parameter responsoutputobjectBerisi informasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri 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. Dikembalikan hanya saat task_status adalah SUCCEEDED.Berlaku selama 24 jam. Video dalam format MP4 dengan encoding H.264.orig_prompt stringPrompt input asli, sesuai dengan parameter permintaan prompt.actual_prompt stringSaat prompt_extend=true, sistem menulis ulang prompt input. Bidang ini mengembalikan prompt yang dioptimalkan yang digunakan untuk generasi.
stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.objectBerisi statistik tentang output. Informasi ini hanya diberikan untuk tugas yang berhasil.
Properti video_duration integerDikembalikan hanya saat menggunakan model wan2.5 dan versi sebelumnya. Digunakan untuk penagihan.Durasi video yang dihasilkan dalam detik. Nilai yang valid adalah 5 dan 10.duration floatDikembalikan hanya saat menggunakan model wan2.6. Digunakan untuk penagihan.Menunjukkan total durasi video, di mana duration = input_video_duration + output_video_duration.input_video_duration integerDikembalikan hanya saat menggunakan model wan2.6. Tetap 0.output_video_duration integerDikembalikan hanya saat menggunakan model wan2.6.Durasi video output dalam detik. Nilainya sama dengan nilai input.duration.SR integerDikembalikan hanya saat menggunakan model wan2.6. Tier resolusi video yang dihasilkan. Contoh: 720.size stringDikembalikan hanya saat menggunakan model wan2.6. Resolusi video yang dihasilkan. Formatnya "lebartinggi". Contoh: 19201080.video_ratio stringDikembalikan hanya saat menggunakan model wan2.5 dan versi sebelumnya. Resolusi video yang dihasilkan. Formatnya "lebartinggi". Contoh: 832480.video_count integerJumlah video yang dihasilkan. 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. |
DashScope SDK
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP, dan struktur parameter dienkapsulasi agar sesuai dengan fitur bahasa pemrograman.
Karena tugas text-to-video memerlukan waktu lama untuk diselesaikan (biasanya 1 hingga 5 menit), SDK mengenkapsulasi proses pemanggilan asinkron HTTP dan mendukung metode pemanggilan sinkron maupun asinkron.
Waktu pemrosesan aktual bergantung pada jumlah tugas dalam antrian dan status layanan. Tunggu hasilnya.
Python
Atur dashscope.base_http_api_url berdasarkan wilayah tempat model berada:
- Singapura
- Virginia
- Beijing
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Pemanggilan sinkron
- Pemanggilan asinkron
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Segera unduh.
Java
Atur Constants.baseHttpApiUrl berdasarkan wilayah tempat model berada:
- Singapura
- Virginia
- Beijing
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Pemanggilan sinkron
- Pemanggilan asinkron
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Segera unduh.
Kode kesalahan
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk penyelesaian.
FAQ
T: Bagaimana cara mengonversi tautan video sementara menjadi tautan permanen?
J: Anda tidak dapat mengonversi tautan secara langsung. Prosedur yang benar adalah layanan backend Anda mengambil URL tersebut, mengunduh file videonya, lalu mengunggahnya ke layanan penyimpanan objek permanen, seperti Alibaba Cloud Object Storage Service (OSS), untuk menghasilkan tautan akses permanen baru.
Kode contoh: Unduh video ke perangkat lokal
Kode contoh: Unduh video ke perangkat lokal