APIMaster.ai

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