Music¶

Generate music from text prompts.

v0.13.0 API Change

As of v0.13.0, Music methods are accessed via client.Content() instead of client.Music().

Basic Usage¶

audio, err := client.Content().GenerateMusic(ctx, "upbeat electronic music for a tech video")
if err != nil {
    log.Fatal(err)
}

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

Full Options¶

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

resp, err := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:            "calm piano melody with soft strings",
    DurationMs:        30000,  // 30 seconds
    ForceInstrumental: true,   // No vocals
    Seed:              12345,  // For reproducibility
})
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Song ID: %s\n", resp.SongID)

f, _ := os.Create("calm_piano.mp3")
io.Copy(f, resp.Audio)

Instrumental Only¶

Ensure the generated music has no vocals:

audio, err := client.Content().GenerateMusicInstrumental(ctx,
    "epic orchestral music for movie trailer",
    60000,  // 60 seconds
)

Streaming¶

For real-time playback:

resp, err := client.Content().GenerateMusicStream(ctx, &content.MusicRequest{
    Prompt:     "lofi hip hop beats",
    DurationMs: 120000,  // 2 minutes
})

Request Options¶

Option	Type	Description
`Prompt`	string	Text description of the music
`DurationMs`	int	Duration in milliseconds (3000-600000)
`ForceInstrumental`	bool	Ensure no vocals
`Seed`	int	For reproducible generation

Response Structure¶

type MusicRequest struct {
    Prompt            string
    DurationMs        int
    ForceInstrumental bool
    Seed              int
}

type MusicResponse struct {
    Audio  io.Reader // Generated music
    SongID string    // Unique identifier
}

Duration Guidelines¶

Duration	Use Case
3-10 seconds	Sound logos, jingles
10-30 seconds	Intro/outro music
30-60 seconds	Background music
1-5 minutes	Full tracks
5-10 minutes	Extended ambient

Prompt Examples¶

By Genre¶

// Electronic
"upbeat EDM with synthesizers and heavy bass drops"
"ambient electronic music with soft pads"
"retro 80s synthwave with arpeggios"

// Orchestral
"epic cinematic orchestra with brass and strings"
"soft classical piano solo"
"dramatic film score with timpani"

// Modern
"lofi hip hop beats to study to"
"indie folk with acoustic guitar"
"jazz trio with piano bass and drums"

// Ambient
"peaceful nature soundscape with birds"
"space ambient with ethereal pads"
"meditation music with singing bowls"

By Mood¶

// Energetic
"high energy workout music with driving beat"
"exciting action music for video games"
"uplifting pop rock anthem"

// Calm
"relaxing spa music with soft piano"
"gentle lullaby for sleep"
"peaceful morning coffee music"

// Dramatic
"tense thriller soundtrack"
"emotional sad piano piece"
"triumphant victory fanfare"

By Use Case¶

// Video Content
"YouTube intro music, modern and catchy, 10 seconds"
"podcast background music, subtle and professional"
"tutorial video music, friendly and upbeat"

// Business
"corporate presentation background music"
"hold music, pleasant and non-intrusive"
"product launch reveal music"

// Gaming
"RPG exploration theme, adventurous"
"boss battle music, intense and fast"
"game menu music, mysterious ambient"

Use Cases¶

Video Intro Music¶

intro, err := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:            "modern tech startup intro jingle, professional and innovative",
    DurationMs:        8000,  // 8 seconds
    ForceInstrumental: true,
})

Podcast Background¶

background, err := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:            "subtle podcast background music, warm and conversational",
    DurationMs:        300000,  // 5 minutes
    ForceInstrumental: true,
})

Course Content¶

// Intro music
intro, _ := client.Content().GenerateMusicInstrumental(ctx,
    "educational video intro, friendly and engaging", 5000)

// Transition music
transition, _ := client.Content().GenerateMusicInstrumental(ctx,
    "soft transition sound, brief whoosh with melody", 2000)

// Background for explanations
background, _ := client.Content().GenerateMusicInstrumental(ctx,
    "thinking music, curious and light", 60000)

Game Audio¶

// Menu theme
menuTheme, _ := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:     "fantasy RPG main menu theme, epic and adventurous",
    DurationMs: 120000,
    Seed:       42,  // Reproducible for version control
})

// Battle music
battleMusic, _ := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:            "intense battle music, fast drums and aggressive strings",
    DurationMs:        90000,
    ForceInstrumental: true,
})

Reproducible Generation¶

Use seeds for consistent results:

// Generate same music twice
seed := 12345

music1, _ := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:     "calm acoustic guitar",
    DurationMs: 30000,
    Seed:       seed,
})

music2, _ := client.Content().GenerateMusicWithOptions(ctx, &content.MusicRequest{
    Prompt:     "calm acoustic guitar",
    DurationMs: 30000,
    Seed:       seed,
})

// music1 and music2 will be identical

Best Practices¶

Be specific - "upbeat jazz piano trio" vs just "jazz"
Include tempo hints - "fast", "slow", "moderate tempo"
Specify instruments - "acoustic guitar and violin" for precise results
Use ForceInstrumental - When you don't want any vocals
Test with seeds - Find good seeds and save them for consistency
Match duration to use case - Don't generate 5 minutes for a 10-second intro