Skip to content
renderkit
Core conceptsCredits & billing

Credits & billing

Usage is metered in credits. One meter spans all three primitives — no per-product pricing, no separate invoices. Your plan grants a monthly credit allowance.

Credit weights

PrimitiveCredits per render
Screenshot1
Extract1
PDF2

When you are — and aren't — charged

  • Charged once per successful render at the weight above.
  • Not charged when a render fails — the reservation is refunded automatically.
  • Not charged on a cache hit — cached: true renders cost 0 credits.

Reserve-before-render

Credits are reserved with an atomic conditional decrement before the engine call, then refunded on any failure or cache hit. Two concurrent renders can never push your balance negative, even at high request rates.

Checking your balance

Read your live balance from `GET /v1/me` (data.credits) or chart consumption with `GET /v1/usage`.

data.credits
{ "limit": 25000, "used": 3120, "remaining": 21880 }

Out of credits

When your balance hits zero, renders return 429 QUOTA_EXCEEDED. Upgrade your plan or wait for the monthly reset. Rate limiting (429 RATE_LIMIT_EXCEEDED) is separate — see Rate limits.

Documentation