Plans and limits

Your organization’s plan sets two allowances: tokens per billing period, and sessions running at once. Both are tracked per organization and readable from the API. 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

Allowances may change: read the live values from the API instead of hard-coding them.

Token usage

Agents consume tokens as they run. When the period’s allowance runs out, creating a session (or messaging a finished one, which restarts it) fails with 402 Payment Required. Its detail carries limit, used, and window_end. See Errors.

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. `null` if momentarily unavailable.
`remaining`	integer \| null	`max(limit - used, 0)`.
`window_start`	string	Start of the current period (UTC).
`window_end`	string \| null	End of the current period (UTC).

Concurrent sessions

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. See Get quota for the fields.

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
}

Queued sessions

At the limit, a create doesn’t fail: it returns 201 with status queued, and the session starts on its own, oldest first, as slots free up. It then follows the normal lifecycle (queued, pending, running, terminal) and fires a webhook on every transition. Set queue: false on the create body to get a 429 instead.

While queued	Behavior
Messages	Buffered, delivered when the session starts.
Pause / resume	Unavailable (`409`).
Cancel	Dequeues it immediately.
Queue size	Up to 1000 sessions per organization. Beyond that, creates return `429`.
Child sessions	Never queue: a create with `parent_session_id` fails with `429` at capacity, since a child queued behind its own running parent could wait forever.

For batches, fire every task at once, let the platform pace them, and collect results with webhooks.

for product in "Framework 13" "MacBook Air" "ThinkPad X1"; do
  curl -sX POST https://agp.eu.hcompany.ai/api/v2/sessions \
    -H "Authorization: Bearer $HAI_API_KEY" -H "Content-Type: application/json" \
    -d "{\"agent\": \"h/web-surfer-flash\", \"messages\": \"Check price for $product\"}"
done

sessions = [
    client.sessions.create_session(agent="h/web-surfer-flash", messages=f"Check price for {product}")
    for product in products
]

const sessions = await Promise.all(
  products.map((product) =>
    client.sessions.createSession({
      body: { agent: "h/web-surfer-flash", messages: `Check price for ${product}` },
    }),
  ),
);

Managing your subscription

Start a Developer subscription from the billing page in the platform dashboard (card only). Manage your card and invoices through the Stripe billing portal linked from the same page. Cancelling stops the renewal: Developer allowances stay active until the end of the current period, then the organization returns to Free. For higher allowances or an Enterprise plan, contact support@hcompany.ai.

Get started

Concepts

Browser and desktop

Integrations

Guides

Operate

Plans

Token usage

Concurrent sessions

Queued sessions

Managing your subscription

​Plans

​Token usage

​Concurrent sessions

​Queued sessions

​Managing your subscription

Plans

Token usage

Concurrent sessions

Queued sessions

Managing your subscription