ElevenLabs Text-to-Speech

Generate high-quality speech from text using ElevenLabs API.

Quick Start

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js "Hello there" /tmp/output.mp3

Usage

Basic TTS

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js "<text>" <output_file>

With Voice Selection

job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js "<text>" <output_file> <voice_id>

List Available Voices

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js --list-voices

Configuration

Requires environment variable:

• ELEVENLABS_API_KEY
• ElevenLabs API key

Available Voices

Default voices (get IDs with --list-voices):

• rachel

• Calm, professional female

• drew

• Conversational male

• clive

• Authoritative male

• bella

• Soft female

• antoni

• Versatile male

• charlie

• Energetic male

SSML Support

Use SSML for advanced control:

<speak> <break time="1s"/> Hello there! <break time="500ms"/> How can I help you? </speak>

Output Format

Creates MP3 file at specified path. Returns path on success.

Examples

Generate speech with default voice

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js "Welcome to our service" /tmp/welcome.mp3

Generate with specific voice

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js "This is important" /tmp/alert.mp3 EXAVITQu4vr4xnSDxMaL

List all available voices

/job/.pi/skills/elevenlabs-tts/elevenlabs-tts.js --list-voices

Tips

• Keep text under 5000 characters per request

• Use breaks and pauses for natural speech

• Preview with short clips before generating long audio

• For emotional delivery, use voice-specific prompts in the text

When to Use

• User requests voice message or audio narration

• Creating accessibility audio content

• Generating voice responses for chatbots

• Text-to-speech for notifications