Billing and limits

Fund API usage, configure spend alerts, and understand the capacity applied to requests.

API Platform billing is organization-wide. The organization’s available balance funds billable Production requests across its projects. Manual purchases add funding to that balance, and purchase records preserve the funding history. Members with billing management permission can buy credits and manage payment and tax details.

Read your available credits

Use an admin API key with the Read billing (billing_read) capability (or all capabilities, *) to read the organization’s spendable credits across all projects:

curl https://api.quiver.ai/v1/organization/balance \
  -H "Authorization: Bearer $QUIVER_API_KEY"

{
  "object": "organization.balance",
  "organization_id": "org_example",
  "available_credits": 1234.567,
  "observed_at": 1780000000
}

available_credits is a JSON number with up to three fractional digits. Very large balances may lose floating-point precision. It converts the same Available funding used by API Platform Billing from USD funding to credits: pending reservations, expired funding, and refunded credits are excluded. Contract pricing is already reflected in funded credits. observed_at is the Unix timestamp in seconds when the balance was measured. The response is a snapshot, may change immediately, and is sent with Cache-Control: no-store. An unfunded organization returns 0. Project keys cannot use this endpoint. Admin keys have no Test or Production environment. Reading the balance is unbilled and does not trigger automatic top-up. The organization’s request-rate limit applies; excess polling returns 429.

Request charges

Token-priced requests reserve $1 of prepaid balance before dispatch. Once a non-streaming response or terminal streaming event provides validated usage, the API Platform settles the actual token charge and releases unused funds. The reservation is not an extra fee, an estimate, or a maximum charge.

If output was delivered but final usage evidence is missing, the reserved balance remains held while the charge is reconciled. The API Platform does not cancel that hold or substitute guessed usage. Each request in a Responses tool loop is charged separately.

See Pricing for model rates and a worked example.

Automatic top-up

After an eligible Production request reserves funding, automatic top-up checks the remaining available balance. If it is below the chosen threshold, automatic top-up begins a purchase for the configured funding amount. Insufficient balance is handled separately, so enabling automatic top-up does not guarantee that an underfunded request can continue. A daily maximum limits how many automatic top-ups can begin in one UTC day, and a saved default payment method is required before automatic top-up can be enabled.

Monthly budget

A monthly budget compares the organization’s estimated calendar-month spend with a chosen amount. When a check detects a newly reached threshold, it sends an email for the highest reached threshold: 50%, 75%, or 100%. If spend passes more than one threshold between checks, lower skipped thresholds do not send separate emails.

Budget spend is an operational estimate. Use billing records and invoices as the record of charges.

Request capacity

API traffic is subject to capacity assigned to the organization and project. Capacity can come from the organization’s usage tier, an enterprise contract, or an explicit override.

• Request rate limits total requests over a time window.
• Operation throughput limits related capabilities or a specific model operation.
• Input and output token rates limit measured-token traffic, across the organization or for one capability, such as Responses.
• Project overrides can lower the organization request-rate, input-token, or output-token ceiling for a project; they do not increase an organization ceiling.

A model without its own ceiling uses the broader applicable capability or organization limit. Several independently enforced ceilings can apply to the same request. A capacity rejection’s headers identify the scope and dimension that rejected it.

See Errors and debugging for 429 handling and API pricing for billing models.