Appearance
Billing & credits
Usefully is prepaid. You buy credits, and each request draws on them at the provider's price.
- Your first organization gets $1 of free credit (once per person).
- Pay in your currency: US dollars or Indian rupees. The dashboard and website show prices in US dollars by default (you can switch to rupees). Credits are always kept in US dollars: a rupee purchase is converted at the rate shown before you pay.
- Purchases are about $5–$10,000 (₹ limits are shown in the dashboard), paid in the Billing page through a secure Dodo Payments checkout. A 3.5% fee is added (so $100 of credit costs $103.50), and sales tax may be added depending on your country. Receipts and invoices are emailed by Dodo Payments.
- Credits appear within a few seconds of a successful payment.
- Token prices are passed through unchanged; see
GET /v1/models.
How a request is charged
- Before calling a provider, Usefully reserves the request's worst-case cost (input plus maximum output). If your balance can't cover it, you get
402 insufficient_creditsand no provider is called. If it covers the input and some output, the request's output limit is lowered to fit. - After the response, you're charged the actual cost and the rest of the reservation is returned.
- Failed requests are not charged.
Low-balance alert
A low-balance email goes to owners and billing members when the balance drops below your alert threshold, which you set in Billing. The same event is available as a webhook. Automatic top-up isn't available yet.
Refunds
Refunds remove the refunded share of the purchased credits. Contact support to request one.
Over the API
With a key that has the billing scope: GET /v1/billing (balance and settings), POST /v1/billing/checkout with {"amount": 1000, "currency": "INR"} (returns a checkout URL to open; currency is USD, INR or EUR), and PUT /v1/billing/settings (the alert threshold).
GET /v1/currencies (no key needed) lists the currencies, their rates per US dollar, suggested amounts and limits.