Dari gambar diam ke video

Alur image to video
Siapkan gambar
Unggah file lokal lewat POST /v1/image/upload untuk mendapatkan URL HTTPS, atau pakai URL HTTPS yang sudah ada.
Kirim job
Panggil POST /v1/video/img2video dengan first_frame_url, prompt gerakan, duration, dan resolution.
Ambil hasil
Polling GET /v1/jobs/{job_id} sampai status done, lalu unduh MP4 dari result_urls.
Parameter image to video
| Parameter | Fungsi |
|---|---|
first_frame_url | Gambar yang menjadi frame pertama video (wajib). |
last_frame_url | Opsional: gambar tujuan di akhir video, berguna untuk transisi dari A ke B. |
prompt | Gerakan yang diinginkan: kamera, subjek, suasana. |
duration | Panjang video 4–15 detik, tergantung model. |
resolution | Resolusi output yang menentukan harga per detik. |
real_person_mode | Petunjuk bahwa gambar memuat orang sungguhan, untuk menjaga kemiripan wajah. |
Tips memilih gambar awal
Subjek jelas
Satu subjek utama dengan latar yang tidak terlalu ramai lebih mudah digerakkan secara natural.
Resolusi cukup
Gambar buram akan menghasilkan video buram. Pakai gambar setidaknya setara resolusi output.
Rasio sesuai tujuan
Kalau videonya vertikal, mulai dari gambar vertikal agar tidak ada bagian yang terpotong.
Hindari teks kecil
Tulisan kecil di gambar sering berubah bentuk saat digerakkan. Tambahkan teks setelah video jadi.

Tulis gerakan, bukan isi gambar
Model sudah melihat isi gambarnya, jadi prompt sebaiknya fokus pada apa yang bergerak. Contoh: "kamera mendorong pelan ke depan, uap naik dari cangkir kopi" lebih efektif daripada mendeskripsikan ulang cangkir dan mejanya.
Contoh request
Pertanyaan seputar API image to video
Apakah bisa menentukan frame akhir video?
Bisa pada model yang mendukungnya, lewat last_frame_url. Video akan bergerak dari gambar awal menuju gambar akhir.
Format gambar apa yang bisa dipakai?
JPEG, PNG, atau WebP lewat /v1/image/upload, atau URL HTTPS gambar yang bisa diakses publik.
Apakah wajah orang di foto tetap mirip?
Aktifkan real_person_mode untuk memberi tahu model bahwa gambar memuat orang sungguhan, sehingga identitas wajah lebih terjaga. Hasil tetap perlu dicek.
Berapa durasi maksimal video dari gambar?
Antara 4 sampai 15 detik, tergantung model. Beberapa model hanya menerima durasi tertentu; cek field features di GET /v1/models?modality=video.
Hidupkan gambar pertamamu
Unggah satu gambar, tulis gerakannya, dan ambil videonya lewat API.
