text-to-speech

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

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/X-manist/Cohmira --skill text-to-speech-x-manist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: text-to-speech
Source: https://github.com/X-manist/Cohmira/tree/main/src/builtin-plugins/openmontage/.agents/skills/text-to-speech
Command: npx skills add https://github.com/X-manist/Cohmira --skill text-to-speech-x-manist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting written scripts into spoken audio for voiceovers, narration, or podcasts normally requires recording equipment or manual API integration. This Skill provides a direct workflow for generating speech audio files from text through HeyGen's Starfish TTS model, with control over voice, speed, pitch, and locale. ## Core Features & Use Cases - Voice Discovery: List available Starfish-compatible TTS voices filtered by language, gender, and features via GET /v1/audio/voices or the mcp__heygen__list_audio_voices MCP tool. - Speech Generation: Convert text to audio with adjustable speed (0.5-1.5), pitch (-50 to 50), locale selection for multilingual voices, and optional ElevenLabs advanced settings. - Timing Data: Receive word-level timestamps in the response for caption syncing and timed text overlays, plus SSML break tags for inserting pauses. - Use Case: A content creator needs narration for a product demo video. They list voices, pick an English male voice, generate the audio with a 1.1x speed, and use the returned audio_url and word timestamps to sync captions. ## Quick Start Ask the AI to list available HeyGen TTS voices and generate speech audio from your script text using a selected voice.

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. If HeyGen MCP tools are available, use mcp__heygen__text_to_speech instead.

How do I list available TTS voices in HeyGen?

Call GET /v1/audio/voices with your X-Api-Key header to retrieve Starfish-compatible voices with language, gender, and preview URLs. Note this differs from the video voices endpoint GET /v2/voices, since not all video voices support Starfish TTS.

Can I adjust speech speed and pitch in HeyGen TTS?

Yes, the text_to_speech endpoint accepts a speed parameter from 0.5 to 1.5 and a pitch parameter from -50 to 50. Keeping speed between 0.8 and 1.2 produces the most natural-sounding output.

Does HeyGen TTS support pauses and different accents?

Insert pauses using SSML break tags like <break time="1s"/> with spaces around the tag. For accents, set the locale field (e.g., pt-BR), but only on voices where support_locale is true.

What are the limitations of the Starfish TTS voices endpoint?

Not all voices from the video API support Starfish TTS, so you must query /v1/audio/voices specifically. Some voices have null preview_audio_url values, and locale selection only works on multilingual voices.