API · Reference
Limits & pricing
What the API allows, and what a session costs.
Pricing
| Price | Counted | |
|---|---|---|
| Conversation session | $0.03 per minute | From start to stop, rounded up to the whole minute |
| Render-mode session | $0.025 per minute | From start to stop, rounded up to the whole minute |
| Premium voices | Per character spoken | On top of the minutes; the free voices cost nothing extra |
The API uses the same account and balance as the console. Paid accounts pay from a prepaid balance (from $20, credits never expire); the free plan includes 60 minutes a month. See pricing.
Rate limits
| Limit | Value | Past it |
|---|---|---|
| Requests per key | 120 a minute | 429 |
| New sessions per account | 20 a minute | 429 rate_limited |
| Active keys per account | 10 | Revoke one to make another |
Sessions
| Rule | Value |
|---|---|
| Sessions per agent at once | The agent's concurrency_limit (you set it). Past it: 409 concurrency_limit. |
| Opening the player | Within about 90 seconds; a session nobody watches for 90 seconds is ended. |
| Length | No limit on paid accounts: a session runs until you stop it. |
| Render mode: audio waiting to play | At most 120 seconds; more is refused with queue_full. |
| Render mode: text per message | Up to 5000 characters. |
Free plan
| Limit | Value |
|---|---|
| Minutes | 60 a month |
| Session length | 5 minutes; the session then ends on its own |
| Sessions at once | 1 |
| Agents | 1 |
| Voices | Free voices (kokoro), in 8 languages |
Adding funds in the console lifts every free-plan limit at once. A limit reached through the API answers
402; see Errors.