Buat job generate

POST

api

generate

curl -X POST https://vidgen.id/api/v1/generate \
  -H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-flash",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "parameters": { "duration": "5", "ratio": "16:9", "resolution": "720p" },
    "idempotencyKey": "order-4711-a39f2c7b"
  }'

const res = await fetch("https://vidgen.id/api/v1/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIDGEN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2-5-flash",
    prompt: "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    parameters: { duration: "5", ratio: "16:9", resolution: "720p" },
    idempotencyKey: "order-4711-a39f2c7b",
  }),
});

console.log(res.status, await res.json());

res = requests.post(
    "https://vidgen.id/api/v1/generate",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "seedance-2-5-flash",
        "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
        "parameters": {"duration": "5", "ratio": "16:9", "resolution": "720p"},
        "idempotencyKey": "order-4711-a39f2c7b",
    },
)

print(res.status_code, res.json())

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "queued",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 2, "status": "queued" }
}

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "succeeded",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "result": { "url": "https://vidgen.id/api/media-proxy?token=..." },
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 0 },
  "idempotent": true
}

{
  "error": "Kredit akun tidak mencukupi. Pembuatan ini membutuhkan 10 kredit",
  "requiredCredits": 10,
  "currentCredits": 4
}

{
  "error": "Maksimal 2 proses generate bersamaan. Tunggu salah satunya selesai sebelum memulai yang baru.",
  "maxConcurrent": 2,
  "activeJobs": 2
}

{
  "error": "Parameter tidak valid: Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s.",
  "fields": ["Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s."]
}

Membuat satu job generate. Kredit dipotong pada endpoint ini, dan request dijawab sebelum hasilnya jadi.

Butuh daftar model yang bisa diisi di field model? Ambil dari GET /api/v1/models. Nilai parameters yang valid juga bergantung pada model.

Authorizations

string

wajib

API key berformat Bearer vg_.... Bisa juga memakai header x-api-key.

Request body

string

wajib

Id model dari katalog, misalnya seedance-2-5-flash. Ejaan dengan titik dan tanda hubung diperlakukan sama. Model yang ada tapi sedang dinonaktifkan dijawab 409.

string

Deskripsi yang ingin dibuat. Wajib kecuali untuk model motion control, yang boleh kosong karena server mengisi instruksi netral. Maksimal 2.500 karakter untuk model motion.Prompt melewati penyaringan konten lebih dulu; kata sensitif, tokoh publik, atau indikasi pelanggaran dihapus sebelum diteruskan. Sebagian model yang secara terbuka dijual tanpa penyaringan dikenali dari id-nya (spicy, nsfw) dan tidak disaring.

object

default:"{}"

Pengaturan keluaran. Hanya kunci yang dikenal yang diproses; kunci lain diabaikan tanpa error.

Tampilkan sifat yang dikenali

string

Durasi dalam detik, misal "5" atau "30". Akhiran s diterima dan dibuang. Divalidasi terhadap capabilities.durations. Diabaikan pada model motion control.

string

Resolusi, misal "720p", "1080p", "1K", "2K", "4K". Divalidasi terhadap capabilities.resolutions.

string

Rasio aspek: "16:9", "9:16", "1:1", "4:3", "3:4", atau "auto". aspect_ratio diterima sebagai alias.

string

Untuk model gambar yang punya capabilities.qualities (low, medium, high, max). Diabaikan bila model tidak mendukung.

string

Untuk model gambar yang punya capabilities.backgrounds (auto, transparent, opaque).

string

Format keluaran; format diterima sebagai alias. Hanya dipakai jika model punya capabilities.outputFormats.

string

Hal yang tidak diinginkan. Hanya diteruskan jika capabilities.supportsNegativePrompt.

string

Biji acak untuk hasil yang bisa diulang. Hanya diteruskan jika capabilities.supportsSeed.

string

Khusus motion control: "image" (rasio mengikuti gambar karakter) atau "video" (rasio mengikuti video gerakan). Nilai lain diabaikan.

array<object>

Bahan masukan: gambar karakter, produk, atau video gerakan. Tiap objek bisa berupa aset hasil POST /api/v1/upload atau URL publik.

Tampilkan objek referensi

string

Id aset dari endpoint upload. Kalau ada, objek ini dipakai apa adanya (kirim juga url, file_url, dan filename seperti yang kamu terima).

string

URL media publik (http atau https) yang akan diunduh server dengan timeout 20 detik. Kegagalan unduhan dijawab 400.

string

"image", "video", atau "audio". Boleh dilewat — server mendeteksi dari isi berkas. Jumlah maksimum per jenis bergantung model (bawaan: 9 gambar / 1 video / 1 audio; model gambar 10 gambar dan tanpa video atau audio).

string

Nama berkas di penyimpanan server. Ikuti persis nilai dari respons upload.

string

Minimal 8 karakter. Key yang sama mengembalikan job yang sudah ada dengan 200 dan idempotent: true, tanpa potongan kredit kedua. Di bawah 8 karakter, nilai kamu diabaikan dan server membuat key sendiri. Lihat Idempotensi.

curl -X POST https://vidgen.id/api/v1/generate \
  -H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-flash",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "parameters": { "duration": "5", "ratio": "16:9", "resolution": "720p" },
    "idempotencyKey": "order-4711-a39f2c7b"
  }'

const res = await fetch("https://vidgen.id/api/v1/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIDGEN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2-5-flash",
    prompt: "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    parameters: { duration: "5", ratio: "16:9", resolution: "720p" },
    idempotencyKey: "order-4711-a39f2c7b",
  }),
});

console.log(res.status, await res.json());

res = requests.post(
    "https://vidgen.id/api/v1/generate",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "seedance-2-5-flash",
        "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
        "parameters": {"duration": "5", "ratio": "16:9", "resolution": "720p"},
        "idempotencyKey": "order-4711-a39f2c7b",
    },
)

print(res.status_code, res.json())

Responses

boolean

true pada semua respons sukses.

object

wajib

Objek job.

Sembunyikan sifat job

string

wajib

Id untuk polling di GET /api/v1/jobs/{id}.

string

wajib

"queued" untuk job baru. Nilai lain: dispatching, processing, succeeded, failed, cancelled.

string

Id model yang dipakai.

string

"Video", "Image", atau "Audio".

string

Prompt setelah penyaringan konten. Ini yang benar-benar diproses.

number

wajib

Kredit yang dipotong. 0 bila kuota Unlimited terpakai.

string (ISO 8601)

Waktu job dibuat, UTC.

object | null

Hanya terisi pada respons idempoten untuk job yang sudah selesai; untuk job baru selalu null.

object

Informasi antrean saat request dibuat.

Tampilkan isi queue

number

Posisi di antrean. 0 berarti sedang diproses atau posisinya tidak dilaporkan.

string

Mengikuti status job, umumnya "queued".

boolean

Hanya muncul saat key yang sama sudah pernah dipakai dan job lama dikembalikan.

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "queued",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 2, "status": "queued" }
}

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "succeeded",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "result": { "url": "https://vidgen.id/api/media-proxy?token=..." },
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 0 },
  "idempotent": true
}

{
  "error": "Kredit akun tidak mencukupi. Pembuatan ini membutuhkan 10 kredit",
  "requiredCredits": 10,
  "currentCredits": 4
}

{
  "error": "Maksimal 2 proses generate bersamaan. Tunggu salah satunya selesai sebelum memulai yang baru.",
  "maxConcurrent": 2,
  "activeJobs": 2
}

{
  "error": "Parameter tidak valid: Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s.",
  "fields": ["Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s."]
}

Yang perlu kamu tahu

Kenapa 202, bukan 200?

Generate bersifat asinkron. 202 berarti permintaan diterima dan antrean sudah disiapkan; hasilnya diambil nanti lewat job id. Satu-satunya 200 di endpoint ini adalah replay idempoten.

Kapan kredit dipotong dan kapan kembali?

Dipotong sebelum job disimpan. Kalau job gagal, batal tersimpan, atau antrean penuh, kredit dikembalikan otomatis dengan reason refund yang tercatat di riwayat akun. Kamu tidak perlu membuat mekanisme refund sendiri.

Apakah request bisa diulang dengan aman?

Ya, asal memakai idempotencyKey yang sama dan panjangnya minimal 8 karakter. Tanpa itu, setiap retry adalah job baru dengan tagihan baru.

Field tambahan pada body diabaikan?

Ya. Body yang mengirim watermark: false atau n: 2 tidak error, tapi juga tidak berefek. Hanya model, prompt, parameters, references, idempotencyKey yang dibaca.

Batas yang membuat request ini ditolak

Dua proses bersamaan (khusus akun Unlimited), 50 video sukses per hari, antrean server penuh, atau situs sedang pemeliharaan. Semuanya memakai 429 atau 503.

⌘I

curl -X POST https://vidgen.id/api/v1/generate \
  -H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-flash",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "parameters": { "duration": "5", "ratio": "16:9", "resolution": "720p" },
    "idempotencyKey": "order-4711-a39f2c7b"
  }'

const res = await fetch("https://vidgen.id/api/v1/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIDGEN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2-5-flash",
    prompt: "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    parameters: { duration: "5", ratio: "16:9", resolution: "720p" },
    idempotencyKey: "order-4711-a39f2c7b",
  }),
});

console.log(res.status, await res.json());

res = requests.post(
    "https://vidgen.id/api/v1/generate",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "seedance-2-5-flash",
        "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
        "parameters": {"duration": "5", "ratio": "16:9", "resolution": "720p"},
        "idempotencyKey": "order-4711-a39f2c7b",
    },
)

print(res.status_code, res.json())

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "queued",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 2, "status": "queued" }
}

{
  "success": true,
  "job": {
    "id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
    "status": "succeeded",
    "model": "seedance-2-5-flash",
    "category": "Video",
    "prompt": "secangkir kopi di meja kayu, cahaya pagi, kamera dolly perlahan ke kanan",
    "result": { "url": "https://vidgen.id/api/media-proxy?token=..." },
    "creditsCharged": 3,
    "createdAt": "2026-11-04T09:12:44.000Z"
  },
  "queue": { "position": 0 },
  "idempotent": true
}

{
  "error": "Kredit akun tidak mencukupi. Pembuatan ini membutuhkan 10 kredit",
  "requiredCredits": 10,
  "currentCredits": 4
}

{
  "error": "Maksimal 2 proses generate bersamaan. Tunggu salah satunya selesai sebelum memulai yang baru.",
  "maxConcurrent": 2,
  "activeJobs": 2
}

{
  "error": "Parameter tidak valid: Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s.",
  "fields": ["Durasi 60s tidak didukung Seedance 2.5 Flash. Pilihan: 20s."]
}

Ikhtisar

Generate

Media

Katalog & Akun

Authorizations

Request body

Responses

Yang perlu kamu tahu

​Authorizations

​Request body

​Responses

​Yang perlu kamu tahu

Authorizations

Request body

Responses

Yang perlu kamu tahu