Cara Memulai dengan Wan 2.5 Preview

Wan 2.5 Preview adalah alat pembuatan video dari Alibaba yang mengubah deskripsi teks atau gambar menjadi klip sinematik pendek dengan audio tersinkron. Ia mendukung dua mode: text-to-video (T2V) dan image-to-video (I2V). Model berperforma tinggi lainnya seperti Kling V3 menawarkan kemampuan sinematik serupa. Fitur utamanya meliputi pembuatan audio-visual sekali jalan, sinkronisasi bibir yang presisi, dan keluaran hingga 1080p pada 24fps untuk video berdurasi 5 atau 10 detik. Integrasi dipermudah melalui APIMart, sebuah platform yang menawarkan API terpadu untuk akses yang mulus. Harga mulai dari $0.0336/detik untuk 480p. Berikut hal-hal yang perlu Anda ketahui untuk memulai:

• Mode: T2V untuk membuat video dari prompt teks, I2V untuk menambahkan gerakan pada gambar.
• Kualitas: Keluaran dalam 480p, 720p, atau 1080p dengan audio stereo 48kHz.
• Harga: Bayar sesuai pemakaian, ditagih per detik video yang dihasilkan.
• Penyiapan: Bekerja dengan Python atau Node.js menggunakan REST API. Membutuhkan kunci API dari APIMart.
• Alur kerja: Kirim permintaan, dapatkan task ID, dan lakukan polling untuk hasilnya.

Mulailah dengan klip 480p berdurasi 5 detik untuk menguji penyiapan Anda. Setelah nyaman, tingkatkan ke 1080p untuk render akhir. Gunakan prompt yang detail untuk hasil yang lebih baik, dan sertakan instruksi audio untuk suara yang tersinkron.

Panduan ini mencakup semuanya, mulai dari menyiapkan lingkungan Anda hingga menyusun prompt dan mengelola biaya secara efektif.

Poin Utama

• Wan 2.5 Preview adalah model pembuatan video dari Alibaba yang mengubah teks atau gambar menjadi klip 5 atau 10 detik hingga 1080p pada 24fps dengan audio stereo 48kHz yang tersinkron.
• Penyiapan menggunakan panggilan REST biasa ke https://api.apimart.ai dengan API key Bearer dari APIMart; error 401 berarti key salah dan 402 berarti saldo tidak cukup.
• Permintaan ke wan2.5-preview (tambahkan image_urls untuk image-to-video) mengembalikan task_id yang Anda polling hingga statusnya completed; pembuatan memakan waktu 1–5 menit, dan APIMart menyimpan hasilnya selama 72 jam (lihat expires_at).
• Prompt 80 hingga 120 kata dengan istilah kamera, dialog dalam tanda kutip, dan petunjuk suara memberi hasil terbaik; prompt_extend memperluas prompt pendek dan audio_url kustom (.wav/.mp3, maks 15 MB) didukung.
• Harga mulai $0,0336/detik untuk 480p; buat draf 480p 5 detik (43 kredit), lalu render 1080p dengan 128 kredit untuk 5 detik atau 255 kredit untuk 10 detik.
• Gambar sumber untuk I2V harus berukuran 360 hingga 2.000 piksel per sisi dan di bawah 10 MB, dan rasio aspek output mengikuti gambar sumber.

Sekilas Wan 2.5 Preview

Menyiapkan Lingkungan Anda

Prasyarat Developer

Sebelum menyelami kode, penting untuk memahami beberapa dasar. Anda sebaiknya memiliki pemahaman yang baik tentang REST API dan format JSON, karena semua interaksi dengan Wan 2.5 mengandalkan standar ini. Baik Anda lebih suka Python 3.x atau Node.js (v14+), keduanya akan bekerja untuk penyiapan ini.

Konsep penting lain yang perlu dipahami adalah alur kerja asinkron. Wan 2.5 tidak langsung memberikan video jadi. Sebaliknya, ia menyediakan task_id yang perlu Anda pantau. Anda harus membuat loop polling untuk memeriksa status tugas hingga statusnya berubah menjadi "completed". Setelah siap, kunjungi APIMart untuk membuat akun dan mendapatkan kunci API Anda.

Membuat Akun APIMart dan Kunci API

Mulailah dengan mengunjungi apimart.ai untuk menyiapkan akun gratis. Setelah masuk, buka bagian API Key Management di Console Dashboard Anda untuk menghasilkan kunci API. Pastikan untuk menyalin dan menyimpan kunci Anda dengan aman segera - kunci hanya ditampilkan satu kali.

APIMart menggunakan model bayar sesuai pemakaian, jadi Anda perlu mengisi saldo akun sebelum membuat permintaan. Jika Anda menemui error 402, itu berarti saldo akun Anda terlalu rendah. Sementara error 401 menunjukkan masalah dengan kunci API Anda. Periksa kembali kredensial Anda dan pastikan akun Anda memiliki dana yang cukup.

Mengonfigurasi Lingkungan Pengembangan Anda

Setelah API key siap, menyiapkan lingkungan Anda cukup mudah. Contoh dalam panduan ini memanggil REST API secara langsung:

• Untuk Python: Jalankan pip install requests
• Untuk Node.js 18+: Gunakan fetch bawaan; tidak perlu paket tambahan

Semua permintaan dikirim ke base URL:

https://api.apimart.ai

Autentikasi permintaan Anda dengan menyertakan kunci API sebagai Bearer token di header, seperti ini:

Authorization: Bearer YOUR_API_KEY

Untuk keamanan tambahan, hindari menuliskan kunci API secara langsung ke dalam skrip Anda. Sebagai gantinya, simpan di dalam variabel lingkungan. Menggunakan file .env selama pengembangan lokal adalah praktik yang baik untuk menjaga kredensial Anda tetap aman dan di luar version control. Setelah lingkungan Anda dikonfigurasi, Anda dapat melanjutkan ke pembuatan permintaan API pertama Anda.

Membuat Permintaan API Pertama Anda

Contoh Permintaan Text-to-Video

Setelah Anda siap, Anda dapat langsung membuat permintaan API pertama Anda! Seperti disebutkan sebelumnya, permintaan ini bersifat asinkron, artinya Anda perlu menunggu tugas selesai sebelum mendapatkan hasilnya.

Berikut contoh Python sederhana untuk mulai menghasilkan keluaran text-to-video:

import os
import time

import requests

API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}

resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json={
    "model": "wan2.5-preview",
    "prompt": "A golden retriever runs along a sunlit beach, waves crashing in slow motion",
    "negative_prompt": "low quality, blurry, distorted",
    "duration": 5,          # 5 or 10
    "resolution": "720p",   # 480p / 720p / 1080p
    "size": "16:9",
    "prompt_extend": True,
}, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
print(f"Task started: {task_id}")

Field wajibnya adalah model dan prompt. Parameter lain membantu menyempurnakan hasil: negative_prompt berisi hal yang harus dihindari, duration bernilai 5 atau 10 detik, dan resolution bernilai 480p, 720p, atau 1080p. Jika prompt Anda pendek, menyetel prompt_extend ke true membuat model memperluasnya menjadi deskripsi yang lebih detail dan sinematik. Untuk text-to-video, size menerima rasio aspek seperti 16:9, 9:16, atau 1:1.

Setelah mengirim permintaan, Anda akan menerima task_id. Gunakan ID ini untuk melakukan polling GET /v1/tasks/{task_id} hingga status tugas menjadi completed:

while True:
    task = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30).json()["data"]
    if task["status"] == "completed":
        print(f"Video ready: {task['result']['videos'][0]['url'][0]}")
        break
    if task["status"] in ("failed", "cancelled"):
        raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
    time.sleep(10)

Pembuatan video biasanya memakan waktu 1–5 menit. APIMart menyimpan hasilnya selama 72 jam (waktu pastinya ada di expires_at), jadi segera unduh video dan pindahkan ke penyimpanan Anda sendiri.

Berikutnya, mari kita lihat cara menghasilkan video dari gambar menggunakan pendekatan serupa. Anda juga dapat menjelajahi model lain seperti Grok Imagine Video untuk gaya sinematik yang berbeda.

Contoh Permintaan Image-to-Video

Proses image-to-video (I2V) memakai endpoint dan model wan2.5-preview yang sama, dengan dua perbedaan: Anda mengirim gambar sumber di image_urls, dan tidak mengirim size, karena output mengikuti rasio aspek gambar.

Berikut contohnya:

resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json={
    "model": "wan2.5-preview",
    "prompt": "The character slowly turns their head and smiles at the camera",
    "image_urls": ["https://your-storage.com/character-portrait.jpg"],
    "duration": 5,
    "resolution": "720p",
    "negative_prompt": "blurry, artifacts",
    # No size for image-to-video: the output follows the source image
}, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]

Untuk I2V, prompt sebaiknya mendeskripsikan gerakan atau perubahan relatif terhadap gambar awal - seperti pergerakan karakter atau aksi kamera. Rasio aspek akan mengikuti gambar sumber Anda, jadi pastikan gambar dipotong sesuai rasio yang diinginkan (mis. 16:9, 9:16, 1:1) sebelum dikirim. Gambar sumber sebaiknya berukuran antara 360 dan 2.000 piksel di setiap sisi dan tidak lebih besar dari 10 MB.

Sama seperti text-to-video, ambil task_id dari respons dan gunakan logika polling yang sama untuk melacak status tugas hingga selesai.

Sekarang, mari kita uraikan struktur respons API untuk memahami arti setiap field.

Memahami Respons API

Saat permintaan POST berhasil, API mengembalikan ID tugas di data[0].task_id. Query GET /v1/tasks/{task_id} mengembalikan objek data dengan field berikut:

Kode status HTTP 200 dan task_id berarti permintaan Anda diterima. Jika tugas berakhir dengan failed, periksa error.message untuk detailnya, misalnya parameter yang tidak didukung atau prompt yang terlalu panjang.

Wan 2.5 (the Veo 3 Killer) is NOW in n8n (full tutorial & template)

Mengoptimalkan Prompt dan Konfigurasi

Setelah lingkungan Anda disiapkan dan Anda telah membuat permintaan API awal (atau menjelajahi Wan 2.6 API yang lebih baru), menyempurnakan prompt Anda dapat sangat meningkatkan kualitas keluaran video.

Menulis Prompt Teks dan Gambar yang Baik

Hasil yang Anda peroleh sangat bergantung pada seberapa baik Anda menyusun prompt. Untuk Wan 2.5, prompt sepanjang 80 hingga 120 kata bekerja paling baik - cukup panjang untuk memberikan panduan yang jelas tetapi tidak terlalu panjang sehingga membingungkan model.

Berikut struktur yang berguna untuk diikuti: mulailah dengan subjek atau adegan, lalu tambahkan pergerakan kamera, detail gerakan, dan gaya visual. Misalnya, alih-alih mengatakan "seorang wanita berjalan di kota," Anda dapat menulis: "Seorang wanita bermantel merah berjalan cepat menyusuri jalanan Manhattan yang basah oleh hujan saat senja. Dolly in perlahan. Genangan air memantulkan tanda neon. Gradasi warna teal-dan-oranye, bokeh anamorfik, pencahayaan senja volumetrik." Tingkat detail ini memberi model instruksi yang jelas tentang suasana, komposisi, dan gerakan.

Untuk mengontrol kamera, gunakan istilah sinematografi standar seperti Pan left/right, Tilt up/down, Dolly in/out, Orbital arc, atau Crane up/down. Tambahkan kedalaman dengan mendeskripsikan efek paralaks - "rumput di latar depan bergoyang sementara pegunungan tetap diam di latar belakang." Anda juga dapat menyesuaikan tempo dengan istilah seperti "slow-motion" atau "whip-pan (gerakan pan kamera yang cepat)."

Untuk tugas image-to-video, fokuslah mendeskripsikan gerakan atau perubahan ekspresi karena model menggunakan gambar yang disediakan sebagai referensi dasar.

Setelah prompt visual Anda terkunci, Anda dapat melangkah lebih jauh dengan menyertakan audio dan dialog yang tersinkron.

Menambahkan Audio dan Dialog

Salah satu fitur unggulan Wan 2.5 adalah kemampuannya menghasilkan video dan audio secara bersamaan, menciptakan pengalaman yang sepenuhnya tersinkron dengan suara, suara ambien, dan efek.

"Yang benar-benar membedakan Wan 2.5 adalah kemampuannya menghasilkan bukan sekadar video bisu, melainkan pengalaman audio-visual lengkap dalam sekali jalan." - Scenario Knowledge Base ^[9]

Untuk dialog dengan sinkronisasi bibir, sertakan ucapan karakter dalam tanda kutip, seperti ini: "Seorang ilmuwan menatap kamera dan berkata, 'Hasilnya luar biasa.'" Untuk suara lingkungan, jelaskan secara spesifik: "hujan mengetuk jendela, deru lalu lintas di kejauhan." Model mengintegrasikan detail ini ke dalam keluaran akhir secara otomatis.

Jika Anda ingin menggunakan audio Anda sendiri, Anda dapat menyediakan audio_url khusus dalam format .wav atau .mp3 (ukuran maks: 15 MB). Namun, file audio sebaiknya sesuai dengan durasi video; jika lebih pendek, frame yang tersisa akan hening. Berhati-hatilah saat menggabungkan audio_url dengan beberapa URL gambar atau video dalam satu permintaan, karena hal ini dapat menyebabkan konflik ^[4].

Model secara otomatis menyesuaikan bahasa audio dengan prompt Anda, jadi jika prompt Anda dalam bahasa Inggris, audionya juga akan dalam bahasa Inggris - tanpa langkah tambahan ^[10].

Tingkat sinkronisasi ini memastikan audio dan visual bekerja sama dengan mulus untuk hasil akhir yang halus.

Memilih Resolusi dan Durasi

Saat bekerja dengan permintaan API, memilih resolusi dan durasi yang tepat adalah kunci untuk menyeimbangkan kualitas dan biaya.

Wan 2.5 Preview menawarkan dua durasi tetap - 5 detik atau 10 detik - dan resolusi 480p, 720p, dan 1080p pada 24 fps. Mulailah dengan draf 5 detik di 480p untuk menguji konsep Anda, lalu tingkatkan ke 1080p untuk render akhir Anda.

Berikut referensi cepat untuk kasus penggunaan umum:

Semua resolusi menyertakan audio stereo 48kHz, jadi bahkan draf beresolusi rendah pun akan memberi Anda gambaran yang baik tentang bagaimana audio akan terdengar sebelum berkomitmen pada render berkualitas lebih tinggi.

Mengintegrasikan Wan 2.5 ke dalam Alur Kerja Multi-Modal

Setelah Anda mencoba-coba eksperimen API, saatnya mengintegrasikan Wan 2.5 ke dalam pipeline produksi Anda. Dengan APIMart, Anda mendapatkan akses ke lebih dari 500 model AI melalui satu API. Penyiapan ini memungkinkan Anda memadukan model bahasa, gambar, dan video dengan mulus tanpa memerlukan konfigurasi tambahan.

Membangun Pipeline Script-to-Video

Berikut alur kerja yang umum: mulailah dengan model bahasa untuk menyusun naskah dan membaginya menjadi beberapa adegan. Selanjutnya, gunakan model gambar seperti Wan 2.7 Image API untuk membuat storyboard bagi setiap adegan. Dari sana, Wan 2.5 masuk, mengambil storyboard dan deskripsi adegan untuk menghasilkan klip video. Ia bahkan menyinkronkan audio sekaligus, menyederhanakan prosesnya ^[2][5].

Dengan menjaga semuanya di dalam APIMart, Anda merampingkan alur kerja Anda. Anda hanya perlu mengelola satu struktur API, satu kunci autentikasi, dan satu dashboard penagihan. Dengan penyiapan ini, Anda dapat fokus menyempurnakan keseimbangan antara performa dan biaya.

Mengelola Biaya dan Performa

Untuk mengelola pengeluaran secara efektif, sesuaikan model dan resolusi dengan tahap proyek Anda saat ini. Untuk draf awal, gunakan resolusi 480p untuk klip 5 detik, yang menghabiskan 43 credit per klip. Setelah draf Anda disetujui, tingkatkan ke 720p dengan 85 credit untuk 5 detik atau 170 credit untuk 10 detik. Untuk render akhir, tingkatkan ke 1080p dengan 128 credit untuk 5 detik atau 255 credit untuk 10 detik ^[1].

Butuh iterasi yang lebih cepat? Varian wan-2.5-fast menawarkan opsi yang lebih hemat biaya untuk 1080p, mengurangi biaya klip 10 detik menjadi 174 credit alih-alih 255 credit ^[11]. Jika Anda menangani tugas image-to-video dalam skala besar, Wan 2.6 I2V Flash API (wan2.6-i2v-flash) adalah pilihan yang ramah anggaran, dengan tarif $0.0168 per detik untuk video 720p tanpa audio (harga APIMart, Oktober 2026) dibandingkan $0.05 per detik untuk Wan 2.6 standar ^[7].

Contoh Alur Kerja: Dari Konsep ke Video Akhir

Setelah Anda mengoptimalkan biaya dan performa, ikuti proses langkah demi langkah ini untuk mewujudkan konsep Anda:

• Tulis naskah: Gunakan model bahasa seperti GPT-5 (tersedia melalui APIMart) untuk menyusun deskripsi adegan yang detail. Sertakan isyarat audio spesifik, seperti "musik piano lembut memudar masuk" atau "deru lalu lintas kota di kejauhan."
• Buat storyboard dan draf adegan di 480p: Masukkan deskripsi adegan ke model gambar untuk membuat panduan visual. Kemudian, uji setiap adegan dengan Wan 2.5 di 480p selama 5 detik untuk mengevaluasi gerakan, tempo, dan sinkronisasi audio.
• Render akhir di 1080p: Setelah puas dengan draf, render ulang adegan di 1080p untuk keluaran MP4 10 detik yang halus, lengkap dengan audio stereo 48kHz native ^[8].

"Konsistensi Wan 2.6 luar biasa! Gambar karakter tetap stabil di beberapa klip, yang sebelumnya sulit dicapai." - Wei Zhang, Animator Independen ^[7]

Untuk dorongan ekstra selama render akhir, gunakan parameter prompt_extend. Fitur ini secara otomatis memperkaya prompt Anda dengan detail sinematik, meningkatkan kualitas keluaran Anda tanpa memerlukan penyesuaian manual tambahan ^[12][3].

Kesimpulan dan Langkah Selanjutnya

Kini Anda telah dilengkapi dengan alat untuk mulai membuat video Wan 2.5 pertama Anda. Dengan sinkronisasi audio-video sekali jalan bawaannya, dukungan resolusi hingga 1080p, dan mode input serbaguna seperti text-to-video dan image-to-video, model ini siap untuk pekerjaan produksi serius - bukan sekadar uji coba biasa.

Sebelum terjun, pastikan penyiapan Anda benar-benar siap. Mulailah dari yang kecil dengan menguji klip 480p untuk menyempurnakan prompt Anda. Setelah Anda menguasai prosesnya, tingkatkan ke 1080p untuk render akhir Anda. Pendekatan ini memungkinkan Anda bereksperimen dan menyempurnakan tanpa mengeluarkan terlalu banyak sumber daya di awal.

Untuk proyek pertama Anda, cobalah fokus pada satu adegan. Tulis prompt yang detail yang mencakup instruksi audio yang jelas, dan hasilkan klip pendek 5 detik. Waktu pemrosesan cepat - biasanya antara 1 dan 5 menit - dan biayanya terjangkau, mulai dari hanya $0.0336 per detik untuk klip 480p ^[6]. Ini adalah cara yang terjangkau untuk menjelajahi dan menjadi terbiasa dengan alat ini.

Saat Anda siap berkembang, manfaatkan pustaka APIMart yang berisi lebih dari 500 model AI. Dengan satu kunci API dan dashboard penagihan, Anda dapat merampingkan alur kerja Anda dan membuat pipeline script-to-video lengkap dengan mudah, atau menjelajahi alternatif seperti MiniMax-Hailuo 2.3 untuk konsistensi berkualitas tinggi.

FAQ

Bagaimana cara menangani polling dan timeout untuk tugas video yang berjalan lama?

Kirim tugas, simpan task_id, lalu polling GET /v1/tasks/{task_id} setiap 10 detik hingga statusnya completed, failed, atau cancelled. Pembuatan biasanya memakan waktu 1–5 menit, jadi beri loop polling Anda batas waktu keseluruhan alih-alih menunggu satu permintaan.

Agar API tidak kelebihan beban, tangani error 429 dengan berhenti sejenak lalu mencoba lagi. Setelah tugas selesai, segera unduh videonya, karena APIMart menyimpan hasil selama 72 jam.

Apa cara terbaik untuk memperkirakan biaya sebelum menghasilkan klip 5d atau 10d?

Untuk menghitung biaya klip video 5 detik atau 10 detik, cukup kalikan durasi klip (dalam detik) dengan tarif per detik penyedia. Pastikan memeriksa tarif untuk resolusi yang Anda inginkan - baik itu 480p, 720p, atau 1080p - karena kualitas yang lebih tinggi biasanya disertai harga yang lebih tinggi. Misalnya, jika Anda menghitung untuk klip 5 detik, kalikan tarif per detik dengan 5. Untuk klip 10 detik, kalikan dengan 10.

Bagaimana cara meningkatkan sinkronisasi bibir dan kualitas dialog dengan prompt saya?

Untuk mendapatkan sinkronisasi bibir dan kualitas dialog terbaik di Wan 2.5 Preview, gunakan prompt terstruktur. Prompt ini sebaiknya secara jelas menentukan dialog karakter, beserta detail seperti emosi, nada, kecepatan, dan timbre. Tingkat detail ini membantu model memberikan hasil yang lebih akurat dan alami.

Untuk presisi yang lebih tinggi lagi, Anda dapat mengunggah file audio khusus dalam format WAV atau MP3. File ini akan berperan sebagai panduan bagi model untuk menyelaraskan ekspresi wajah dan gerakan mulut dengan audio secara sempurna.

Pastikan gambar input Anda tajam dan cukup cahaya. Gambar berkualitas tinggi memastikan model dapat menafsirkan dan mereplikasi ekspresi secara efektif. Selain itu, manfaatkan fitur perluasan prompt, yang memungkinkan Anda menyertakan deskripsi detail untuk interpretasi yang lebih baik oleh model.