# Usage and limits

URL: https://neattrim.com/docs/usage-and-limits

How API calls draw the allowance, rate limits, and what a 402 means.

One allowance covers the website, the API and MCP. Usage is counted in hours and minutes on two meters: subtitle time and voice and AI time. There are no credits.

## What you get

| Plan | Subtitle time a month | Voice and AI time a month |
| --- | --- | --- |
| Free | 1 hour | 5 minutes |
| Plus | 10 hours | 20 minutes |
| Pro | 50 hours | 2 hours |

Each tool page says which meter a call draws from and how fast. `GET /v1/me` shows your balances and when they reset. Free allowances reset at 00:00 UTC on the 1st. Unused monthly plan time does not roll over. A top-up is valid for 365 days.

## Rate limits

| Caller | Requests a minute | Jobs at once |
| --- | --- | --- |
| No key | 30 | none |
| Test key | 60 | 5 |
| Free account | 60 | 2 |
| Plus account | 60 | 3 |
| Pro account | 60 | 6 |

Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`. A `429 RATE_LIMITED` answer also carries `Retry-After`. Wait that long, then retry.

## When the allowance runs out

A call that would use more than you have left gets `402 LIMIT` with reason `allowance`, the `meter` and `resetsAt`. A call for a paid-only feature gets `402 NEEDS_PLAN`. Neither is charged. Buy a plan or a top-up on the [pricing page](https://neattrim.com/pricing), or wait for the reset.

A job that fails on our side is never charged, and the time held for it is released.

## Check first

Call `POST /v1/estimate` before a large job. The answer says how many seconds the call would draw, from which meter, and whether you may run it.
