Langsung ke konten utama
Vidgen API punya lima endpoint. Semuanya memakai origin yang sama, autentikasi yang sama, dan bentuk error yang sama.

Konvensi

  • Base URL https://vidgen.id, prefix path /api/v1. Lihat Base URL.
  • Autentikasi lewat Authorization: Bearer vg_... atau x-api-key: vg_.... Lihat Autentikasi.
  • Content type application/json; charset=utf-8, kecuali upload yang memakai multipart/form-data.
  • Waktu memakai ISO-8601 UTC (2026-11-04T09:12:44.000Z). Kuota harian dihitung dalam WIB.
  • Body sukses selalu memuat "success": true di samping datanya.
  • Tanpa CORS: panggil dari server, bukan dari browser.

Bentuk error

Setiap kegagalan memakai body ini:
Yang membedakan adalah status HTTP. Beberapa error menambahkan field diagnostik:
Vidgen tidak mengeluarkan kode error numerik sendiri. Jangan mem-parse string untuk logika — pakai status HTTP, lalu baca field diagnostik bila ada.

Pesan error tidak pernah berisi detail internal

Jalur keluar ke pengguna sudah disaring: nama penyedia, URL internal, dan respons mentah dari sistem hulu tidak akan muncul di error maupun errorMessage. Yang kamu dapat adalah kalimat yang bisa langsung diteruskan ke pengguna akhir. Kalau ada yang janggal, laporkan job.id beserta statusnya.

Spec OpenAPI

Terdapat spec OpenAPI 3.1 di repositori dokumentasi (/openapi.json) sebagai artefak untuk menghasilkan klien. Spec ini bukan sumber kebenaran bila bertentangan dengan halaman-halaman di tab ini; kontrak hidup ada di server.

Mulai dari mana

Generate video atau gambar

Endpoint utama: prompt, model, parameter, referensi.

Ambil hasil

Polling status dan unduh media.

Unggah referensi

Gambar, video, atau audio sebagai bahan.

Baca saldo

Kredit, masa Unlimited, dan sisa kuota hari ini.