Billing & Limits

Billing and Credits

Free trial, credit costs, wallet top-ups, auto top-up, settlement formula, and BYOK billing bypass.

10 minUpdated 2026-02-15
Summary

Free trial, credit costs, wallet top-ups, auto top-up, settlement formula, and BYOK billing bypass.

7 deep-dive sections0 code samples
Quick Start
  1. Set top-up and minimum credit policy.
  2. Enable per-user and per-key rate limits.
  3. Test 429 + retry behavior in staging.
  4. Monitor charged credits consistency in Usage.

Billing principle

Users are billed in credits, not raw provider token costs. One dollar buys 100 credits.

  • Mode-level default charge is fixed per request (reserved upfront)
  • After the request completes, a settlement step reconciles actual provider cost
  • Wallet balance is shown in /credits
  • Paid credits never expire

Free trial

Every new account receives 40 free credits on signup. Free credits expire after 7 days. Once expired, unused free credits are removed and the account moves to free_expired status. Purchase any credit pack to unlock your account — paid credits have no expiry.

Default charges

ModeDefault chargeTypical use
Chat1 creditSingle-model or auto chat
Compare3 creditsParallel model comparison
Blend4 creditsSynthesis workflow
Judge5 creditsContest + judge scoring
Mesh1 creditFailover routing

How settlement works

Credits are reserved before the request starts, then settled after the real provider cost is known:

Reserve → Execute → Settle
1
Reserve
Deduct default credits upfront
2
Execute
Send request to model provider
3
Settle
Compare actual cost to reserved amount
4
Adjust
Charge more or refund the difference

If the actual provider cost (plus margin) exceeds the reserved credits, additional credits are charged. If it costs less, the difference is refunded. All adjustments appear as separate transactions in your history.

Top-up flow

Minimum top-up is $10. Maximum single top-up is $10,000.

Checkout to wallet crediting
1
Create checkout
POST /api/v1/credits/purchase
2
Pay in Stripe
Customer completes checkout
3
Webhook settle
POST /api/webhooks/stripe
4
Refresh balance
GET /api/v1/credits/balance

Auto top-up

Enable automatic refills so requests never fail due to low balance:

  1. Complete one Stripe checkout to save a payment method
  2. Enable auto top-up in /settings and set your preferred amount
  3. Set a balance threshold — when credits drop below it, a top-up is triggered
  4. Set a monthly spending cap to control costs

Auto top-ups are processed as off-session Stripe PaymentIntents using your saved payment method. Monthly spending is tracked and capped to prevent runaway charges.

BYOK (Bring Your Own Key)

When a BYOK provider key is configured, requests route directly to the provider using your key. BYOK requests skip credit charges entirely — you pay the provider directly. This is useful when customer contracts require provider-direct billing.

Free models

Some models in the catalog are marked as free. Requests to free models also skip the credit charge.

Docs Assistant

ChatKit-style guided help

Product-scoped assistant for LLMWise docs and API usage. It does not answer unrelated topics.

Sign in to ask implementation questions and get runnable snippets.

Sign in to use assistant
Previous
Blend Strategies & Orchestration Algorithms
Next
Rate Limits and Reliability