Credits & Billing

All generations consume credits from your account. Credits come from your subscription plan, credit packs, and redemptions.

Check Balance

GET /api/v1/account/credits

curl

curl https://api.kolbo.ai/api/v1/account/credits \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

async function main() {
  const response = await fetch("https://api.kolbo.ai/api/v1/account/credits", {
    headers: { "X-API-Key": "YOUR_API_KEY" }
  });
  const data = await response.json();
  console.log(data.credits.total);
}
main();

Python

import requests

response = requests.get(
    "https://api.kolbo.ai/api/v1/account/credits",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json()["credits"]["total"])

Response

{
  "success": true,
  "credits": {
    "total": 1500,
    "plan_credits": 1000,
    "credit_pack": 400,
    "redemption": 100
  }
}

Credit Types

Type	Source	Behavior
`plan_credits`	Monthly subscription	Reset each billing cycle
`credit_pack`	One-time purchases	Never expire
`redemption`	Gift codes, promotions	Never expire

Credit Deduction

Credits are deducted when a generation starts. If a generation fails, credits are automatically refunded.

Deduction Order

Plan credits (used first)
Credit pack credits
Redemption credits

Insufficient Credits

If you don't have enough credits, the generation endpoint returns:

{
  "success": false,
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS"
}

Getting More Credits

Upgrade your plan at kolbo.ai/pricing
Purchase credit packs from your dashboard
Use promo code KOLBO30 for 30% off

On this page