API reference/Balance & usage
Balance, Requests & Usage
Query the account balance, request records, usage summary, and key details with the current API key.
These endpoints query the current API key, using either Bearer or x-api-key. Production API keys are isolated by key id: requests made with key A do not appear when querying with key B, even when both keys belong to the same account. Request records only accept page; the server fixes page size at 20 records.
On this pageexpand_more
Account Balancelink
/v1/dashboard/balanceReturns the account-level balance for the account that owns the current API key. Multiple keys in the same account share this balance; it is not a separate per-key balance. A procurement-order key returns that order's prepaid available, reserved, and settled amounts, with source: "market_order".
Request Recordslink
/v1/requests?page=1Returns paginated request records from the last 90 days for the current API key. The server fixes page size at 20 records, so clients cannot change it with limit. Public fields include request ID, model, status, timestamps, tokens, cost, API key name, and masked key.
Usage Summarylink
/v1/usageAggregates request count, success and failure count, total cost, input tokens, and output tokens for the current API key. The scope matches /v1/requests.
API Key Infolink
/v1/keyReturns cumulative and rolling daily, weekly, and monthly usage plus the current key limit and remaining amount.