Plans and limits

Your organization runs on a plan that sets two allowances: how many tokens you can use per billing period, and how many sessions you can run at the same time. Usage is tracked per organization, both allowances are readable from the API at any time, and there are no request-rate limits.

Plans

	Free	Developer
Price	$0	$29 / month
Tokens per billing period	15,000,000	65,000,000
Concurrent sessions	3	10
Resets	Monthly, on your signup day-of-month	Monthly, on your subscription’s billing date

Token and concurrency allowances are subject to change, so read the live values from the API (below) rather than hard-coding the numbers in your integration.

Token usage

Tokens are consumed by the model as your agents run, and they accrue against your plan’s per-period allowance. When the allowance runs out, creating a session (or messaging a finished one, which restarts it) fails with 402 Payment Required. The error’s detail carries your limit, used, and the window_end when the budget resets. See Errors. Check your current token usage with GET /api/v2/quota/tokens:

curl https://agp.eu.hcompany.ai/api/v2/quota/tokens \
  -H "Authorization: Bearer $HAI_API_KEY"

from hai_agents import Client

client = Client()

tokens = client.quota.get_token_quota()
print(tokens.remaining)

import { HaiAgentsClient } from "hai-agents";

const client = new HaiAgentsClient();

const tokens = await client.quota.getTokenQuota();
console.log(tokens.remaining);

Response

{
  "limit": 15000000,
  "used": 4200000,
  "remaining": 10800000,
  "window_start": "2026-06-01T00:00:00Z",
  "window_end": "2026-07-01T00:00:00Z"
}

Field	Type	Description
`limit`	integer \| null	Tokens allowed this period. `null` means unlimited.
`used`	integer \| null	Tokens used so far this period. `null` if the usage figure is momentarily unavailable.
`remaining`	integer \| null	Tokens left (`max(limit - used, 0)`).
`window_start`	string	Start of the current billing period (UTC).
`window_end`	string \| null	End of the current billing period (UTC).

Concurrent sessions

Separately from tokens, your plan caps how many sessions can run at once. A session holds a slot from the moment it leaves queued until it reaches a terminal state, including when you cancel it. Queued sessions hold no slot. GET /api/v2/sessions/quota returns your current concurrency usage:

curl https://agp.eu.hcompany.ai/api/v2/sessions/quota \
  -H "Authorization: Bearer $HAI_API_KEY"

quota = client.sessions.get_session_quota()
print(quota.available)

const quota = await client.sessions.getSessionQuota();
console.log(quota.available);

Response

{
  "scope": "user",
  "limit": 10,
  "active": 3,
  "available": 7
}

See Get quota for the field-by-field reference. At the limit, new sessions are queued and start when a slot frees up. Pass queue: false to get a 429 Too Many Requests instead.

Managing your subscription

Start a Developer subscription from the billing page in the platform dashboard; checkout is card-only. Manage your card and download invoices through the Stripe billing portal, linked from the same page. Cancelling stops the renewal: your Developer allowances stay active until the end of the current billing period, after which the organization reverts to the Free plan.

Need higher limits?

For higher token or concurrency allowances, or an Enterprise plan, contact us at support@hcompany.ai.

Get started

Concepts

Browser

Desktop

Integrations

Guides

Operate

Plans

Token usage

Concurrent sessions

Managing your subscription

Need higher limits?

​Plans

​Token usage

​Concurrent sessions

​Managing your subscription

​Need higher limits?

Plans

Token usage

Concurrent sessions

Managing your subscription

Need higher limits?