Skip to main content
POST

Autentikasi

string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda dari Halaman Manajemen API Key:

Mode Generasi

Nama model ditetapkan ke wan3.0-video. Mode dipilih melalui field permintaan:

Parameter Permintaan

Dasar

string
wajib
Nilai tetap: wan3.0-video
string
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)
  • 480P
  • 720P
  • 1080P (default, harga tertinggi)
Menghilangkan resolution akan ditagih pada 1080P. Kirim 480P atau 720P secara eksplisit bila biaya penting.
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 5
duration: -1 (durasi cerdas) tidak didukung. Kirim bilangan bulat dari 2 hingga 30.
Dengan 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 false
string
Cara image_urls tanpa peran eksplisit diklasifikasikan:
  • frame — keluarga frame pertama/terakhir
  • reference — keluarga referensi
Jika dihilangkan, klasifikasi otomatis (lihat aturan saling eksklusif).

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 gambar
  • role: 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.
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

  1. Jika generation_type disetel → gunakan itu (frame / reference)
  2. Jika tidak, dan permintaan sudah memiliki input keluarga referensi (video_urls / audio_urls / audio_url / file_url / link_url) → perlakukan sebagai reference_image
  3. Jika tidak → keluarga frame: item pertama first_frame, kedua last_frame (sama seperti wan2.7)
Gunakan image_with_roles bila Anda membutuhkan kontrol eksplisit.

Batas dan format media

Contoh Permintaan

Teks-ke-video

Video frame pertama

Frame pertama + terakhir

Atau dengan image_with_roles:

Referensi multimodal

Dengan video_urls hadir, image_urls tanpa peran otomatis diklasifikasikan sebagai gambar referensi; mengatur generation_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 / 720P bila sensitif biaya
  • Detik yang ditagih = duration yang diminta
  • audio: true/false tidak 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.