> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs Voiceover v3 - Expressive Text-to-Speech API

> Generate expressive voiceovers with the ElevenLabs v3 model. Direct the performance with inline audio tags, up to 5,000 characters per request, MP3 output.

> [card] Powered by ElevenLabs
>
> This API runs the ElevenLabs v3 text-to-speech model. Direct the delivery with audio tags such as `[excited]`, `[whispers]` or `[pause 1s]`.

ElevenLabs v3 is ElevenLabs' expressive text-to-speech model. It reads emotion and intent from the text and follows inline audio tags, so you can direct a line to sound excited, whispered or interrupted by laughter. Each request generates one MP3 from up to 5,000 characters.

### Key capabilities

* **Audio tags**: Cues in square brackets (`[excited]`, `[whispers]`, `[laughs]`, `[pause 1s]`) are performed, not read aloud
* **Text length**: 1 to 5,000 characters per request
* **Voice customization**: `stability` and `similarity_boost` (0-1)
* **Multi-language**: UTF-8 text, including accented letters and non-Latin scripts
* **Output**: one MP3 file (44.1 kHz, 128 kbps)
* **Async processing**: Webhook notification or polling for task completion

### Use cases

* **Narration with emotion**: Ads, trailers and stories that need excitement, whispers or laughter on cue
* **Character voices**: Games, animation and audio drama with a distinct delivery per line
* **Video production**: Voiceovers for marketing videos, tutorials and social media content
* **E-learning and accessibility**: Expressive audio versions of written material

### API operations

Create a voiceover with the POST endpoint, then track it with the list and status endpoints. Generation returns a task ID for async polling or webhook notification.

> [card] [POST /v1/ai/voiceover/elevenlabs-v3](https://docs.magnific.com/api-reference/voiceover/elevenlabs-v3/generate.md)
>
> Create a new voiceover task

> [card] [GET /v1/ai/voiceover/elevenlabs-v3](https://docs.magnific.com/api-reference/voiceover/elevenlabs-v3/elevenlabs-v3-tasks.md)
>
> List all ElevenLabs v3 voiceover tasks

> [card] [GET /v1/ai/voiceover/elevenlabs-v3/\{task-id}](https://docs.magnific.com/api-reference/voiceover/elevenlabs-v3/task-by-id.md)
>
> Get task status and results by ID

### Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `text` | `string` | Yes | - | Text to convert to speech, with optional audio tags (1-5,000 characters) |
| `voice_id` | `string` | Yes | - | ElevenLabs voice ID (letters, digits, `_` and `-`) |
| `stability` | `number` | No | `0.5` | `0.0` Creative (most expressive), `0.5` Natural, `1.0` Robust (most consistent). Any value from 0 to 1 is accepted |
| `similarity_boost` | `number` | No | `0.75` | How closely the output matches the original voice (0-1) |
| `webhook_url` | `string` | No | - | URL for async status notifications |

## Frequently Asked Questions

> [accordion] What is ElevenLabs v3 and how does it work?
>
> ElevenLabs v3 is an expressive text-to-speech model from ElevenLabs. You send `text` and a `voice_id`, receive a task ID immediately, then poll the task endpoint or configure a `webhook_url`. When the task completes, `generated` contains the URL of the MP3 file.

> [accordion] How do audio tags work?
>
> Write the cue in square brackets where it should happen, for example `[excited] We did it! [laughs]` or `Wait... [pause 1s] here it comes`. The model performs the tag instead of reading it aloud. Tags are part of `text`, so they count towards the character limit and the price.

> [accordion] Which stability should I use?
>
> ElevenLabs v3 works with three settings: `0.0` (Creative) is the most expressive and follows audio tags most strongly, `0.5` (Natural) is balanced and closest to the original voice, and `1.0` (Robust) is the most consistent but responds less to tags.

> [accordion] How much does ElevenLabs v3 cost?
>
> It is billed per started block of 10 characters of `text`, audio tags and spaces included: 1 to 10 characters is one block, 11 to 20 two blocks, and so on. The other parameters do not change the price. See the [Pricing page](https://docs.magnific.com/pricing.md) for current rates.

> [accordion] What is the difference between ElevenLabs v3 and ElevenLabs v4?
>
> [ElevenLabs v4](https://docs.magnific.com/api-reference/voiceover/elevenlabs-v4/overview.md) is the newer model and accepts up to 10,000 characters per request. Both take the same parameters and audio tags, at the same price per 10 characters.

> [accordion] How do I find voice IDs?
>
> Voice IDs identify each voice in the ElevenLabs voice library. A common example is `21m00Tcm4TlvDq8ikWAM` (Rachel, a calm, professional female voice).

> [accordion] What are the rate limits for ElevenLabs v3?
>
> Rate limits depend on your subscription tier. See [Rate Limits](https://docs.magnific.com/ratelimits.md) for current limits.

## Best practices

* **Direct with tags, not adjectives**: `[whispers]` changes the delivery; "she said quietly" is just read
* **Keep tags short and close to the words** they affect
* **Write numbers and acronyms as you want them spoken** when the pronunciation matters
* **Production integration**: Use `webhook_url` instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[ElevenLabs v4](https://docs.magnific.com/api-reference/voiceover/elevenlabs-v4/overview.md)**: The newest ElevenLabs model, up to 10,000 characters
* **[ElevenLabs Voiceover Turbo v2.5](https://docs.magnific.com/api-reference/voiceover/overview.md)**: Fast speech synthesis with speed control, up to 40,000 characters
* **[ElevenLabs Sound Effects](https://docs.magnific.com/api-reference/sound-effects/overview.md)**: Generate sound effects from text descriptions


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.