API Video Wan 3.0
Parameter, kombinasi media, tugas asinkron, unduhan, dan penagihan per detik untuk wan3.0-video di APIMaster.
API Video Wan 3.0
wan3.0-video adalah model Wan 3 standar; ini merupakan model terpisah dari wan3.0-video-prime. Model ini mendukung teks, gambar, video, audio, dokumen, dan halaman web publik. Setiap tugas yang berhasil menghasilkan satu video MP4/H.264, hingga 30 detik. Integrasi ditinjau: 2026-11-17.
Setiap permintaan menerima maksimal 20 item media secara total. Video dihasilkan pada 30 fps.
Endpoint dan Autentikasi
| Operasi | Endpoint |
|---|---|
| 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 |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Semua parameter permintaan
Pilih satu format media per permintaan. Gunakan metadata.input.media untuk gabungan media referensi atau dokumen.
| Parameter | Tipe | Wajib / default | Arti dan nilai yang valid |
|---|---|---|---|
model |
string | Wajib | Harus tepat wan3.0-video; jangan menggantinya dengan Prime |
prompt |
string | Wajib | Jelaskan hasilnya dalam bahasa Mandarin atau Inggris; batas resmi 20.000 karakter, teks native yang lebih panjang akan dipotong. Rujuk Image 1, Video 1, Audio 1 sesuai urutan media; setiap jenis media memiliki penomoran sendiri |
duration |
integer | 5 |
2–30 detik keluaran; -1 membiarkan model memilih durasi. Dengan video referensi, durasi input ditambah output tidak boleh melebihi 30 detik |
seconds |
string | Opsional | Alias durasi, misalnya "5" atau "-1"; harus cocok dengan duration jika keduanya diberikan |
resolution |
string | 1080P |
480P, 720P, 1080P; nilai tingkat atas huruf kecil akan dinormalisasi |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Opsional | Alias untuk aspect_ratio; adaptive direkomendasikan untuk perpanjangan video |
size |
string | Opsional | Alias kompatibilitas: tingkat resolusi, atau pemetaan piksel yang didukung seperti 1280x720; utamakan resolution dan ratio yang eksplisit, bukan ukuran piksel sembarang |
generate_audio |
boolean | true di sisi upstream |
Apakah keluaran memiliki trek audio. false yang eksplisit tetap dipertahankan. Audio tidak mengubah tarif per detik |
audio |
boolean | Opsional | Alias untuk generate_audio; gunakan salah satu sakelar audio |
prompt_extend |
boolean | true |
Penulisan ulang prompt secara cerdas; false yang eksplisit tetap dipertahankan. Harus true untuk input dokumen/halaman |
watermark |
boolean | false di sisi upstream |
Menambahkan tanda air pada keluaran; false yang eksplisit tetap dipertahankan |
seed |
integer | Acak | -1 atau 0–2147483647. Menghilangkan atau -1 meminta seed acak; 0 diteruskan. Seed yang berulang tidak menjamin keluaran identik |
input_reference |
string | Opsional | URL gambar frame pertama; menggantikan array media native. Jangan mencampur gaya input |
images |
string[] | Opsional | Array praktis yang ditambahkan sebagai item reference_image ketika input_reference tidak ada |
metadata |
object | Opsional | Wadah untuk objek native di bawah ini; tidak dapat mengubah model yang dipilih |
metadata.input |
object | Opsional | Objek input native |
metadata.input.prompt |
string | Opsional | Penggantian prompt native; pertahankan prompt tingkat atas yang wajib |
metadata.input.media |
object[] | Opsional | Array media berurutan. Setiap item memerlukan type dan url; lihat batasan di bawah |
metadata.input.media[].type |
string | Wajib per item | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Wajib per item | URL media HTTP(S) publik; jenis gambar juga menerima string data:{MIME_type};base64,.... Media non-gambar memerlukan URL publik |
metadata.parameters |
object | Opsional | Objek parameter native; tidak boleh null |
metadata.parameters.resolution |
string | 1080P |
480P, 720P, 1080P huruf besar |
metadata.parameters.ratio |
string | adaptive |
Nilai rasio aspek yang sama seperti yang tercantum di atas |
metadata.parameters.duration |
integer | 5 |
2–30, atau -1; batasan durasi gabungan yang sama |
metadata.parameters.audio |
boolean | true di sisi upstream |
Sakelar audio keluaran yang sama |
metadata.parameters.prompt_extend |
boolean | true |
Sakelar penulisan ulang prompt yang sama; file/link memerlukan true |
metadata.parameters.watermark |
boolean | false di sisi upstream |
Sakelar tanda air yang sama |
metadata.parameters.seed |
integer | Acak | Rentang seed yang sama, termasuk 0 yang eksplisit |
Field native negative_prompt, img_url, first_frame_url, last_frame_url, dan audio_url bukan kontrol media Wan 3. Gunakan array media yang didokumentasikan sebagai gantinya.
Batas media dan kombinasi yang valid
| Jenis media | Jumlah dan batasan |
|---|---|
first_frame, last_frame |
Paling banyak satu untuk masing-masing. Frame terakhir memerlukan frame pertama. Kontrol frame tidak dapat digabungkan dengan jenis referensi, file, atau tautan apa pun |
reference_image |
Paling banyak 10. JPEG/JPG, PNG tanpa transparansi, BMP, atau WEBP; setiap sisi 240–8,000 piksel, rasio aspek paling banyak 8:1, setiap file paling banyak 20 MB |
reference_video |
Paling banyak 5 klip MP4/MOV; masing-masing 1–15 detik, gabungan input paling banyak 15 detik; minimal 16 fps; setiap sisi 240–4,096 piksel, rasio aspek paling banyak 8:1, setiap file paling banyak 100 MB |
reference_audio |
Paling banyak 5 klip WAV/MP3; masing-masing 1–15 detik, gabungan paling banyak 15 detik; setiap file paling banyak 15 MB |
file |
Paling banyak satu file DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; paling banyak 100 MB. Dokumen berhalaman PDF, DOCX, DOC, PPTX, PPT, dan KEY/PAGES memiliki batas 50 halaman |
link |
Paling banyak satu halaman yang dapat diakses publik tanpa login; jangan digabungkan dengan file |
Gambar, video, dan audio referensi dapat digabungkan. File atau tautan dapat menyertai media referensi. Mode frame pertama/terakhir hanya menerima kontrol frame; gunakan mode gambar referensi plus audio referensi untuk pembuatan yang dipandu audio. Penguraian media dan moderasi konten tetap tunduk pada pemeriksaan upstream.
Teks-ke-video menggunakan prompt tanpa media. Animasi frame pertama menggunakan first_frame; transisi menggunakan first_frame plus last_frame. Pembuatan referensi menggunakan jenis referensi. Untuk pengeditan atau perluasan, berikan reference_video dan jelaskan pengeditan atau perluasan dalam prompt; gunakan adaptive untuk perluasan.
Contoh
Teks-ke-video
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Frame pertama dan terakhir
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
Gambar dan audio referensi
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm 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"}]}}}
Pengeditan / perpanjangan video dan durasi pintar
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Dokumen / halaman web
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Ganti semua URL contoh dengan media publik yang nyata. Untuk input web, ganti item file dengan {"type":"link","url":"https://example.com/product"}. Contoh frame pertama juga berfungsi tanpa item frame terakhirnya.
Respons, polling, unduhan, dan log
Pembuatan mengembalikan ID tugas APIMaster, bukan ID upstream:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Kolom respons | Arti |
|---|---|
id / task_id |
Pengenal tugas platform yang digunakan oleh kueri dan unduhan |
status |
queued, in_progress, completed, failed |
progress |
Indikator progres; tunggu status terminal |
error.code, error.message |
Informasi kegagalan jika berlaku |
metadata.url |
Lokasi konten saat dikembalikan setelah selesai |
Lakukan polling kira-kira setiap 15 detik menggunakan API key yang sama. Jangan membuat tugas lain untuk memeriksa progres. ID tugas dan URL keluaran dari penyedia native kedaluwarsa setelah 24 jam; segera unduh dan simpan hasil yang berhasil. Endpoint konten APIMaster yang terautentikasi lebih diutamakan daripada menyimpan URL upstream sementara.
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 wan3.mp4
Log penggunaan memuat tugas dan hasil video yang berhasil. Periksa tagihan akhir setelah selesai; penerimaan bukan bukti keberhasilan pembuatan. Polling berulang tidak menimbulkan biaya pembuatan tambahan.
Penagihan
Lihat tarif per detik di kartu model.
APIMaster menjumlahkan durasi semua video masukan dan video keluaran, membulatkan total sekali ke detik bulat berikutnya, lalu mengalikannya dengan tarif per detik untuk resolusi keluaran yang dipilih. Masukan 2,3 detik dan keluaran 5 detik ditagih sebagai 8 detik. Tanpa video masukan, hanya durasi keluaran yang ditagih. Permintaan tidak memerlukan penawaran harga atau kolom durasi masukan. Jika pembuatan gagal, dana yang ditahan dikembalikan. Lihat tagihan akhir di log penggunaan.
Kesalahan dan koreksi
| Gejala | Koreksi |
|---|---|
| Durasi/resolusi/rasio tidak valid | Gunakan enum dan rentang di atas; durasi pintar tepatnya -1 |
| Konflik frame/referensi, frame terakhir tanpa frame pertama | Ikuti aturan kombinasi |
| File/tautan disertai penulisan ulang yang dinonaktifkan | Setel prompt_extend:true |
| Kegagalan pengambilan/format/durasi media | Gunakan file publik yang memenuhi setiap batasan ukuran, format, dan durasi |
| Prompt tidak ada | Pertahankan prompt tingkat atas yang tidak kosong untuk API APIMaster |
| Tugas gagal atau dimoderasi | Periksa error, lalu perbaiki permintaan; jangan menganggap penerimaan sebagai keberhasilan |
