text-to-speech

Generate speech audio from text using HeyGen's Starfish TTS API.

61.3k|7.8k|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/calesthio/OpenMontage --skill text-to-speech-calesthio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: text-to-speech
Source: https://github.com/calesthio/OpenMontage/tree/main/.claude/skills/text-to-speech
Command: npx skills add https://github.com/calesthio/OpenMontage --skill text-to-speech-calesthio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting written scripts into spoken audio for voiceovers, narration, or podcasts requires a TTS service with voice selection and tuning controls, and wiring up the HeyGen audio endpoints correctly (voice listing, request fields, break tags) is repetitive work. ## Core Features & Use Cases - Voice Discovery: List Starfish-compatible TTS voices via GET /v1/audio/voices, filtered by language, gender, and locale support. - Speech Generation: Convert text to audio with POST /v1/audio/text_to_speech, controlling speed (0.5-1.5), pitch (-50 to 50), locale, and ElevenLabs settings. - Timing & Pauses: Use SSML-style <break time="1s"/> tags for pauses and word-level timestamps from the response for caption syncing. - Use Case: Write a product demo narration script, pick a warm English voice, insert break tags before key contrasts, and generate a WAV file with word timestamps for timed subtitle overlays. ## Quick Start Generate a speech audio file from the text "Welcome to our product demo" using an English HeyGen TTS voice at normal speed.

Frequently Asked Questions about text-to-speech

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert text to speech with the HeyGen API?▼

Send a POST request to https://api.heygen.com/v1/audio/text_to_speech with your text and a voice_id, authenticated via the X-Api-Key header. The response returns an audio_url, duration, and word timestamps.

How do I list available HeyGen TTS voices?▼

Call GET /v1/audio/voices with your X-Api-Key header to retrieve Starfish-compatible voices. Each voice includes language, gender, preview audio URL, and flags for pause and locale support.

Can I use HeyGen video voices for text-to-speech?▼

Not all video voices from GET /v2/voices support Starfish TTS. Use GET /v1/audio/voices instead, which returns only voices compatible with the standalone audio generation endpoint.

How do I add pauses to HeyGen text-to-speech audio?▼

Insert SSML-style break tags directly in the text, such as word <break time="1s"/> word, with spaces around the self-closing tag. Check that the voice's support_pause flag is true before relying on breaks.

What speed and pitch ranges does HeyGen TTS support?▼

Speed accepts values from 0.5 to 1.5 with a default of 1, and pitch accepts integers from -50 to 50 with a default of 0. Keeping speed between 0.8 and 1.2 produces more natural-sounding output.