API IMAGE TO VIDEO

API image to video: ubah satu gambar menjadi klip video

API image to video mengubah gambar diam menjadi klip video. Di AIport, kirim URL gambar sebagai first_frame_url ke /v1/video/img2video beserta prompt yang menjelaskan gerakan. Hasilnya file MP4 yang kamu ambil lewat /v1/jobs/{job_id}.

Diperbarui

Foto kopi tubruk yang berubah menjadi beberapa frame video berurutan
Dari satu foto ke rangkaian frame. Ilustrasi dibuat dengan AI.

Dari gambar diam ke video

Gelas kopi tubruk sebagai gambar awal di kiri dan gambaran frame berikutnya dengan kamera lebih dekat serta uap yang naik di kanan
Kiri: gambar awal. Kanan: gambaran frame beberapa detik kemudian. Keduanya ilustrasi yang dibuat dengan AI.

Alur image to video

1

Siapkan gambar

Unggah file lokal lewat POST /v1/image/upload untuk mendapatkan URL HTTPS, atau pakai URL HTTPS yang sudah ada.

2

Kirim job

Panggil POST /v1/video/img2video dengan first_frame_url, prompt gerakan, duration, dan resolution.

3

Ambil hasil

Polling GET /v1/jobs/{job_id} sampai status done, lalu unduh MP4 dari result_urls.

Parameter image to video

ParameterFungsi
first_frame_urlGambar yang menjadi frame pertama video (wajib).
last_frame_urlOpsional: gambar tujuan di akhir video, berguna untuk transisi dari A ke B.
promptGerakan yang diinginkan: kamera, subjek, suasana.
durationPanjang video 4–15 detik, tergantung model.
resolutionResolusi output yang menentukan harga per detik.
real_person_modePetunjuk 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.

Perbandingan gambar awal yang jelas dan gambar awal yang buram atau terlalu ramai
Kiri cocok jadi frame pertama. Kanan sulit digerakkan secara natural.

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

curl
curl -X POST https://aiport.id/v1/video/img2video \
  -H "Authorization: Bearer $AIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast-img2video",
    "prompt": "kamera mendorong pelan, uap naik dari cangkir kopi",
    "first_frame_url": "https://cdn.aiport.id/uploads/.../kopi.jpg",
    "resolution": "720p",
    "duration": 5
  }'

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.

Daftar gratis →Lihat dokumentasi