Limits and billing
See how Voice Agent minutes are charged, which plan limits apply to each call, and what happens when a limit is reached.
Price
Voice Agent costs 765 credits per minute (12.75 credits per second), billed per started minute. The agent's speech recognition, LLM, and voice are included in that rate. Credit prices and monthly credits depend on your plan:
| Plan | SAR per 1,000 credits | SAR per minute | Minutes in monthly credits |
|---|---|---|---|
| No plan | 0.667 | 0.51 | – |
| Free (5K credits) | – | – | ≈ 6.5 |
| Starter | 0.653 | 0.50 | ≈ 98 (1.6 hr) |
| Basic | 0.600 | 0.46 | ≈ 215 (3.6 hr) |
| Premium | 0.563 | 0.43 | ≈ 392 (6.5 hr) |
| Pro | 0.548 | 0.42 | ≈ 784 (13 hr) |
| Scale | 0.503 | 0.38 | ≈ 1,686 (28 hr) |
Credits are shared with transcription and TTS; the minutes column assumes the whole balance goes to Voice Agent.
How minutes are charged
Voice Agent is billed per started minute. It's billed separately from transcription and TTS, and the agent's own speech recognition, LLM, and voice are included.
| Rule | Detail |
|---|---|
| When a minute is charged | When it starts: the first when the agent joins, then one every 60 seconds. A 135-second call is 3 minutes: charged when the agent joins, then at 60 and 120 seconds, with 3 usage records. |
| Before a call | Your account needs credit billing and enough credit for one minute, or the session request returns 402 CREDITS_EXHAUSTED. This check runs before the plan limits below. |
| During a call | If the next minute can't be paid, you get a credits warning, then the call ends with credits_exhausted when the current minute is over. |
| Not charged | A session nobody joins (user_never_joined), and a join refused for concurrency (concurrency_limit). |
| Usage records | One record per minute, under the API key that started the session. |
Plan limits
HUMAIN Voice sets these limits per plan; you can't change them per request. A limit your plan leaves
unset doesn't apply. Each session returns its call limits in limits
(Response).
| Limit | Applies to | When it's reached |
|---|---|---|
| Concurrent calls | All API keys of the account | The session request returns 429 CONCURRENCY_LIMIT_EXCEEDED. A call that joins while the limit is already full ends with concurrency_limit. |
Maximum call length (max_duration_s) | Each call | A max_duration warning 60 seconds before, then the call ends with max_duration. |
Idle time (idle_timeout_s) | Each call | The call ends with idle_timeout after nobody speaks for that long. |
| Daily minutes | The account | The session request returns 429 RATE_LIMIT_EXCEEDED until the allowance resets at 00:00 UTC. |
| People per call | Each call | One user and the agent. |
Concurrent calls are counted separately from realtime transcription and TTS streams.
Request-size limits and every session error code are in Voice Agent limits and Voice Agent codes.
Session lifecycle
Track a Voice Agent call from connecting to ended, show live transcripts and warnings, send text during the call, and handle every end reason.
LiveKit clients
Join Voice Agent calls from iOS, Android, Flutter, React Native, or LiveKit's React components using the session token your backend returns.