Prepaid balance
Your organization pays from a prepaid balance in USD:- Trial. The first card you add gives a $1.00 credit, once per organization. Nothing is charged on the card.
- Top-ups. Top up in the dashboard, under Billing. A top-up is $5 or more. Each top-up gets an invoice.
GET /v1/balance:
Charges and refunds
- A task is charged when it is created. The price is in
costMicroson the task. - A task that fails is refunded in full. The task then has
refunded: true. - A balance too low for a task refuses it:
402with the codeinsufficient_balance. Nothing is charged.
Amounts are micro-dollars
Every amount is an integer of micro-dollars: 1 USD = 1,000,000.
Integers keep sums exact. Divide by 1,000,000 only to show a value.
Low balance alerts
alertState is ok, low or depleted:
low: the balance is under your organization’s threshold. Set it in the dashboard.depleted: the balance cannot pay for one more task.
balance.low or balance.depleted. See Webhooks.
Control the spend
- Give each key a total or monthly budget. See Budgets.
- Read the spend by day, model and key with
GET /v1/usage. It counts live tasks only.