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

# Say

The `<Say>` verb speaks the text specified back to the caller, enabling text-to-speech for any application.

## Attributes

<table>
  <thead>
    <tr>
      <th>ATTRIBUTE</th>
      <th>DESCRIPTION</th>
      <th>OPTIONS</th>
      <th>DEFAULT</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>voice</code></td>
      <td> Optional text-to-speech voice type. For basic text-to-speech use <code>man</code> or <code>woman</code> (en-US only). For premium text-to-speech use <code>alice</code> or one of the following provider-prefixed formats: <code>Polly.VoiceId</code> / <code>Polly.VoiceId-Neural</code> for Amazon Polly, <code>AWS.Polly.VoiceId</code> for direct AWS Polly notation, <code>Azure.VoiceId</code> for Azure TTS (supports <code>gender</code> and <code>effect</code> attributes), <code>ElevenLabs.ModelId.VoiceId</code> for ElevenLabs (requires <code>api\_key\_ref</code>), <code>Telnyx.ModelId.VoiceId</code> for Telnyx native TTS, <code>Resemble.ModelId.VoiceId</code> for Resemble AI, <code>Minimax.ModelId.VoiceId</code> for Minimax, <code>Rime.ModelId.VoiceId</code> for Rime, and <code>Inworld.ModelId.VoiceId</code> for Inworld. </td>
      <td><code>man</code>, <code>woman</code>, <code>alice</code>, <code>Polly.VoiceId</code>, <code>Polly.VoiceId-Neural</code>, <code>AWS.Polly.VoiceId</code>, <code>Azure.VoiceId</code>, <code>ElevenLabs.ModelId.VoiceId</code>, <code>Telnyx.ModelId.VoiceId</code>, <code>Resemble.ModelId.VoiceId</code>, <code>Minimax.ModelId.VoiceId</code>, <code>Rime.ModelId.VoiceId</code>, <code>Inworld.ModelId.VoiceId</code></td>
      <td><code>man</code></td>
    </tr>

    <tr>
      <td><code>language</code></td>
      <td> ISO language type to be used if voice type alice is selected. If man or woman is selected, the language accent will always be en-US. This parameter is ignored when a specific Amazon Polly voice is used. </td>

      <td />

      <td>-</td>
    </tr>

    <tr>
      <td><code>loop</code></td>
      <td> The number of times to repeat the text. 0 means infinite. </td>
      <td><code>0</code> - <code>10</code></td>
      <td><code>1</code></td>
    </tr>

    <tr>
      <td><code>gender</code></td>
      <td> Specifies the gender of the voice. Only applicable when using Azure voices (Azure.\*). </td>
      <td><code>Male</code>, <code>Female</code></td>
      <td>-</td>
    </tr>

    <tr>
      <td><code>effect</code></td>
      <td> Applies an audio effect to the spoken text. Only applicable when using Azure voices (Azure.\*). </td>
      <td><code>eq\_telecomhp8k</code>, <code>eq\_car</code></td>
      <td>-</td>
    </tr>

    <tr>
      <td><code>voiceSpeed</code></td>
      <td> Speech rate for the voice. Must be a decimal between 0.1 and 2.0. Defaults to 1. </td>
      <td><code>0.1</code> - <code>2.0</code></td>
      <td><code>1</code></td>
    </tr>

    <tr>
      <td><code>api\_key\_ref</code></td>
      <td> Reference to the API key for authentication with the TTS provider. The key must be stored via the [integration secrets API](/api-reference/integration-secrets/create-a-secret). Used with ElevenLabs and Azure voices. </td>

      <td />

      <td>-</td>
    </tr>

    <tr>
      <td><code>region</code></td>
      <td> Cloud region to use with the TTS provider. Required for Azure voices when using a custom API key. </td>

      <td />

      <td>-</td>
    </tr>

    <tr>
      <td><code>pronunciationDictId</code></td>
      <td> UUID of a pronunciation dictionary to apply to the spoken text. </td>

      <td />

      <td>-</td>
    </tr>

    <tr>
      <td><code>languageBoost</code></td>
      <td> Language hint for Telnyx Qwen3TTS voices. Accepted as full names (Auto, English, German, Chinese, French, Italian, Japanese, Korean, Portuguese, Russian, Spanish) or ISO 639-1 codes (en, de, zh, fr, it, ja, ko, pt, ru, es). </td>

      <td />

      <td>-</td>
    </tr>
  </tbody>
</table>

## Examples

```xml theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="alice">This is a premium Amazon Polly text-to-speech message!</Say>
</Response>
```