Billing & credits

idlidu.dev is prepaid Bottom-first: buy a credit pack, burn USD on inference, stop at $0. No silent usage padding. Fuel meter: gateway + app Billing.

How money moves

1. Buy an INR or USD pack on app → Billing (PayU).
2. Credits land on your account balance (USD meter).
3. Each chat completion burns 1.5× provider token cost from that balance.
4. Optional key hard limit caps lifetime spend on one idl_ key.

Packs & fees

Fee covers PayU + FX / ops; credited USD is what you can spend on inference. Public pricing: /pricing.

Checkout may be soft-disabled until go-live (CHECKOUT_ENABLED). Health on pay reports readiness; when enabled, pack picker posts to pay.idlidu.dev/v1/checkout/payu with your session cookie.

API keys

• Budget ($ / turn) — default Id turn cap when you omit --budget
• Hard limit ($ lifetime) — gateway refuses burn that would exceed spent + this turn
• Spent — cumulative burn attributed to that key
• Revoke — immediate; mint a new key if needed

Manage at app.idlidu.dev/keys.

Balance alerts

When balance falls to ≤ 15% of your last top-up reference (configurable in Settings), the API returns alerts; the app shows a banner; Id may toast; gateway may attach alert headers / idlidu.alerts. The same percentage applies relative to a key’s hard limit when set.

Local soft monthly cap

Id can warn/stop on a local monthly soft cap (Id soft-cap). That is client-side only — it does not replace account balance or key hard limit. Bypass with --force when you intentionally override.

Honest traces

Prefer Bottom routes and clear $ lines in the CLI. Usage and consented telemetry appear under Usage and Traces.

Pricing · Quickstart · Gateway · Reference