Skip to main content

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.

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

​
Attributes

ATTRIBUTEDESCRIPTIONOPTIONSDEFAULT
voice Optional text-to-speech voice type. For basic text-to-speech use man or woman (en-US only). For premium text-to-speech use alice or one of the following provider-prefixed formats: Polly.VoiceId / Polly.VoiceId-Neural for Amazon Polly, AWS.Polly.VoiceId for direct AWS Polly notation, Azure.VoiceId for Azure TTS (supports gender and effect attributes), ElevenLabs.ModelId.VoiceId for ElevenLabs (requires api_key_ref), Telnyx.ModelId.VoiceId for Telnyx native TTS, Resemble.ModelId.VoiceId for Resemble AI, Minimax.ModelId.VoiceId for Minimax, Rime.ModelId.VoiceId for Rime, and Inworld.ModelId.VoiceId for Inworld. man, woman, alice, Polly.VoiceId, Polly.VoiceId-Neural, AWS.Polly.VoiceId, Azure.VoiceId, ElevenLabs.ModelId.VoiceId, Telnyx.ModelId.VoiceId, Resemble.ModelId.VoiceId, Minimax.ModelId.VoiceId, Rime.ModelId.VoiceId, Inworld.ModelId.VoiceIdman
language 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. -
loop The number of times to repeat the text. 0 means infinite. 0 - 101
gender Specifies the gender of the voice. Only applicable when using Azure voices (Azure.*). Male, Female-
effect Applies an audio effect to the spoken text. Only applicable when using Azure voices (Azure.*). eq_telecomhp8k, eq_car-
voiceSpeed Speech rate for the voice. Must be a decimal between 0.1 and 2.0. Defaults to 1. 0.1 - 2.01
api_key_ref Reference to the API key for authentication with the TTS provider. The key must be stored via the integration secrets API. Used with ElevenLabs and Azure voices. -
region Cloud region to use with the TTS provider. Required for Azure voices when using a custom API key. -
pronunciationDictId UUID of a pronunciation dictionary to apply to the spoken text. -
languageBoost 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). -

​
Examples

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