Sound Effects¶

Generate sound effects from text descriptions.

v0.13.0 API Change

As of v0.13.0, Sound Effects methods are accessed via client.Audio() instead of client.SoundEffects().

Basic Usage¶

audio, err := client.Audio().GenerateSoundEffect(ctx, "thunder and rain storm")
if err != nil {
    log.Fatal(err)
}

f, _ := os.Create("thunder.mp3")
io.Copy(f, audio)

Full Control¶

import "github.com/plexusone/elevenlabs-go/audio"

resp, err := client.Audio().GenerateSoundEffectWithOptions(ctx, &audio.SoundEffectRequest{
    Text:            "car engine starting and revving",
    DurationSeconds: 5.0,      // 0.5 to 30 seconds
    PromptInfluence: 0.5,      // 0.0 to 1.0
    OutputFormat:    "mp3_44100_128",
})

Looping Sound Effects¶

Create seamlessly looping audio for backgrounds:

audio, err := client.Audio().GenerateSoundEffectLoop(ctx,
    "gentle rain on window",
    10.0,  // duration in seconds
)

Request Options¶

Option	Range	Description
`Text`	required	Description of the sound effect
`DurationSeconds`	0.5-30	Target duration (auto if not set)
`PromptInfluence`	0.0-1.0	How closely to follow the prompt
`Loop`	bool	Create seamless loop
`OutputFormat`	string	Audio format

Prompt Influence¶

Low (0.0-0.3): More variation, creative interpretation
Medium (0.3-0.6): Balanced (default: 0.3)
High (0.6-1.0): Strictly follows prompt

Example Prompts¶

Nature¶

"gentle rain on a tin roof"
"thunderstorm with distant lightning"
"ocean waves on a beach"
"wind blowing through trees"
"birds chirping in a forest"

Urban¶

"busy city traffic"
"car horn honking"
"subway train arriving"
"crowd murmuring in a cafe"

Technology¶

"computer keyboard typing"
"notification chime"
"sci-fi door opening"
"robot powering up"

Music/Transitions¶

"dramatic orchestral hit"
"soft piano transition"
"whoosh transition sound"
"upbeat intro jingle"

Use Cases¶

Course Production¶

// Intro sound
intro, _ := client.Audio().GenerateSoundEffect(ctx, "professional podcast intro jingle")

// Transition
transition, _ := client.Audio().GenerateSoundEffect(ctx, "soft whoosh transition")

// Background ambience (looping)
ambience, _ := client.Audio().GenerateSoundEffectLoop(ctx, "quiet office ambience", 30)

Video Production¶

// Action sounds
punch, _ := client.Audio().GenerateSoundEffect(ctx, "punch impact sound")

// Ambient backgrounds
forest, _ := client.Audio().GenerateSoundEffectLoop(ctx, "peaceful forest ambience", 60)

Best Practices¶

Be specific - "car engine starting cold" vs just "car"
Include context - "footsteps on wooden floor" vs "footsteps"
Use loops for backgrounds - Enables seamless repetition
Test prompt influence - Adjust based on desired creativity