Skip to main content
A task costs $0.013, on every model, with every enrichment included. A test key is free.

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.
Read the balance with GET /v1/balance:

Charges and refunds

  • A task is charged when it is created. The price is in costMicros on 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: 402 with the code insufficient_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.
When the state changes, the owners and admins get an email, and your webhook endpoints get 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.