Billing & credits

/docs/billing

Prepaid balance, reserved before every request and settled once token counts are known.

Relixr runs on prepaid credits. Before each upstream call, the estimated cost is reserved against your workspace balance. Once the provider returns actual token counts, the charge is settled to the real amount.

Add Credits

  1. Go to Billing in the dashboard.
  2. Enter an amount, or select a quick pick.
  3. Select Continue and complete payment — card (Lemon Squeezy) or mobile money, where available.
  • Charges settle from prepaid credits using Relixr's then-current model pricing. See relixr.cost on responses when you need a per-request breakdown for reconciliation.
  • 402 insufficient_balance is returned when the reserve for a request would exceed your remaining balance.
  • Credits don't expire. Usage CSV exports include cost fields per line so finance can reconcile down to the request.
Tip

Reserve, not final cost, is what triggers 402 — a request with a high max_tokens reserves against the worst case. If you're hitting 402 on requests that end up cheap, lowering max_tokens to a realistic ceiling frees up headroom without adding credit.

GET /api/workspace/balance
Authorization: Bearer mgk_...

{"balanceUsd": "47.23", "reservedUsd": "0.12"}
Next steps
Errors
The full 402 / 403 / 429 contract.
Supported models
Current per-model pricing.
Was this helpful?

Still stuck? Help center · Doctor