Catalog & account
Account balance & limits
Check credits, Unlimited package status, active jobs, and the daily video quota remaining on one account.
GET
/
api
/
v1
/
user
/
credits
curl https://vidgen.id/api/v1/user/credits \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const info = await (
await fetch("https://vidgen.id/api/v1/user/credits", {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
})
).json();
if (info.user.credits < 10 || info.limits.dailyVideosRemaining === 0) {
console.warn("tidak layak mengirim batch");
}
info = requests.get(
"https://vidgen.id/api/v1/user/credits",
headers={"Authorization": f"Bearer {api_key}"},
).json()
print(info["user"]["credits"], info["unlimited"], info["limits"])
{
"success": true,
"user": {
"uid": "0f7c9a1e-42b3-4c9a-9d0f-8a3e2b1c5d64",
"email": "saya@tokokamu.com",
"credits": 128
},
"unlimited": {
"active": true,
"daysLeft": 1,
"expiresAt": "2026-11-05T03:41:12.000Z"
},
"limits": {
"maxConcurrentJobs": 2,
"currentActiveJobs": 1,
"dailyVideoLimit": 50,
"dailyVideosGenerated": 12,
"dailyVideosRemaining": 38,
"resetsAt": "00:00 WIB"
}
}
{ "error": "API Key tidak valid atau telah dicabut." }
{ "error": "Vidgen sedang dalam pemeliharaan. Penggunaan API key dinonaktifkan sementara." }
One lightweight call that tells you whether your account is ready to submit the next request. It works well as a gate before a batch.
Authorizations
string
required
API key formatted
Bearer vg_....curl https://vidgen.id/api/v1/user/credits \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const info = await (
await fetch("https://vidgen.id/api/v1/user/credits", {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
})
).json();
if (info.user.credits < 10 || info.limits.dailyVideosRemaining === 0) {
console.warn("tidak layak mengirim batch");
}
info = requests.get(
"https://vidgen.id/api/v1/user/credits",
headers={"Authorization": f"Bearer {api_key}"},
).json()
print(info["user"]["credits"], info["unlimited"], info["limits"])
Responses
boolean
required
true when the data was read.object
required
object
required
Status of the Unlimited package. No credits are deducted for eligible models while
active is true.object
required
The limits that will decide whether your next request is accepted.
Hide contents of limits
Hide contents of limits
number
required
Concurrent processes allowed for Unlimited quota usage. Currently
2.number
required
Jobs owned by your account that are still
queued, dispatching, or processing.number
required
Maximum successful videos per day. Currently
50.number
required
Already used today. Failed jobs are not counted.
number
required
Left for today, minimum
0.string
required
"00:00 WIB" — the reset uses Western Indonesia Time, not UTC.{
"success": true,
"user": {
"uid": "0f7c9a1e-42b3-4c9a-9d0f-8a3e2b1c5d64",
"email": "saya@tokokamu.com",
"credits": 128
},
"unlimited": {
"active": true,
"daysLeft": 1,
"expiresAt": "2026-11-05T03:41:12.000Z"
},
"limits": {
"maxConcurrentJobs": 2,
"currentActiveJobs": 1,
"dailyVideoLimit": 50,
"dailyVideosGenerated": 12,
"dailyVideosRemaining": 38,
"resetsAt": "00:00 WIB"
}
}
{ "error": "API Key tidak valid atau telah dicabut." }
{ "error": "Vidgen sedang dalam pemeliharaan. Penggunaan API key dinonaktifkan sementara." }
Common usage patterns
- Gate before a batch
- Low balance alert
- Watch the daily quota
async function canSubmit(model, parameters) {
const [{ limits }, models] = await Promise.all([vidgen.credits(), vidgen.models()]);
const m = models.video.find((x) => x.id === model);
const harga = perkirakanHarga(m, parameters);
return (
limits.dailyVideosRemaining > 0 &&
limits.currentActiveJobs < limits.maxConcurrentJobs &&
(await vidgen.credits()).user.credits >= harga
);
}
// run hourly from cron
const { user, unlimited } = await vidgen.credits();
if (!unlimited.active && user.credits < 20) {
await notifyOwner(`Sisa kredit ${user.credits}. Beli lagi di https://vidgen.id/billing`);
}
const { limits } = await vidgen.credits();
if (limits.dailyVideosRemaining <= 5) {
scheduler.pauseNewVideoJobsUntil(nextWibMidnight());
}
The
maxConcurrentJobs number only drives rejection when your request is paid for by the Unlimited quota. Per-credit usage can have more than two active jobs, but it will queue longer.⌘I
curl https://vidgen.id/api/v1/user/credits \
-H "Authorization: Bearer vg_4b1a82f3c9d0e1f2a3b4c5d6e7f80912"
const info = await (
await fetch("https://vidgen.id/api/v1/user/credits", {
headers: { Authorization: `Bearer ${process.env.VIDGEN_API_KEY}` },
})
).json();
if (info.user.credits < 10 || info.limits.dailyVideosRemaining === 0) {
console.warn("tidak layak mengirim batch");
}
info = requests.get(
"https://vidgen.id/api/v1/user/credits",
headers={"Authorization": f"Bearer {api_key}"},
).json()
print(info["user"]["credits"], info["unlimited"], info["limits"])
{
"success": true,
"user": {
"uid": "0f7c9a1e-42b3-4c9a-9d0f-8a3e2b1c5d64",
"email": "saya@tokokamu.com",
"credits": 128
},
"unlimited": {
"active": true,
"daysLeft": 1,
"expiresAt": "2026-11-05T03:41:12.000Z"
},
"limits": {
"maxConcurrentJobs": 2,
"currentActiveJobs": 1,
"dailyVideoLimit": 50,
"dailyVideosGenerated": 12,
"dailyVideosRemaining": 38,
"resetsAt": "00:00 WIB"
}
}
{ "error": "API Key tidak valid atau telah dicabut." }
{ "error": "Vidgen sedang dalam pemeliharaan. Penggunaan API key dinonaktifkan sementara." }