Generated banner for Sound Effects
Generated logo for Sound Effects

Sound Effects

ElevenLabsOfficialPublished by ElevenLabs

  • Skill
  • Tool integration
  • Design and creative
  • MIT
  • Medium risk

From the author

Generate sound effects from text descriptions using ElevenLabs. Use when creating sound effects, generating audio textures, producing ambient sounds, cinematic impacts, UI sounds, or any audio that isn't speech. Supports looping, duration control, and prompt influence tuning.
— the description by ElevenLabs

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

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/elevenlabs/sound-effects/download
  2. Unzip 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_KEY isn't set for this project, run npx -y @elevenlabs/cli@latest onboard init from 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.mp3

Parameters

ParameterTypeDefaultDescription
textstring (required)—Description of the desired sound effect
model_idstringeleven_text_to_sound_v2Model 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_secondsnumber | nullnull (auto)Duration 0.5–30s; auto-calculated if null
prompt_influencenumber | null0.3How closely to follow the prompt (0–1)
loopbooleanfalseGenerate 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:

FormatDescription
mp3_44100_128MP3 44.1kHz 128kbps (default)
pcm_44100Raw uncompressed CD quality
opus_48000_128Opus 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

SKILL.md

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_KEY isn't set for this project, run npx -y @elevenlabs/cli@latest onboard init from 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.mp3

Parameters

ParameterTypeDefaultDescription
textstring (required)—Description of the desired sound effect
model_idstringeleven_text_to_sound_v2Model 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_secondsnumber | nullnull (auto)Duration 0.5–30s; auto-calculated if null
prompt_influencenumber | null0.3How closely to follow the prompt (0–1)
loopbooleanfalseGenerate 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:

FormatDescription
mp3_44100_128MP3 44.1kHz 128kbps (default)
pcm_44100Raw uncompressed CD quality
opus_48000_128Opus 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

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