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

# Text to Speech

> Convert text to speech with configurable voice and delivery

The **Text to Speech** (TTS) node converts text into spoken audio and plays it to the caller in real time.

## Behavior

* Sends text to the configured TTS provider
* Streams the synthesized audio to the caller
* Supports variable interpolation in the text (e.g., `{{customer_name}}`)
* Emits `TTS.END` on completion or `TTS.ERROR` on failure

## Configuration

| Parameter  | Type   | Default                 | Range / Options                         | Description                                               |
| ---------- | ------ | ----------------------- | --------------------------------------- | --------------------------------------------------------- |
| `text`     | string | `""`                    | —                                       | The text to speak. Supports `{{variable}}` interpolation. |
| `provider` | enum   | `"ElevenlabsTTSConfig"` | Provider-specific                       | TTS provider to use                                       |
| `model`    | enum   | `"eleven_flash_v2_5"`   | Model-specific                          | TTS model identifier                                      |
| `voice`    | string | `"default"`             | —                                       | Voice identifier                                          |
| `voiceId`  | string | `""`                    | —                                       | Specific voice ID from the provider                       |
| `language` | string | `"en"`                  | —                                       | Language code (e.g., `en`, `en-US`, `es`)                 |
| `speed`    | number | `1.0`                   | 0.5–2.0                                 | Speech rate multiplier                                    |
| `pitch`    | number | `1.0`                   | 0.5–2.0                                 | Speech pitch multiplier                                   |
| `emphasis` | enum   | `"moderate"`            | `none`, `moderate`, `strong`, `reduced` | Emphasis level for speech delivery                        |

## Output handles

| Handle    | Description                                                 |
| --------- | ----------------------------------------------------------- |
| **End**   | Speech playback completed — flow continues to the next node |
| **Error** | TTS generation or playback failed                           |

## Use cases

<AccordionGroup>
  <Accordion title="Dynamic greeting">
    Set `text` to `"Hello {{customer_name}}, thank you for calling."` after looking up the caller in a Database node.
  </Accordion>

  <Accordion title="Slow-paced instructions">
    Set `speed: 0.8` for complex instructions that callers need time to process.
  </Accordion>

  <Accordion title="Multi-language support">
    Use a Switch on language preference, then route to separate TTS nodes with matching `language` and `voiceId` configurations.
  </Accordion>
</AccordionGroup>