Wan3.0
Generasi Video Wan3.0
- Model video referensi all-in-one Alibaba Cloud Wanxiang 3.0
- Teks-ke-video / frame pertama / frame pertama+terakhir / referensi multimodal / referensi file atau tautan
- Resolusi 480P / 720P / 1080P, durasi 2–30 detik
- Mendukung gambar, video, audio, dokumen, dan halaman web publik sebagai referensi
POST
Autentikasi
string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda dari Halaman Manajemen API Key:
Mode Generasi
Nama model ditetapkan kewan3.0-video. Mode dipilih melalui field permintaan:
Parameter Permintaan
Dasar
string
wajib
Nilai tetap:
wan3.0-videostring
Deskripsi teks. Wajib kecuali field media disediakan (setidaknya salah satu dari prompt atau media).
- Maks 20.000 karakter; kelebihan dipotong otomatis (tanpa error)
- Dalam mode referensi, gunakan “图N / 视频N / 音频N” untuk merujuk aset; indeks mengikuti urutan dalam setiap jenis media
string
default:"1080P"
Resolusi keluaran (tidak peka huruf besar/kecil)
480P720P1080P(default, harga tertinggi)
string
default:"adaptive"
Rasio aspek.
aspect_ratio juga diterima.adaptive(default)16:9/4:3/1:1/3:4/9:16
integer
default:"5"
Durasi dalam detik, 2–30, default
5Dengan input video referensi, total durasi video input +
duration keluaran harus ≤ 30 detik.boolean
default:"true"
Apakah keluaran menyertakan trek audio. Default
true. Harga sama dengan atau tanpa audio.integer
Seed acak di
[0, 2147483647]boolean
default:"false"
Apakah menambahkan watermark. Default
falsestring
Cara
image_urls tanpa peran eksplisit diklasifikasikan:frame— keluarga frame pertama/terakhirreference— keluarga referensi
Input media
string[]
Array URL gambar. Penugasan peran mengikuti aturan saling eksklusif.URL publik atau Base64 (
data:image/png;base64,...).object[]
Gambar dengan peran eksplisit. Setiap item:
url: alamat gambarrole:first_frame/last_frame/reference_image(alias umum diterima)
string[]
Video referensi, hingga 5 klip; masing-masing 1–15 d, total ≤ 15 d
string[]
Audio referensi, hingga 5 klip; masing-masing 1–15 d, total ≤ 15 d
string
Audio referensi tunggal (bentuk nilai tunggal dari
audio_urls)string
URL dokumen referensi, paling banyak 1. Tidak dapat digabungkan dengan
link_url.Format meliputi docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md, ≤100MB, ≤50 halaman.string
URL halaman web publik, paling banyak 1. Hanya halaman tanpa login. Tidak dapat digabungkan dengan
file_url.Saling Eksklusif Keluarga Media
Media termasuk salah satu dari dua keluarga dan tidak boleh digabung (divalidasi sebelum submit → 400, tanpa tugas, tanpa biaya):Cara image_urls tanpa peran ditetapkan
- Jika
generation_typedisetel → gunakan itu (frame/reference) - Jika tidak, dan permintaan sudah memiliki input keluarga referensi (
video_urls/audio_urls/audio_url/file_url/link_url) → perlakukan sebagaireference_image - Jika tidak → keluarga frame: item pertama
first_frame, kedualast_frame(sama sepertiwan2.7)
image_with_roles bila Anda membutuhkan kontrol eksplisit.
Batas dan format media
Contoh Permintaan
Teks-ke-video
Video frame pertama
Frame pertama + terakhir
image_with_roles:
Referensi multimodal
Denganvideo_urlshadir,image_urlstanpa peran otomatis diklasifikasikan sebagai gambar referensi; mengaturgeneration_type: "reference"lebih jelas.
Video referensi file
prompt boleh dihilangkan; generasi didorong oleh dokumen:
Video referensi halaman web
Penagihan
Per detik × resolusi (selaras dengan harga resmi). Audio on/off tidak mengubah harga:- Default adalah 1080P (paling mahal); kirim
480P/720Pbila sensitif biaya - Detik yang ditagih =
durationyang diminta audio: true/falsetidak memengaruhi harga
Batasan dan Catatan
Error Umum
Semua adalah 400 sinkron (tanpa tugas, tanpa biaya):Respons
integer
Kode status; 200 jika sukses
array
Array data respons
Kueri hasilGenerasi video bersifat asinkron. Poll Dapatkan Status Tugas atau
GET /v1/videos/generations/{task_id}.Interval yang direkomendasikan 5–10 detik; generasi biasanya memakan waktu 1–5 menit. Saat sukses, gunakan URL di result.videos.