> ## 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.

# Resemble TTS provider

> Configure Resemble AI as a text-to-speech provider on Telnyx using your own Resemble API key, with voice cloning and custom voice support.

**Voice format:** `resemble.Turbo.<VoiceId>`

Default model: `Turbo`. `voice_id` is a voice from **your own Resemble account**.

## Voice Samples

| Voice                         | Language | Gender | Sample                                                                |
| ----------------------------- | -------- | ------ | --------------------------------------------------------------------- |
| `Resemble.Turbo.Aaron_en-US`  | en-US    | Male   | <audio controls src="/audio/tts-samples/resemble-turbo-aaron.mp3" />  |
| `Resemble.Turbo.Amelia_en-US` | en-US    | Female | <audio controls src="/audio/tts-samples/resemble-turbo-amelia.mp3" /> |

***

## WebSocket

### Query Parameters

| Parameter      | Type    | Default | Description                              |
| -------------- | ------- | ------- | ---------------------------------------- |
| `audio_format` | string  | `mp3`   | `mp3`, `wav`.                            |
| `sample_rate`  | integer | `48000` | 8000, 16000, 22050, 32000, 44100, 48000. |

### Voice Settings

| Field         | Type   | Default                       | Description                                                                     |
| ------------- | ------ | ----------------------------- | ------------------------------------------------------------------------------- |
| `format`      | string | `mp3`                         | `mp3` or `wav`.                                                                 |
| `precision`   | string | `PCM_32`                      | `PCM_16`, `PCM_24`, `PCM_32`, `MULAW`.                                          |
| `sample_rate` | string | `48000` (mp3) / `16000` (wav) | `8000`, `16000`, `22050`, `32000`, `44100`, `48000`. Default depends on format. |

```json theme={null}
{
  "text": " ",
  "voice_settings": {
    "format": "wav",
    "precision": "PCM_16",
    "sample_rate": "22050"
  }
}
```

## REST API

### Fields

| Field         | Type   | Default           | Description                                      |
| ------------- | ------ | ----------------- | ------------------------------------------------ |
| `format`      | string | `mp3`             | `mp3` or `wav`.                                  |
| `precision`   | string | `PCM_32`          | `PCM_16`, `PCM_24`, `PCM_32`, `MULAW`.           |
| `sample_rate` | string | `48000` / `16000` | Sample rate. Default depends on format.          |
| `output_type` | string | `binary_output`   | `binary_output`, `base64_output`, or `audio_id`. |

### Response

Default (`binary_output`): chunked audio bytes.

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

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