> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgen.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidgen API

> Generate video dan gambar AI lewat satu API key. Satu endpoint untuk membuat job, satu endpoint untuk mengambil hasilnya.

Vidgen API adalah antarmuka HTTP untuk mesin generate video dan gambar Vidgen. Dengan satu API key kamu bisa membuat job, mengirim gambar atau video referensi, lalu mengambil hasil jadi — tanpa perlu membuka dashboard.

> [card] [Quickstart](https://docs.vidgen.id/quickstart.md)
>
> Kirim request pertama dalam 3 menit.

> [card] [Autentikasi](https://docs.vidgen.id/authentication.md)
>
> Cara pakai `Authorization: Bearer` dan `x-api-key`.

> [card] [Referensi API](https://docs.vidgen.id/api-reference/overview.md)
>
> Semua endpoint, parameter, dan bentuk respons.

> [card] [Batas pemakaian](https://docs.vidgen.id/concepts/concurrency-limits.md)
>
> Konkurensi, kuota harian, dan umur job.

## Cara kerjanya

Vidgen API bersifat **asinkron**. Sebuah request `POST /api/v1/generate` langsung dijawab `202 Accepted` berisi `job.id`, lalu hasilnya diambil dengan `GET /api/v1/jobs/{id}` sampai statusnya `succeeded`.

**1. Kirim prompt + model**

Pilih model dari katalog (contoh: `seedance-2-5-flash`), tulis prompt, atur durasi/rasio/resolusi lewat `parameters`.

**2. Server memasukkan antrean**

Kredit dipotong di awal, job masuk antrean, dan kamu menerima `job.id` beserta posisi antrean.

**3. Polling sampai selesai**

Cek status tiap 5 detik. Selama status `queued` kamu melihat `queuePosition`; saat `succeeded` kamu mendapat URL media.

**4. Unduh hasilnya**

Simpan URL-nya ke storage kamu sendiri. Tautan hasil punya masa berlaku terbatas, jadi jangan bergantung padanya sebagai sumber permanen.

## Mulai dalam 3 langkah

**1. Buat API key**

Masuk ke [vidgen.id → Dokumentasi](https://vidgen.id/docs), klik **Buat API Key**, lalu salin nilainya. Key berformat `vg_...` dan hanya ditampilkan satu kali.

**2. Kirim permintaan pertama**

```bash create curl theme={null}
curl -X POST https://vidgen.id/api/v1/generate \
  -H "Authorization: Bearer vg_GANTI_DENGAN_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-flash",
    "prompt": "Kopi susu di meja kayu, cahaya pagi menembus jendela, kamera bergerak pelan ke kanan",
    "parameters": { "duration": "5", "ratio": "16:9", "resolution": "720p" }
  }'
```

**3. Ambil hasilnya**

```bash poll curl theme={null}
curl https://vidgen.id/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer vg_GANTI_DENGAN_KEY_KAMU"
```

## Jelajahi dokumentasi

> [card] [Katalog model](https://docs.vidgen.id/concepts/models.md)
>
> Model aktif, kemampuan, dan cara membacanya dari runtime.

> [card] [Kredit & harga](https://docs.vidgen.id/concepts/credits.md)
>
> Cara tagihan dihitung dan kapan paket Unlimited memotong 0 kredit.

> [card] [Media referensi](https://docs.vidgen.id/concepts/reference-media.md)
>
> Batas ukuran, durasi, dan resolusi berkas referensi.

> [card] [Idempotensi](https://docs.vidgen.id/concepts/idempotency.md)
>
> Jangan kena tagihan ganda saat retry.

> [card] [Node.js](https://docs.vidgen.id/guides/nodejs.md)
>
> Klien lengkap tanpa dependensi tambahan.

> [card] [Python](https://docs.vidgen.id/guides/python.md)
>
> Helper `generate()` + `wait_for_job()`.

> [!TIP]
>
> Butuh bantuan? Kirim pesan dukungan lewat dashboard Vidgen atau baca [kode error](https://docs.vidgen.id/troubleshooting/errors.md) lebih dulu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.