# 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: 2026-11-04 · Versi HTML: https://aiport.id/id/api-image-to-video

![Foto kopi tubruk yang berubah menjadi beberapa frame video berurutan](https://aiport.id/images/landing/api-image-to-video/foto-diam-menjadi-frame-video.webp)
*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](https://aiport.id/images/landing/api-image-to-video/image-to-video-sebelum-sesudah.webp)
*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

| 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.

![Perbandingan gambar awal yang jelas dan gambar awal yang buram atau terlalu ramai](https://aiport.id/images/landing/api-image-to-video/tips-gambar-awal-image-to-video.webp)
*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 yang sering diajukan

### 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: https://aiport.id/signup · Dokumentasi: https://aiport.id/docs.md

## Halaman terkait

- [API video AI](https://aiport.id/id/api-video-ai)
- [bikin video iklan pakai AI](https://aiport.id/id/api-video-iklan-ai)
- [generate foto produk AI](https://aiport.id/id/api-generate-foto-produk-ai)
