Generate
Ambil status job
Polling status sebuah job generate, mendapat posisi antrean, dan mengambil URL hasil.
GET
/
api
/
v1
/
jobs
/
{id}
curl https://vigen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vigen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vigen.id/api/v1/jobs/{job_id}",
headers={"Authorization": f"Bearer {api_key}"},
).json()["job"]
print(job["status"], job["result"])
{
"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",
"queuePosition": 2,
"result": null,
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:12:44.000Z"
}
}
{
"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",
"queuePosition": null,
"result": {
"url": "https://vigen.id/api/media-proxy?token=3f9c...e1a2",
"duration": 5,
"width": 1280,
"height": 720
},
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:15:02.000Z"
}
}
{
"success": true,
"job": {
"id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
"status": "failed",
"queuePosition": null,
"result": null,
"errorMessage": "This model is temporarily unavailable on our side. Please try again in a few minutes.",
"creditsCharged": 0
}
}
{ "error": "Job tidak ditemukan." }
Mengembalikan kondisi terbaru sebuah job. Memanggil endpoint ini pada job yang sedang
processing juga memicu Vigen memeriksa penyedia di belakang layar, jadi polling adalah satu-satunya sinyal yang kamu butuhkan.
Job hanya bisa dibaca oleh akun pemiliknya. Job milik akun lain dijawab
403, bukan 404.Authorizations
string
wajib
API key berformat
Bearer vg_....Path parameters
string
wajib
job.id dari respons POST /api/v1/generate, contoh 9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b.curl https://vigen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vigen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vigen.id/api/v1/jobs/{job_id}",
headers={"Authorization": f"Bearer {api_key}"},
).json()["job"]
print(job["status"], job["result"])
Responses
boolean
wajib
true sepanjang job bisa dibaca, termasuk saat job-nya failed.object
wajib
Sembunyikan sifat job
Sembunyikan sifat job
string
wajib
Id yang kamu minta.
string
wajib
Salah satu dari
queued, dispatching, processing, succeeded, failed, cancelled.string
Id model.
string
"Video", "Image", atau "Audio".string
Prompt yang tersimpan setelah penyaringan.
number | null
Posisi antrean. Hanya bernilai saat
status === "queued"; null di luar itu, termasuk bila posisinya tidak bisa dibaca.object | null
string | null
Penjelasan kegagalan, sudah disaring dan berbahasa Inggris.
null selama job belum gagal.number
wajib
Kredit terpakai. Bernilai
0 pada job yang gagal karena kredit dikembalikan, dan 0 sejak awal bila kuota Unlimited yang membiayai.string (ISO 8601)
Waktu job dibuat.
string (ISO 8601)
Waktu perubahan status terakhir. Berguna untuk mendeteksi job yang macet.
{
"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",
"queuePosition": 2,
"result": null,
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:12:44.000Z"
}
}
{
"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",
"queuePosition": null,
"result": {
"url": "https://vigen.id/api/media-proxy?token=3f9c...e1a2",
"duration": 5,
"width": 1280,
"height": 720
},
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:15:02.000Z"
}
}
{
"success": true,
"job": {
"id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
"status": "failed",
"queuePosition": null,
"result": null,
"errorMessage": "This model is temporarily unavailable on our side. Please try again in a few minutes.",
"creditsCharged": 0
}
}
{ "error": "Job tidak ditemukan." }
Pola polling
const timer = setInterval(async () => {
const job = (await (await fetch(url, { headers })).json()).job;
if (["succeeded", "failed", "cancelled"].includes(job.status)) {
clearInterval(timer);
onDone(job);
}
}, 5000);
setTimeout(() => clearInterval(timer), 2 * 60 * 60 * 1000);
let delay = 5000;
for (;;) {
const job = (await (await fetch(url, { headers })).json()).job;
if (job.status !== "queued" && job.status !== "processing") return job;
await sleep(delay);
delay = Math.min(delay * 1.6, 30000);
}
interval = 5.0
while True:
job = api.job(job_id)
if job["status"] in {"succeeded", "failed", "cancelled"}:
break
time.sleep(interval)
interval = min(interval * 1.6, 30.0)
while true; do
status=$(curl -s -H "Authorization: Bearer $VIGEN_API_KEY" \
"https://vigen.id/api/v1/jobs/$JOB_ID" | jq -r .job.status)
echo "$status"
if [ "$status" = "succeeded" ] || [ "$status" = "failed" ] || [ "$status" = "cancelled" ]; then
break
fi
sleep 5
done
Endpoint ini tidak memotong kredit dan boleh dipanggil sesering yang kamu mau — tapi 2 jam adalah umur maksimal job. Setelah itu status akan menjadi
failed dan polling sebaiknya berhenti.⌘I
curl https://vigen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vigen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vigen.id/api/v1/jobs/{job_id}",
headers={"Authorization": f"Bearer {api_key}"},
).json()["job"]
print(job["status"], job["result"])
{
"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",
"queuePosition": 2,
"result": null,
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:12:44.000Z"
}
}
{
"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",
"queuePosition": null,
"result": {
"url": "https://vigen.id/api/media-proxy?token=3f9c...e1a2",
"duration": 5,
"width": 1280,
"height": 720
},
"errorMessage": null,
"creditsCharged": 3,
"createdAt": "2026-11-04T09:12:44.000Z",
"updatedAt": "2026-11-04T09:15:02.000Z"
}
}
{
"success": true,
"job": {
"id": "9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b",
"status": "failed",
"queuePosition": null,
"result": null,
"errorMessage": "This model is temporarily unavailable on our side. Please try again in a few minutes.",
"creditsCharged": 0
}
}
{ "error": "Job tidak ditemukan." }