# Limits

> Current limits of the Moknah API, Audio Studio and file uploads (text length, requests and credits per minute, concurrency, file sizes), and what happens when one is reached.

The tables on this page are read from the code that enforces the limits when the page is served.

## API limits

| Limit | Value |
| --- | --- |
| REST text to speech, characters per request | 1,500 |
| Streaming text to speech, characters per text chunk | 2,000 |
| REST speech to text, audio file size | 50 MB |
| Streaming speech to text, audio chunk size | 256,000 bytes |
| Requests per minute (default for a new API key) | 60 |
| Credits per minute (default for a new API key) | 10,000 |
| REST text to speech requests in progress per account | 1 |
| Open streams per account, per streaming service | 1 |
| Article to Speech requests per client IP | 100 per minute |
| Article to Speech articles generating at once per company | 2 |

Notes:

- Requests per minute and credits per minute are settings of each API key. The values above are the defaults of a new key. To raise them, write to sales@moknah.io.
- Both per-minute limits are counted per account, across all of its keys.
- Credits per minute applies to the REST endpoints. A request that would pass the limit is refused before any work is done.
- An API key can also have a total credit limit of its own; when it is reached the key stops working.

### One request at a time

- REST text to speech runs one request per account at a time. A second request sent while one is running gets `429 CONCURRENT_REQUEST`.
- Each streaming service allows one open stream per account. A second connection is closed with code `4290`.
- After a stream ends unexpectedly, wait about 15 seconds before reconnecting.

For many short texts in a row, open one text to speech stream and send them over it. The stream is not subject to the requests per minute limit.

### When a limit is reached over REST

The response is `429` with these headers:

| Header | Meaning |
| --- | --- |
| `Retry-After` | Seconds to wait before retrying. |
| `RateLimit-Reset` | Unix time when the limit resets. |

A `402` for insufficient credits carries `Moknah-Credits-Remaining` and `Moknah-Credits-Used`. Successful responses carry no rate limit headers.

### Retrying

Retry `429` and `5xx` responses with exponential backoff: wait the `Retry-After` value when present, otherwise 1, 2, 4, 8 seconds. Do not retry `400`, `401`, `402`, `403` or `422` without changing something.

## Audio Studio limits

| Limit | Value |
| --- | --- |
| Characters per line | 1,500 |
| Lines per chapter | 200 |
| Chapters per project before an explicit confirmation is required | 500 |
| Document types | doc, docx, pdf, epub, xlsx, xls, txt |
| Document size | 50 MB |

A document import splits chapters that are too long automatically. Through MCP, `update_lines` accepts up to 200 edits per call.

## Upload limits

| Limit | Value |
| --- | --- |
| Speech to Text, audio file | 50 MB |
| Speech to Text, video file | 200 MB |
| Speech to Text, subtitle file (SRT or VTT) | 2 MB |
| Voice Cloning, recordings per voice | 1 to 5 |
| Voice Cloning, size per recording | 50 MB |
| Voice Cloning, an unused clone is deleted after | 7 days |
| Voice Changer, audio file | 50 MB |
| Dubbing, video or audio file | 100 MB |
| PDF to Word, PDF file | 50 MB |

## Text to speech formats

- MP3: `mp3_22050_32`, `mp3_24000_48`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `mp3_44100_128`, `mp3_44100_192`
- PCM (raw 16-bit little-endian mono, no header): `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_32000`, `pcm_44100`, `pcm_48000`
- Opus (Ogg container): `opus_48000_32`, `opus_48000_64`, `opus_48000_96`, `opus_48000_128`, `opus_48000_192`
- WAV (16-bit mono, REST only): `wav_16000`, `wav_22050`, `wav_24000`, `wav_44100`, `wav_48000`

Default for REST: `mp3_44100_128`. Default for streaming: `pcm_24000`.

## Limits that depend on the plan

- Which tools an account can use, and its monthly credits: see [Pricing](../pricing/index.md).
- How many voices an account can clone: shown on the clone page of the web app.
