# Create an audiobook

> Turn a book or long document into a finished audiobook in Audio Studio, by hand in the web app or with an AI assistant over MCP, with the check that confirms each step.

## Before starting

- The account needs a plan that includes Audio Studio. See [Pricing](../pricing/index.md).
- Supported documents and 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 |

- Authoring is free. Credits are spent on OCR of scanned pages, optional AI text processing and translation, AI review, and rendering audio.

## In the web app

1. **Create the project.** Audio Studio, **New project**, add the document, choose how text is split into lines and the text processing (Basic, or AI-Enhanced for Standard Arabic).
2. **Check the text.** Open each chapter, fix what the import got wrong, keep lines between 3 and 20 words.
3. **Choose voices.** Set the project voice in **Voice Settings**; give selected lines their own voice or settings where a character speaks.
4. **Test.** Generate a few lines and listen before rendering everything.
5. **Render.** **Merge All** converts the lines without audio and joins the chapter.
6. **Review.** Run AI review, fix flagged lines, regenerate only those lines.
7. **Export.** Download chapters as MP3 or WAV with SRT or VTT, or export everything.

## With an AI assistant (MCP)

The assistant should follow the resource `audio-studio://audiobook-production` from start to end. In outline:

| Step | Tools | Check before moving on |
| --- | --- | --- |
| 1. Ask the user for a production mode: Full Control, Guided (recommended) or Express | | The user has chosen |
| 2. Estimate the whole book | `estimate_book_cost` | The user has seen the estimate |
| 3. Create the project from the document | `create_project` or `create_audiobook` | A `job_ref` is returned; `get_job` reaches `is_terminal` with status `completed` |
| 4. Read the structure | `get_project`, then `get_chapter` for the chapters needed | Chapter and line counts look right |
| 5. Clean and adjust text | `update_lines` in batches | Each item in the response reports success |
| 6. Choose the voice | `list_voices`, `play_voice_sample`, `set_project_voice` | The user heard and approved the voice |
| 7. Render a sample | `generate_lines` on a few lines, `get_job`, `get_line_audio` | The user approved the sample |
| 8. Estimate and render everything | `estimate_project_generation`, then `generate_audio` with `confirm_spend` true after approval | `get_job` is terminal and `completed` |
| 9. Review | `run_ai_qa`, `get_qa_results`, fix with `update_lines`, render with `generate_audio` mode `missing` | No open issues the user cares about |
| 10. Deliver | `merge_chapters_audio`, `merge_chapters_subtitle`, `export_wav`, `get_job_result` | The user has working download links |

Rules for the assistant:

- Show a credit estimate and get the user's approval before every billable call.
- On `INSUFFICIENT_CREDITS`, give the user both links from the error (buy credits, plans) and offer to continue after they top up.
- On `UPGRADE_REQUIRED`, say that Audio Studio is not in their plan, share the plans link, and offer `text_to_speech`, which works on every plan.
- On `CONFIRMATION_REQUIRED` for a very large project, tell the user the chapter count and ask. Pass the confirmation only on a clear yes.
- For Standard Arabic set the language to `ar` and use Arabic Tashkeel. For dialects and other languages keep Basic processing.

## Verify success

- Every chapter reports as converted in `get_project`.
- `get_chapter_audio` returns a URL for each chapter, or `merge_chapters_audio` returns one for the book.
- The user has listened to at least the sample and the first chapter.

## Common problems

| Problem | Cause and fix |
| --- | --- |
| The import produced odd line breaks | The split option did not suit the document. Fix the lines with `update_lines`, or create the project again with another split. |
| A chapter is refused | It exceeds the lines per chapter limit. Split it into two chapters. |
| A line is refused | It exceeds the characters per line limit. Split the line. |
| A word is pronounced wrong | Edit the line (add diacritics or respell), then render only that line. |
| Rendering stopped part way | The balance ran out. Top up, then `generate_audio` with mode `missing` continues where it stopped. |
