Generate
Get job status
Poll the status of a generation job, read the queue position, and fetch the result URL.
GET
/
api
/
v1
/
jobs
/
{id}
curl https://vidgen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vidgen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vidgen.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://vidgen.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." }
Returns the latest state of a job. Calling this endpoint on a job that is
processing also makes Vidgen check the provider behind the scenes, so polling is the only signal you need.
A job can only be read by the account that owns it. A job belonging to another account is answered
403, not 404.Authorizations
string
required
API key formatted
Bearer vg_....Path parameters
string
required
The
job.id from the POST /api/v1/generate response, for example 9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b.curl https://vidgen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vidgen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vidgen.id/api/v1/jobs/{job_id}",
headers={"Authorization": f"Bearer {api_key}"},
).json()["job"]
print(job["status"], job["result"])
Responses
boolean
required
true as long as the job can be read, including when the job is failed.object
required
Hide job properties
Hide job properties
string
required
The id you requested.
string
required
One of
queued, dispatching, processing, succeeded, failed, cancelled.string
Model id.
string
"Video", "Image", or "Audio".string
The stored prompt after filtering.
number | null
Queue position. Only has a value while
status === "queued"; null otherwise, including when the position cannot be read.object | null
string | null
Explanation of the failure, already filtered and in English.
null while the job has not failed.number
required
Credits used. It reads
0 on a failed job because the credits were refunded, and 0 from the start if the Unlimited quota paid for it.string (ISO 8601)
When the job was created.
string (ISO 8601)
When the status last changed. Useful for spotting stalled jobs.
{
"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://vidgen.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." }
Polling patterns
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 $VIDGEN_API_KEY" \
"https://vidgen.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
This endpoint deducts no credits and may be called as often as you like — but 2 hours is the maximum job lifetime. After that the status becomes
failed and polling should stop.⌘I
curl https://vidgen.id/api/v1/jobs/9f2c1d34-a8b7-4e0f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const res = await fetch(`https://vidgen.id/api/v1/jobs/${jobId}`, {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
});
const { job } = await res.json();
console.log(job.status, job.queuePosition, job.result?.url);
job = requests.get(
f"https://vidgen.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://vidgen.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." }