Skip to content

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 ​

  1. 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_credits and no provider is called. If it covers the input and some output, the request's output limit is lowered to fit.
  2. After the response, you're charged the actual cost and the rest of the reservation is returned.
  3. 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.