Audio Generation
Generate audio using generate_media with mode="audio". Supports speech (TTS), music, and sound effects. ElevenLabs is preferred when available, with OpenAI as fallback.
Quick Start
# Text-to-speech (auto-selects ElevenLabs if key available)
generate_media(prompt="Hello, welcome to our presentation!", mode="audio")
# With specific voice
generate_media(prompt="Hello!", mode="audio", voice="Rachel")
# Music generation (ElevenLabs only)
generate_media(prompt="Upbeat jazz piano with soft drums", mode="audio",
audio_type="music", duration=30)
# Sound effects (ElevenLabs only)
generate_media(prompt="Thunder rolling across a mountain valley", mode="audio",
audio_type="sound_effect", duration=5)Audio Types
| Type | Backends | Description |
|---|---|---|
"speech" (default) | ElevenLabs, OpenAI | Text-to-speech with voice selection |
"music" | ElevenLabs only | Music generation from text prompt |
"sound_effect" | ElevenLabs only | Sound effect generation |
"voice_conversion" | ElevenLabs only | Change voice of existing audio (speech-to-speech) |
"audio_isolation" | ElevenLabs only | Remove background noise, isolate vocals |
"voice_design" | ElevenLabs only | Create a new synthetic voice from text description |
"voice_clone" | ElevenLabs only | Clone a voice from audio samples |
"dubbing" | ElevenLabs only | Translate and dub audio to another language |
Backend Comparison
| Backend | Default Model | Supports | API Key |
|---|---|---|---|
| ElevenLabs (priority 1) | eleven_multilingual_v2 | Speech, music, SFX | ELEVENLABS_API_KEY |
| OpenAI (priority 2) | gpt-4o-mini-tts | Speech only | OPENAI_API_KEY |
If ElevenLabs TTS fails, the system automatically falls back to OpenAI TTS.
Key Parameters
| Parameter | Description | Example |
|---|---|---|
prompt | Text to speak (speech) or description (music/SFX) | "Hello world!" |
voice | Voice name or ID | "Rachel", "nova", "alloy" |
audio_type | Type of audio | "speech", "music", "sound_effect" |
duration | Length in seconds (music/SFX only) | 30 |
instructions | Speaking style (OpenAI gpt-4o-mini-tts only) | "warm, reflective tone" |
audio_format | Output format | "mp3", "wav", "opus" |
Voice Quick Reference
ElevenLabs (top voices):
| Voice | Character |
|---|---|
| Rachel | Warm, conversational female |
| Sarah | Clear, professional female |
| Josh | Friendly male |
| Adam | Deep, authoritative male |
| Emily | Bright, energetic female |
OpenAI voices: alloy, echo, fable, onyx, nova, shimmer, coral, sage
Important: prompt vs instructions
For speech, prompt is the literal text to speak. Style guidance goes in instructions:
# CORRECT: prompt = text to speak, instructions = how to speak it
generate_media(
prompt="Welcome to the annual report presentation.",
mode="audio",
voice="alloy",
instructions="warm, reflective tone with measured pacing",
backend_type="openai"
)
# WRONG: Don't put style instructions in prompt
generate_media(prompt="Say this warmly: Welcome...", mode="audio") # Bad!instructions only works with OpenAI gpt-4o-mini-tts. ElevenLabs uses voice selection for tone.
Audio Understanding
Use read_media (not generate_media) to analyze existing audio:
read_media(path="recording.mp3", prompt="Transcribe and summarize this audio")Need More Control?
- Full ElevenLabs voice catalog (28+ voices): See references/voices.md
- Music and sound effects details: See references/music_and_sfx.md
- Advanced audio capabilities (voice conversion, cloning, isolation, dubbing): See references/advanced.md