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

# Text to Speech

> Generate Speech by providing a text input along with a pre trained voice.

## Request

Make a `POST` request to below endpoint and pass the required parameters as a request body.

```curl curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
--request POST 'https://modelslab.com/api/v1/enterprise/text_to_speech/make' \
```

## Emotion Support

> [!NOTE]
>
> Emotion support is currently only available in English (`en`) language. When emotion is enabled, you can use special tags in your text prompt to add expressive elements to the generated speech.

### Available Emotion-Supported Voices

#### Female Voices

* Tara
* Leah
* Jess
* Mia
* Zoe

#### Male Voices

* Leo
* Dan
* Zac

#### Supported Emotion Tags

> [!TIP]
>
> The following emotion tags can be added to speech prompts to enhance expressiveness:

| Tag | Description |
| - | - |
| `<laugh>` | Adds a laughing effect |
| `<chuckle>` | A soft chuckle for a subtle humorous tone |
| `<sigh>` | Expresses disappointment, relief, or tiredness |
| `<cough>` | Simulates a short cough |
| `<sniffle>` | Mimics a sniffle, indicating sadness or a cold |
| `<groan>` | Adds a groaning effect for frustration or discomfort |
| `<yawn>` | Simulates yawning to express boredom or tiredness |
| `<gasp>` | Expresses shock or surprise |

## Body

```json json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{    
    "key": "enterprise_api_key",
    "prompt":"Build next-generation AI products without worrying about GPUs",
    "language":"american english",
    "voice_id":"madison",
    "speed":1,
    "emotion":false
}
```

## Body Attributes

**key** `string` *required*

API key for authentication.

**prompt** `string` *required* (default: 2500 Chars)

Text prompt describing audio to be generate Max len `2500` chars.

**voice\_id** `string` *required*

ID of trained voice
[Find Pretrained Voices Here](https://modelslab.com/trained-voice-lists?utm_source=docs.modelslab.com\&utm_medium=referral\&utm_campaign=docs\&utm_content=enterprise-api-text-to-speech-text-to-speech).

**language** `string` (default: english)

Language for the voice.\
Allowed values: `american english`, `british english`, `spanish`, `japanese`, `mandarin chinese`, `french`, `brazilian portuguese`, `hindi`, `italian`.

**speed** `number` (default: 1.0)

Playback speed of generated audio.

**emotion** `boolean` (default: false)

Enable emotion support (English only).

**temp** `boolean` (default: false)

Use temporary links valid for 24 hours.

**webhook** `string`

URL to receive POST notification upon completion.

**track\_id** `integer`

ID for webhook identification.


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