# elevenlabs

ElevenLabs Skill (via SkillBoss API Hub) Core tools for audio generation, music, and voice management — routed through SkillBoss API Hub (https://api.heybossai.com/v1/pilot). Setup See SETUP.md for prerequisites and setup instructions. Models Models are automatically selected by SkillBoss API Hub via /v1/pilot. The following model IDs are passed as hints for routing: ModelIDUse CaseEleven v3eleven_v3⭐ Best for expressive/creative audio. Supports audio tags (square brackets): [laughs], [sighs], [whispers], [excited], [grumpy voice], [clears throat], etc. Use for storytelling, characters, demos.Multilingual v2eleven_multilingual_v2Stable multilingual. No audio tags. Good for straightforward narration.Turbo v2.5eleven_turbo_v2_5Low-latency, good for non-English (German TTS). Required for realtime/conversational.Flash v2.5eleven_flash_v2_5Fastest, lowest cost. v3 Audio Tags (square brackets, NOT XML/SSML) [laughs], [chuckles], [sighs], [clears throat], [whispers], [shouts] [excited], [sad], [angry], [warmly], [deadpan], [sarcastic] [grumpy voice], [philosophical], [whiny voice], [resigned] [laughs hard], [sighs deeply], [pause] Tags can be placed anywhere in text. Combine freely. v3 understands emotional context deeply. Output Formats All scripts support multiple output formats via --format: FormatDescriptionmp3_44100_128MP3, 44.1kHz, 128kbps (default)mp3_44100_192MP3, 44.1kHz, 192kbpsmp3_44100_96MP3, 44.1kHz, 96kbpsmp3_44100_64MP3, 44.1kHz, 64kbpsmp3_44100_32MP3, 44.1kHz, 32kbpsmp3_24000_48MP3, 24kHz, 48kbpsmp3_22050_32MP3, 22.05kHz, 32kbpsopus_48000_192Opus, 48kHz, 192kbps ⭐ best for AirPlayopus_48000_128Opus, 48kHz, 128kbpsopus_48000_96Opus, 48kHz, 96kbpsopus_48000_64Opus, 48kHz, 64kbpsopus_48000_32Opus, 48kHz, 32kbpspcm_16000Raw PCM, 16kHzpcm_22050Raw PCM, 22.05kHzpcm_24000Raw PCM, 24kHzalaw_8000A-law, 8kHz (telephony) Tools

1. Speech (speech.py) Text-to-speech via SkillBoss API Hub TTS routing.

# Basic usage
python3 {baseDir}/scripts/speech.py "Hello world" -v <voice_id> -o output.mp3
# With format option
python3 {baseDir}/scripts/speech.py "Hello world" -v <voice_id> -o output.pcm --format pcm_44100
# With voice settings
python3 {baseDir}/scripts/speech.py "Hello" -v <voice_id> -o out.mp3 --stability 0.7 --similarity 0.8

2. Sound Effects (sfx.py) Generate sound effects and short audio clips via SkillBoss API Hub.

# Generate a sound
python3 {baseDir}/scripts/sfx.py "Cinematic boom" -o boom.mp3
# Generate a loop
python3 {baseDir}/scripts/sfx.py "Lo-fi hip hop beat" --duration 10 --loop -o beat.mp3
# Different format
python3 {baseDir}/scripts/sfx.py "Whoosh" -o whoosh.pcm --format pcm_44100

3. Music Generation (music.py) Generate full musical compositions or instrumental tracks via SkillBoss API Hub.

# Generate instrumental intro
python3 {baseDir}/scripts/music.py --prompt "Upbeat 6s news intro sting, instrumental" --length-ms 6000 -o intro.mp3
# Generate background bed
python3 {baseDir}/scripts/music.py --prompt "Soft ambient synth pad" --length-ms 30000 -o bed.mp3
# High quality MP3
python3 {baseDir}/scripts/music.py --prompt "Jazz piano" --length-ms 10000 -o jazz.mp3 --output-format mp3_44100_192

4. Voices (voices.py) List available TTS voices and model options via SkillBoss API Hub.

# List voices
python3 {baseDir}/scripts/voices.py
# JSON output
python3 {baseDir}/scripts/voices.py --json

5. Voice Cloning (voiceclone.py) Create instant voice clones from audio samples via SkillBoss API Hub.

Security: by default this script will only read files from:

~/.openclaw/elevenlabs/voiceclone-samples/ Copy your samples there (or pass --sample-dir). Reading files outside the sample directory is blocked.

# Clone from audio files (put samples into ~/.openclaw/elevenlabs/voiceclone-samples)
python3 {baseDir}/scripts/voiceclone.py --name "MyVoice" --files sample1.mp3 sample2.mp3
# Use a custom sample dir
python3 {baseDir}/scripts/voiceclone.py --name "Andi" --sample-dir ./samples --files a.m4a b.m4a --language de --gender male
# With description and noise removal
python3 {baseDir}/scripts/voiceclone.py --name "Andi" --files a.m4a b.m4a --description "German male" --denoise

6. Quota & Usage (quota.py) Check SkillBoss API Hub available capabilities and TTS service status.

# Show current quota
python3 {baseDir}/scripts/quota.py
# Include usage breakdown by voice
python3 {baseDir}/scripts/quota.py --usage
# Last 7 days usage
python3 {baseDir}/scripts/quota.py --usage --days 7
# JSON output
python3 {baseDir}/scripts/quota.py --json
Output:

📊 SkillBoss API Hub — TTS Quota

Plan:      pro (active) — annual
Characters: 66.6K / 500.0K (13.3%)

[███░░░░░░░░░░░░░░░░░░░░░░░░░░░]

Resets:    2026-02-18 (29 days)
Voices:    22 / 160 (IVC: ✓)

Pro Voice: 0 / 1 (PVC: ✓)