Check account balance
Use this endpoint to check the paid and promotional credits associated with your API key. Authenticate with `Authorization: Bearer <apiKey>`. Use `spendable_paid_credits` to see the paid balance available for any request. Promotional credits can be limited to the provider and model combinations in `promotion_grants.targets`, so check each grant's `eligible` and `expires_at` values before relying on it. A `state` of `exhausted` means no balance is currently available for requests. One credit equals $0.000001. You can call this endpoint even when the balance is zero.
/account/balanceUse this endpoint to check the paid and promotional credits associated with your API key. Authenticate with Authorization: Bearer <apiKey>. Use spendable_paid_credits to see the paid balance available for any request. Promotional credits can be limited to the provider and model combinations in promotion_grants.targets, so check each grant's eligible and expires_at values before relying on it. A state of exhausted means no balance is currently available for requests. One credit equals $0.000001. You can call this endpoint even when the balance is zero.
Authorization
BearerAuth Tenant key supplied as the Authorization Bearer token.
In: header
Response Body
application/json
application/json
application/json
const response = await fetch("https://api.allmodels.io/account/balance", { headers: { Authorization: `Bearer ${process.env.ALLMODELS_API_KEY}` }});if (!response.ok) throw new Error(`AllModels request failed: ${response.status}`);console.log(await response.json());import osimport requestsresponse = requests.get( "https://api.allmodels.io/account/balance", headers={"Authorization": f"Bearer {os.environ['ALLMODELS_API_KEY']}"}, timeout=30,)response.raise_for_status()print(response.json())curl https://api.allmodels.io/account/balance \ -H "Authorization: Bearer $ALLMODELS_API_KEY"{ "state": "ok", "paid_credits": 1250000, "spendable_paid_credits": 1250000, "promotional_credits": 500000, "paid_balance_usd": 1.25, "updated_at": "2026-07-21T12:00:00Z", "promotion_grants": [ { "name": "Welcome credits", "remaining_credits": 500000, "remaining_usd": 0.5, "expires_at": "2026-08-31T23:59:59Z", "eligible": true, "targets": [ { "provider": "elevenlabs", "model": "elevenlabs/eleven-turbo-v2-5" } ] } ]}{ "error": "invalid_request"}{ "error": "invalid_request"}Create a link to add account balance POST
Create a secure payment link for adding prepaid balance to the account associated with your API key. Authenticate with `Authorization: Bearer <apiKey>` and provide the amount in `amount_usd`. Open the returned `url` in a browser or send it to the person who manages account funding. After payment succeeds, the account balance updates automatically.
Get API-key usage GET
Returns daily usage for the authenticating API key only. Usage events are persisted asynchronously and may take a short time to appear.