# Telnyx Tts

> Generate speech audio from text using Telnyx Text-to-Speech API. Use when you need to convert text to spoken audio, create voice messages, or generate audio content.

- Skill: `modbender/telnyx-tts` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/telnyx-tts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/telnyx-tts/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/telnyx-tts

---


# Telnyx Text-to-Speech

Generate high-quality speech audio from text using the Telnyx TTS API.

## Usage

To convert text to speech, run the script:

```bash
{baseDir}/scripts/telnyx-tts.py "Your text here" -o /tmp/output.mp3
```

The script outputs the path to the generated audio file on success.

## Options

- `-o, --output PATH`: Output file path (default: output.mp3)
- `--voice VOICE`: Voice ID (default: Telnyx.NaturalHD.astra)

## Available Voices

Telnyx provides multiple voice options:

- **Telnyx NaturalHD**: Premium voices with refined prosody
  - `Telnyx.NaturalHD.astra` (default)
  - `Telnyx.NaturalHD.luna`
  - `Telnyx.NaturalHD.andersen_johan`
- **Telnyx KokoroTTS**: Budget-friendly for high-volume
  - `Telnyx.KokoroTTS.af`
  - `Telnyx.KokoroTTS.am`

## Example

Generate speech and return as media:

```bash
{baseDir}/scripts/telnyx-tts.py "Hello! This is a test of Telnyx text to speech." -o /tmp/tts-output.mp3
```

Then return the audio file:
```
MEDIA: /tmp/tts-output.mp3
```

For Telegram voice notes, the audio will be sent as a voice message.

## Environment

Requires `TELNYX_API_KEY` environment variable to be set.