API Video Prime Wan 3.0

Gunakan wan3.0-video-prime melalui API video asinkron APIMaster. Integrasi saat ini menyediakan 480P / 720P / 1080P, 2–30 detik bilangan bulat, dan satu video per tugas. Tinjauan parameter dan integrasi: 2026-10-26.

Endpoint dan autentikasi

Operasi	Metode dan URL
Buat	POST https://apimaster.ai/v1/videos
Kueri	GET https://apimaster.ai/v1/videos/{task_id}
Unduh	GET https://apimaster.ai/v1/videos/{task_id}/content

Gunakan Authorization: Bearer YOUR_API_KEY pada setiap permintaan dan Content-Type: application/json saat membuat tugas. Gunakan kunci API APIMaster, bukan kunci Alibaba Cloud. APIMaster menyediakan header asinkron upstream; Anda tidak memerlukan X-DashScope-Async.

Endpoint pembuatan yang kompatibel /videos/generations mengembalikan envelope respons yang berbeda; contoh di bawah secara konsisten menggunakan /videos.

Kemampuan rute saat ini

Dua integrasi saat ini melayani model ini: rute native Alibaba Cloud dan rute GMI. Bidang lanjutan memerlukan rute yang sesuai; mengirimkan suatu bidang tidak memilih rute tersebut. Pastikan rute mana yang dapat diakses kunci API Anda sebelum menggunakan contoh khusus rute.

Kemampuan	Native Alibaba Cloud	GMI
Teks-ke-video, frame pertama, frame pertama/terakhir, gambar referensi	Terintegrasi	Terintegrasi, dengan bidang media berbeda
Audio referensi	metadata.input.media	audio_url
Dokumen / halaman web publik	Bidang media native diteruskan; tidak tercakup oleh pemeriksaan pembuatan yang selesai	Tidak didukung
Video referensi, penyuntingan, ekstensi	Diblokir sebelum pengiriman	Tidak didukung
Durasi otomatis -1	Diblokir	Diblokir
Rasio aspek 21:9	Diterima	Ditolak
Sakelar audio eksplisit	generate_audio / audio	Tidak didukung; hilangkan bidang ini
Menonaktifkan penulisan ulang prompt / seed tetap 0	Serialisasi saat ini tidak mempertahankan prompt_extend: false atau seed: 0; jangan mengandalkannya	false dan 0 eksplisit dipertahankan

Video senyap 720P 5 detik pada rute native selesai, diunduh, dan didekode dengan berhasil dalam pemeriksaan penerimaan 2026-10-24. Kombinasi media lain dijelaskan berdasarkan adapter dan kontrak resmi, bukan disajikan sebagai kombinasi yang telah diuji pembuatannya. Ketersediaan dan harga rute dapat berubah; lihat kartu model.

Parameter permintaan umum lengkap

Kirim bidang-bidang ini di tingkat atas. Untuk kompatibilitas terluas, gunakan duration, resolution, dan aspect_ratio eksplisit, prompt tidak kosong maksimal 5.000 karakter, serta hilangkan opsi khusus rute.

Bidang	Tipe	Wajib / default	Perilaku APIMaster
model	string	Wajib	Tepat wan3.0-video-prime
prompt	string	Wajib pada kedua rute	Tidak boleh kosong, termasuk pembuatan gambar. GMI memvalidasi 1–5.000 karakter; adapter native memerlukan teks tidak kosong. Batas native resmi adalah 20.000; hindari mengandalkan batas yang lebih tinggi tersebut di seluruh rute
duration	integer	5	2–30 detik; tidak ada -1, pecahan, atau durasi otomatis
seconds	string	Opsional	Alias string, mis. "5"; harus sesuai dengan duration bila keduanya diberikan
resolution	string	720P	480P, 720P, 1080P; nilai huruf kecil di tingkat atas dinormalisasi. Default APIMaster ini berbeda dari default native resmi
aspect_ratio	string	16:9	Nilai umum: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 hanya pada rute native
ratio	string	Opsional	Alias aspect_ratio; gunakan satu bidang dan jangan kirim nilai yang bertentangan
size	string	Opsional	Alias dimensi seperti 1280x720; validasi khusus rute berlaku. Utamakan resolution dan aspect_ratio. GMI mengharuskan sisi yang lebih pendek sesuai dengan tingkat resolusi; native hanya menerima pemetaan dimensi yang didukungnya
input_reference	string	Opsional	URL gambar frame pertama. Gunakan URL HTTP(S) yang dapat diunduh publik untuk kompatibilitas lintas rute; jangan digabungkan dengan input frame pertama lainnya
prompt_extend	boolean	Native true; GMI membiarkan default penyedia bila dihilangkan	Penulisan ulang prompt. Native saat ini tidak dapat menonaktifkannya secara andal dengan false; GMI meneruskan boolean eksplisit
watermark	boolean	Default native resmi false; GMI membiarkan default penyedia bila dihilangkan	Sakelar tanda air
seed	integer	Acak bila dihilangkan	Rentang tetap portabel: 1–2147483647. Native juga menerima -1 untuk acak; native 0 dihilangkan selama serialisasi. GMI menerima 0–2147483647 dan menolak -1. Seed tetap tidak menjamin output identik

Alias dimensi native adalah 832x480, 480x832, 1280x720, 720x1280, 1920x1080, dan 1080x1920 untuk kasus lanskap/potret biasa. Beberapa pemetaan dimensi persegi direduksi menjadi 1:1; dimensi lain yang dipetakan mungkin masih gagal validasi rasio aspek. Jangan gunakan size untuk meminta dimensi arbitrer.

Tabel parameter khusus rute

Bidang GMI

Bidang-bidang ini berada di tingkat atas sebagai tambahan dari tabel umum. Adapter GMI menolak bidang yang tidak dikenali, termasuk metadata, images, image_urls, audio, generate_audio, video_urls, dan reference_video.

Bidang	Tipe	Wajib / default	Perilaku
negative_prompt	string	Opsional	Maksimal 500 karakter
first_frame	string	Opsional	URL gambar HTTP(S) publik; alternatif untuk input_reference
last_frame	string	Opsional	URL gambar frame akhir HTTP(S) publik; sertakan juga frame pertama
reference_image	string atau string[]	Opsional	1–10 URL gambar referensi HTTP(S) publik; gunakan array untuk beberapa gambar
audio_url	string	Opsional	URL audio referensi HTTP(S) publik; tunduk pada validasi media penyedia

Gunakan salah satu kontrol frame atau gambar referensi dalam satu permintaan. metadata.input.media native tidak diterjemahkan ke bidang-bidang ini pada GMI.

Bidang native Alibaba Cloud

Input terstruktur native berada di dalam metadata. Mengirim objek resmi input atau parameters secara langsung di tingkat atas bukanlah kontrak APIMaster. Selalu pertahankan prompt wajib di tingkat atas.

Bidang	Tipe	Wajib / default	Perilaku
generate_audio	boolean	Default native resmi true	Apakah output berisi trek audio; false dipertahankan
audio	boolean	Opsional	Alias generate_audio; berikan hanya satu
images	string[]	Opsional	Dikonversi menjadi entri media reference_image; ini bukan frame pertama/terakhir yang berurutan. Jangan digabungkan dengan input_reference
metadata	object	Opsional	Membungkus input dan parameters native; tidak dapat mengubah model
metadata.input	object	Opsional	Wadah input native
metadata.input.prompt	string	Opsional	Penimpaan prompt native; utamakan prompt tingkat atas saja
metadata.input.media	object[]	Opsional	Koleksi media native, dengan type dan url pada setiap item
metadata.input.media[].type	string	Wajib per item	first_frame, last_frame, reference_image, reference_audio, file, link; reference_video saat ini ditolak
metadata.input.media[].url	string	Wajib per item	Lokasi media; URL HTTP(S) publik direkomendasikan. URL sementara OSS resmi memerlukan konteks unggahan upstream yang valid secara terpisah; APIMaster tidak menyediakan konteks unggahan tersebut
metadata.parameters	object	Opsional	Wadah parameter native; tidak boleh null
metadata.parameters.resolution	string	720P	480P, 720P, 1080P huruf besar
metadata.parameters.ratio	string	16:9	Rasio aspek native termasuk adaptive dan 21:9
metadata.parameters.duration	integer	5	2–30; tidak ada -1
metadata.parameters.audio	boolean	Default native resmi true	Sakelar audio output
metadata.parameters.prompt_extend	boolean	true	Harus tetap true untuk file / link; false eksplisit memiliki batasan serialisasi di atas
metadata.parameters.watermark	boolean	Default native resmi false	Sakelar tanda air
metadata.parameters.seed	integer	Acak	-1 atau 0–2147483647; 0 memiliki batasan serialisasi di atas

Opsi native tingkat atas menimpa parameter metadata yang sesuai. input_reference tingkat atas menggantikan array media native; images menambahkan entri gambar referensi bila input_reference tidak ada. Gunakan satu gaya input dan satu gaya parameter untuk menghindari penimpaan yang tidak disengaja. Jangan gunakan img_url, first_frame_url, last_frame_url, atau audio_url lama di dalam input native; adapter menolak bidang media lama tersebut untuk Wan 3.0.

Batasan media

Aturan media native resmi di bawah ini juga menjelaskan validasi di sisi penyedia; adapter yang menerima URL tidak membuktikan bahwa media tersebut valid.

Media	Batas / catatan integrasi
Frame pertama / terakhir	Maksimal satu masing-masing; frame terakhir memerlukan frame pertama. Jangan mencampur kontrol frame dengan reference_image
Gambar referensi	Maksimal 10; JPEG/JPG, PNG tanpa transparansi, BMP, atau WEBP; setiap sisi 240–8.000 px, rasio aspek maksimal 8:1, maksimal 20 MB per gambar
Audio referensi	Native: maksimal 5, WAV/MP3, masing-masing 1–15 detik, gabungan maksimal 15 detik, maksimal 15 MB per file. GMI mengekspos satu audio_url
File / halaman web	Hanya native: maksimal satu file atau satu halaman yang dapat dibaca publik; jangan gabungkan file dan link. Format file resmi: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD; maksimal 100 MB, dengan batas 50 halaman untuk format berhalaman yang berlaku. Pertahankan prompt_extend: true
Video referensi	Tersedia secara resmi, tetapi saat ini diblokir oleh validasi penagihan native APIMaster; tidak diekspos pada GMI. Jangan gunakan contoh penyuntingan atau ekstensi video dari API resmi di sini

Batas atas media gabungan native resmi adalah 20 item; batas individual dan kombinasi tetap berlaku. URL data Base64 gambar adalah bagian dari format input native resmi, tetapi tidak diterima oleh validasi URL GMI. Utamakan URL HTTP(S) yang dapat diunduh di seluruh rute.

Contoh

Teks-ke-video, bidang umum

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

Frame pertama, bidang umum

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

Frame pertama / terakhir GMI

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Frame pertama / terakhir native dan output senyap

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Gambar referensi dan audio native

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Ganti URL media contoh dengan file publik yang nyata. Contoh khusus rute memerlukan rute yang sesuai dan tetap tunduk pada pemeriksaan kombinasi upstream.

Respons, polling, dan pengunduhan

Pembuatan mengembalikan ID tugas APIMaster, misalnya:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

Bidang	Makna
id / task_id	Pengenal tugas APIMaster, bukan pengenal tugas upstream
status	queued, in_progress, completed, failed
progress	Progres yang dilaporkan; bukan jaminan penyelesaian
error.code / error.message	Detail kegagalan bila berlaku
metadata.url	Alamat konten terautentikasi saat dikembalikan pada penyelesaian

Lakukan polling setiap 10–20 detik dengan kunci API yang sama hingga status terminal; keberhasilan pembuatan hanya berarti diterima. Pembuatan dapat memakan beberapa menit. Lakukan polling pada tugas yang telah diterima alih-alih berulang kali membuat tugas berbayar.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Unduh dan simpan video yang selesai dengan segera; URL hasil upstream dapat kedaluwarsa. Polling berulang tidak membuat biaya pembuatan lain.

Penagihan dan kesalahan umum

Penagihan dilakukan per detik pada resolusi yang diminta, dengan harga rute/akun ditampilkan pada kartu model. Pengiriman memesan perkiraan biaya. Penyelesaian native menggunakan durasi tertagih yang dikembalikan dan harga pengiriman yang dibekukan; GMI mengikuti kontrak durasi yang dipesan. Tugas yang gagal melepaskan/mengembalikan reservasi pembuatannya. Audio mati tidak berarti tier yang lebih murah. Gunakan log penggunaan untuk jumlah akhir.

Kesalahan / gejala	Tindakan
duration must be an integer from 2 to 30	Gunakan bilangan bulat eksplisit; -1 tidak terintegrasi
unsupported Wan request field ...	Hapus bidang yang tidak didukung oleh GMI atau konfirmasi akses ke rute native yang sesuai
unsupported aspect ratio	Gunakan rasio umum; 21:9 memerlukan perutean native
reference video requires an input-duration quote	Hapus video referensi; kemampuan ini saat ini diblokir
prompt is required / media fetch failure	Tambahkan teks tingkat atas; gunakan media valid yang dapat diunduh publik
prompt_extend: false atau seed: 0 tidak berpengaruh pada native	Batasan serialisasi saat ini; gunakan seed positif dan jangan bergantung pada penonaktifan penulisan ulang

Sumber: informasi model resmi, referensi API native resmi, dan panduan penggunaan resmi. Kemampuan resmi tidak berarti bidang yang sama diekspos pada setiap rute APIMaster.