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

# Pertanyaan umum

> Jawaban cepat untuk masalah integrasi Vigen yang paling sering muncul.

> [accordion] Ada webhook supaya tidak perlu polling?
>
> Belum. Model resminya adalah polling `GET /api/v1/jobs/{id}`. Kalau kamu butuh notifikasi, jalankan worker yang bertugas polling dan lempar peristiwa ke sistemmu sendiri. Format webhook bisa ditambahkan di masa depan tanpa merusak klien yang sudah ada.

> [accordion] Kenapa request dari browser saya gagal, padahal key benar?
>
> Vigen API tidak mengirim header CORS, jadi browser memblokir pembacaan responsnya dari domain lain. Taruh pemanggilan API di backend kamu. Ini disengaja: API key tidak boleh berada di kode yang sampai ke pengguna akhir.

> [accordion] Satu akun boleh punya berapa API key?
>
> Tidak ada batas yang diumumkan. Yang penting: batas pemakaian menempel di akun, bukan di key. Tiga key tidak berarti tiga jatah konkurensi.

> [accordion] Bagaimana cara tahu harga sebuah model sebelum memotong saldo pengguna?
>
> Ambil `GET /api/v1/models`, lalu tirukan urutan pencarian harga: `quality:resolution` → `resolution:duration` → `duration` → `resolution` → `creditsDefault`. Harga bisa berubah dari sisi admin, jadi jangan menyalin angkanya ke kode.

> [accordion] Hasilnya hilang kalau saya simpan URL-nya?
>
> Bisa iya. Tautan berbentuk `/api/media-proxy?token=...` berlaku 24 jam. Unduh filenya begitu status `succeeded` dan simpan di storage kamu sendiri.

> [accordion] Kredit terpotong dua kali untuk satu permintaan
>
> Hampir selalu penyebabnya retry tanpa `idempotencyKey`. Baca [Idempotensi](https://docs.vidgen.id/concepts/idempotency.md): key harus panjangnya minimal 8 karakter dan dipakai lagi pada setiap percobaan.

> [accordion] Job saya `failed` — apakah saya bayar?
>
> Tidak. Kredit dikembalikan otomatis saat job gagal, batal tersimpan, atau antrean penuh. Pada job gagal, `creditsCharged` akhirnya bernilai `0`. Yang tetap berbayar adalah hasil yang memang jadi, walaupun tidak sesuai harapanmu secara artistik.

> [accordion] Kenapa prompt saya berubah di respons?
>
> Vigen menyaring kata sensitif, nama tokoh publik, dan indikasi pelanggaran sebelum permintaan diteruskan. Field `prompt` pada respons adalah isi yang sudah disaring. Kalau isinya sampai merusak maksud kreatifmu, tulis ulang dengan bahasa netral.

> [accordion] Boleh dipakai untuk konten dewasa?
>
> Sebagian model dijual tanpa penyaringan dan bisa dikenali dari namanya. Aturannya tidak berubah karena kamu memakai API: tanggung jawab atas materi yang dikirim ada di pemegang key, dan ketentuan layanan Vigen tetap berlaku di semua kanal. Baca ketentuan layanan di dashboard sebelum membangun produk di atas model-model itu.

> [accordion] Kenapa generate audio tidak jalan lewat API?
>
> Model musik memang tampil di katalog, tapi jalurnya belum dibuka untuk API key. Pemanggilan hari ini akan berakhir `failed` dengan kredit dikembalikan. Generate audio masih lewat dashboard.

> [accordion] Berapa lama video selesai?
>
> Umumnya 1-5 menit untuk klip pendek, tetapi sangat bergantung pada antrean. Yang dijamin bukan waktunya, melainkan batas atasnya: 2 jam, setelah itu job ditandai `failed` dan kredit kembali.

> [accordion] Bisa naikkan batas konkurensi?
>
> Batas 2 proses bersamaan hanya menggantung pada pemakaian kuota Unlimited. Kalau kamu membayar per kredit, kamu tidak kena batas itu — konsekuensinya antrean lebih panjang. Untuk kebutuhan khusus (studio dengan banyak seniman), hubungi dukungan lewat dashboard.

> [accordion] Ada SDK resmi?
>
> Belum. Yang tersedia adalah klien minimal di panduan [Node.js](https://docs.vidgen.id/guides/nodejs.md) dan [Python](https://docs.vidgen.id/guides/python.md), plus spec OpenAPI untuk menghasilkan klien sendiri. Semuanya memakai HTTP biasa, jadi integrasi tidak bergantung pada paket pihak ketiga.

> [accordion] Endpoint mana yang aman dipakai di production?
>
> Kelima endpoint di tab [Referensi API](https://docs.vidgen.id/api-reference/overview.md) sudah stabil di `v1`. Perubahan yang merusak kontrak akan diumumkan sebagai versi baru, dan `v1` tetap dilayani.

> [accordion] Ke siapa saya melapor kalau ada yang aneh?
>
> Lewat dukungan di dashboard Vigen. Sertakan: `job.id`, endpoint, status HTTP, `error` persis seperti yang kamu terima, origin yang kamu pakai, dan waktu kejadian. Tanpa nama sistem internal — memang tidak pernah muncul di respons.


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