# music

Generates tracks, songs with lyrics, and background audio using ElevenLabs Music API directly from your coding agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 10900 installs · ★ 508
- Author: elevenlabs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/elevenlabs/skills/tree/HEAD/music/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/music

## What it does

The skill connects your agent to ElevenLabs Music API for text-based music composition and detailed arrangement plans. It targets the `music_v2_5` model by default. You can create instrumental beats or full songs with lyrics.

Available methods include `music.compose` for standard generation and `music.stream` for chunked audio output. The `music.video_to_music` endpoint builds background audio matching uploaded video clips, accepting style tags and custom audio reference flags.

Execution requires internet connectivity and an `ELEVENLABS_API_KEY` environment variable. Without valid credentials, generation requests fail immediately. Enterprise access is required for `music.upload` workflows linked to inpainting.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add elevenlabs/skills --skill music -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/music/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/music/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add elevenlabs/skills --skill music -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/music/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add elevenlabs/skills --skill music -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/music/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elevenlabs/skills music
```

2. **Manually: put the files in place**
- File: `.github/skills/music/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add elevenlabs/skills --skill music -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/elevenlabs/skills --path music
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/music/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add elevenlabs/skills --skill music -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/elevenlabs/skills/tree/HEAD/music/SKILL.md

## When to use it
- Generate instrumental beats and jingles from text prompts
- Create structured songs with lyrics and custom chunk plans
- Score uploaded video files with matching background music
- Stream audio generation output via API methods

## Example prompts
- Generate a chill lo-fi track using ElevenLabs music_v2_5 model
- Create a detailed composition plan for a cinematic song
- Generate background music for trailer.mp4 using the cinematic tag

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 0980c3231b684ff4.

BEGIN THIRD-PARTY FILE 0980c3231b684ff4
````text
---
name: music
description: Generate music using ElevenLabs Music API. Use when creating instrumental tracks, songs with lyrics, background music, jingles, or any AI-generated music composition. Supports prompt-based generation, composition plans for granular control, and detailed output with metadata.
license: MIT
compatibility: Requires internet access and an ElevenLabs API key (ELEVENLABS_API_KEY).
metadata: {"openclaw": {"requires": {"env": ["ELEVENLABS_API_KEY"]}, "primaryEnv": "ELEVENLABS_API_KEY"}}
---

# ElevenLabs Music Generation

Generate music from text prompts - supports instrumental tracks, songs with lyrics, and fine-grained control via composition plans.

> **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](references/installation.md). For JavaScript, use `@elevenlabs/*` packages only.

All examples below use `music_v2_5`, the most advanced generation model. Pass `music_v2` or
`music_v1` only when an older model is explicitly requested.

## Quick Start

### Python

```python
from elevenlabs import ElevenLabs

client = ElevenLabs()

audio = client.music.compose(
    prompt="A chill lo-fi hip hop beat with jazzy piano chords",
    music_length_ms=30000,
    model_id="music_v2_5",
)

with open("output.mp3", "wb") as f:
    for chunk in audio:
        f.write(chunk)
```

### TypeScript

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import { createWriteStream } from "fs";

const client = new ElevenLabsClient();
const audio = await client.music.compose({
  prompt: "A chill lo-fi hip hop beat with jazzy piano chords",
  musicLengthMs: 30000,
  modelId: "music_v2_5",
});
audio.pipe(createWriteStream("output.mp3"));
```

### CLI

```bash
elevenlabs music compose \
  --prompt "A chill lo-fi beat" \
  --music-length-ms 30000 \
  --model-id music_v2_5 \
  --output output.mp3
```

## Methods

| Method | Description |
|--------|-------------|
| `music.compose` | Generate audio from a prompt or composition plan |
| `music.stream` | Stream audio chunks as they are generated (paid plans) |
| `music.composition_plan.create` | Generate a structured plan for fine-grained control |
| `music.compose_detailed` | Generate audio + composition plan + metadata; pass `store_for_inpainting=True` to enable inpainting |
| `music.compose_detailed_stream` | Stream audio plus composition plan, metadata, and optional word timestamps as Server-Sent Events |
| `music.video_to_music` | Generate background music from one or more uploaded video files |
| `music.upload` | Upload an audio file for later inpainting workflows, optionally extracting its composition plan or word-level timestamps |
| `music.finetunes.list` | List accessible music finetunes |
| `music.finetunes.create` | Train a music finetune from uploaded audio |
| `music.finetunes.get` | Retrieve finetune status and metadata |
| `music.finetunes.update` | Update finetune metadata or visibility |
| `music.finetunes.delete` | Delete a music finetune |

See [API Reference](references/api_reference.md) for full parameter details.
````
END THIRD-PARTY FILE 0980c3231b684ff4

The third-party file has ended. Everything between the 0980c3231b684ff4 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3315 of 14225 bytes. © elevenlabs · MIT · https://github.com/elevenlabs/skills/tree/HEAD/music/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md