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

# Natural

> Telnyx Natural is a low-latency English text-to-speech model backed by Rime Mist, designed for real-time voice agents and conversational applications.

**Voice format:** `Telnyx.Natural.<voice>`

Pre-built English voices backed by Rime Mist.

## Voice Samples

| Voice                    | Gender | Sample                                                                 |
| ------------------------ | ------ | ---------------------------------------------------------------------- |
| `Telnyx.Natural.allison` | Female | <audio controls src="/audio/tts-samples/telnyx-natural-allison.mp3" /> |
| `Telnyx.Natural.brook`   | Female | <audio controls src="/audio/tts-samples/telnyx-natural-brook.mp3" />   |

***

## WebSocket

### Query Parameters

```
wss://api.telnyx.com/v2/text-to-speech/speech?voice=Telnyx.Natural.allison&audio_format=mp3
```

| Parameter      | Type    | Default | Description                                     |
| -------------- | ------- | ------- | ----------------------------------------------- |
| `audio_format` | string  | `mp3`   | `mp3`, `linear16`.                              |
| `sample_rate`  | integer | `24000` | 8000, 16000, 22050, 24000, 44100, 48000, 96000. |

### Voice Settings

Send in the init frame (`{"text": " "}`):

| Field         | Type  | Default | Description             |
| ------------- | ----- | ------- | ----------------------- |
| `voice_speed` | float | `1.0`   | Speech rate multiplier. |

```json theme={null}
{
  "text": " ",
  "voice_settings": {
    "voice_speed": 1.2
  }
}
```

## REST API

### Fields

| Field         | Type   | Default         | Description                                      |
| ------------- | ------ | --------------- | ------------------------------------------------ |
| `voice_speed` | float  | `1.0`           | Speech rate multiplier.                          |
| `output_type` | string | `binary_output` | `binary_output`, `base64_output`, or `audio_id`. |

### Response

Default (`binary_output`): chunked audio bytes with `Content-Type: audio/mpeg` (or `audio/wav`, `audio/pcm`).

With `output_type: "base64_output"`: JSON with base64-encoded audio.

With `output_type: "audio_id"`: JSON with an `audio_url` for deferred retrieval.
