Sound Effects
ElevenLabsOfficialPublished by ElevenLabs
- Skill
- Tool integration
- Design and creative
- MIT
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides an interface for the ElevenLabs text-to-sound-effects service. It allows users to generate audio assets such as ambient textures, UI sounds, and cinematic impacts directly from text prompts. The integration supports various configuration options, including duration control, prompt influence tuning, and seamless looping, and is accessible via Python, JavaScript, or the command line.
What it does
- Converts text descriptions into audio sound effects
- Supports custom duration settings between 0.5 and 30 seconds
- Allows tuning of prompt influence to control adherence to the input text
- Enables generation of seamlessly looping audio files
- Provides multiple output formats including MP3, PCM, Opus, and WAV
- Offers SDKs for Python and JavaScript as well as a command-line interface
When to use it
- When you need to generate ambient background sounds for media projects
- When creating custom UI notification chimes or interaction sounds
- When producing cinematic sound design elements from descriptive text
- When automating the creation of audio assets within a software pipeline
Advantages
- Flexible control over audio duration and prompt adherence
- Supports a wide range of audio output formats for different technical requirements
- Consistent API usage across CLI, Python, and JavaScript environments
- Native support for generating looping audio assets
Usage examples
- “Generate a 10-second looping forest ambient sound.”
- The agent uses the ElevenLabs client to generate a 10-second audio file of forest ambiance with the loop parameter enabled.
- “Create a short UI notification sound.”
- The agent generates a 1-second audio clip based on the description of a soft notification chime with high prompt influence.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/elevenlabs/sound-effects/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip sound-effects.zip -d .agents/skills
Documentation by ElevenLabs
ElevenLabs Sound Effects
Generate sound effects from text descriptions — supports looping, custom duration, and prompt adherence control.
Setup, before writing any code: if
ELEVENLABS_API_KEYisn't set for this project, runnpx -y @elevenlabs/cli@latest onboard initfrom the app's folder first and follow what it prints: it signs the user in and stores a key for the project, so nobody copies one by hand. Otherwise see the Installation Guide. For JavaScript, use@elevenlabs/*packages only.
Quick Start
Python
from elevenlabs import ElevenLabs
client = ElevenLabs()
audio = client.text_to_sound_effects.convert(
text="Thunder rumbling in the distance with light rain",
model_id="eleven_text_to_sound_v3",
)
with open("thunder.mp3", "wb") as f:
for chunk in audio:
f.write(chunk)JavaScript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import { createWriteStream } from "fs";
const client = new ElevenLabsClient();
const audio = await client.textToSoundEffects.convert({
text: "Thunder rumbling in the distance with light rain",
modelId: "eleven_text_to_sound_v3",
});
audio.pipe(createWriteStream("thunder.mp3"));CLI
elevenlabs text-to-sound-effects convert \
--text "Thunder rumbling in the distance with light rain" \
--model-id eleven_text_to_sound_v3 \
--output thunder.mp3Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
text | string (required) | — | Description of the desired sound effect |
model_id | string | eleven_text_to_sound_v2 | Model to use. Set eleven_text_to_sound_v3 (SFX v3) explicitly: it follows multi-part prompts more closely, handles music and vocals better, and sounds more natural |
duration_seconds | number | null | null (auto) | Duration 0.5–30s; auto-calculated if null |
prompt_influence | number | null | 0.3 | How closely to follow the prompt (0–1) |
loop | boolean | false | Generate a seamlessly looping sound |
Examples with Parameters
# Looping ambient sound, 10 seconds
audio = client.text_to_sound_effects.convert(
text="Gentle forest ambiance with birds chirping",
model_id="eleven_text_to_sound_v3",
duration_seconds=10.0,
prompt_influence=0.5,
loop=True,
)
# Short UI sound, high prompt adherence
audio = client.text_to_sound_effects.convert(
text="Soft notification chime",
model_id="eleven_text_to_sound_v3",
duration_seconds=1.0,
prompt_influence=0.8,
)Output Formats
Pass --output-format (CLI) or output_format as an SDK parameter:
| Format | Description |
|---|---|
mp3_44100_128 | MP3 44.1kHz 128kbps (default) |
pcm_44100 | Raw uncompressed CD quality |
opus_48000_128 | Opus 48kHz 128kbps — efficient compressed |
ulaw_8000 | μ-law 8kHz — telephony |
Full list: mp3_22050_32, mp3_24000_48, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_32000, pcm_44100, pcm_48000, wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192.
Prompt Tips
Be specific: "Heavy rain on a tin roof" > "Rain"
Combine elements: "Footsteps on gravel with distant traffic"
Specify style: "Cinematic braam, horror" or "8-bit retro jump sound"
Mention mood/context: "Eerie wind howling through an abandoned building"
Error Handling
try:
audio = client.text_to_sound_effects.convert(text="Explosion")
except Exception as e:
print(f"API error: {e}")Common errors:
401: Invalid API key
422: Invalid parameters (check duration range, prompt_influence range)
429: Rate limit exceeded
References
Files
- ATTRIBUTION.mdAdded by AutoGineer810 B
- LICENSELicence file added by AutoGineer1.0 KiB
- SKILL.md4.5 KiB
- references/installation.md2.2 KiB
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs an API key, Needs Python, Needs Node.js
The author says: Requires internet access and an ElevenLabs API key (ELEVENLABS_API_KEY).
Security
What our scanner noticed· Medium risk
- Instructions that use the network
- Downloads piped into a shell
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- ElevenLabs
- Publisher
- ElevenLabs (Official)
- Source
- elevenlabs/skills · sound-effects · commit 9763c39
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by ElevenLabs or ElevenLabs.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download sound-effects.zip