Skip to main content
API usage is metered in credits, drawn from your BudgetPixel account balance.

​
You pay only for success

Credits are charged when a job reaches succeeded. You are not charged for:
  • jobs that fail or timeout,
  • the time a job spends queued or processing,
  • requests rejected before generation (e.g. invalid input, content policy).

​
Per-model pricing

Each model has a published price, returned by GET /v1/models:
  • Images are priced per generation (credits_per_generation).
  • Video is priced per second (credits_per_unit with unit_type: second), so total cost scales with length_seconds.
API requests are metered at each model’s standard price. Consumer subscription perks — free daily generations, free-for-tier models, and subscription discounts — do not apply to API traffic.

​
Checking your balance

curl https://api.budgetpixel.com/v1/account/credits \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY"

{
  "total_available": 148885,
  "monthly_remaining": 126275,
  "monthly_limit": 130000,
  "monthly_used": 3725,
  "extra_credits": 22610
}
total_available is what you can spend right now (monthly remaining plus any purchased extra credits). If a request would exceed your available balance, it’s rejected before the job is created.