Skill: kalvinrv/elevenlabs-music-generation (version 0.1.0)

--- name: elevenlabs-music-generation displayName: "🎵 ElevenLabs AI Music Generation — Pro Pack on RunComfy" description: > Generate full songs and instrumental tracks with ElevenLabs Music on RunComfy via the `runcomfy` CLI. ElevenLabs Music turns a style description plus structured lyrics into studio-quality 44.1 kHz stereo audio — 5 seconds to 5 minutes — with section-level control (Intro / Verse / Chorus / Bridge), multilingual vocals, and commercial-friendly output. Generate a backing track, a full vocal song, a jingle, a podcast intro, a game loop, or an instrumental bed. Calls `runcomfy run elevenlabs/elevenlabs/music-generation` through the local RunComfy CLI. Triggers on "generate music", "make a song", "AI music", "background music", "instrumental track", "ElevenLabs Music", "soundtrack", "jingle", "theme music", "royalty-free music", "compose", or any explicit ask to generate music or a song from a text description. emoji: "🎵" homepage: https://www.runcomfy.com license: MIT clawdis: requires: bins: - runcomfy env: - RUNCOMFY_TOKEN config: - ~/.config/runcomfy --- # 🎵 ElevenLabs AI Music Generation — Pro Pack on RunComfy Generate full songs and instrumental tracks from a text description — studio-quality 44.1 kHz stereo, 5 seconds to 5 minutes, with section-level structure control. ElevenLabs Music on the **RunComfy Model API**, called through the `runcomfy` CLI. [runcomfy.com](https://www.runcomfy.com/?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) · [ElevenLabs Music model](https://www.runcomfy.com/models/elevenlabs/elevenlabs/music-generation?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) · [CLI docs](https://docs.runcomfy.com/cli/introduction?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) ## Powered by the RunComfy CLI ```bash # 1. Install (one of — see runcomfy-cli skill for details) npm i -g @runcomfy/cli # global install npx -y @runcomfy/cli --version # zero-install # 2. Sign in runcomfy login # or in CI: export RUNCOMFY_TOKEN=<token> # 3. Generate music runcomfy run elevenlabs/elevenlabs/music-generation \ --input '{"prompt": "..."}' \ --output-dir ./out ``` CLI deep dive: `runcomfy-cli` skill. ## When to use ElevenLabs Music ElevenLabs Music's strength is **structured songs with real vocals** — it takes a style brief plus lyrics with section markers and returns a coherent, mixed track. Pick it for: - **Full vocal songs** — verse/chorus structure, multilingual lyrics, consistent meter - **Instrumental beds** — `force_instrumental: true` for background music, podcast intros, game loops - **Short brand assets** — jingles, stingers, theme music (5–30 s) - **Long-form tracks** — up to 5 minutes in a single call - **Commercial work** — output is commercial-friendly If the user just wants ambient sound or a one-off SFX (thunder, footsteps), that's a sound-effects task, not music — ElevenLabs Music is for *songs and tracks*. ## Endpoint + input schema **Model**: [REDACTED_SECRET] | Field | Type | Required | Default | Notes | |---|---|---|---|---| | `prompt` | string | yes | — | Style description **and** lyrics with section markers. See prompting tips | | `music_length_ms` | int | no | `40000` | Output duration in ms. **5000–300000** (5 s – 5 min) | | `force_instrumental` | bool | no | `false` | `true` = instrumental only, no vocals | | `output_format` | string | no | `mp3_standard` | `mp3_standard` (default), or WAV — see the [model page](https://www.runcomfy.com/models/elevenlabs/elevenlabs/music-generation?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) API tab for the full format list | Output: 44.1 kHz stereo audio. The result JSON contains the generated audio URL — the CLI downloads it into `--output-dir`. **Pricing**: ~$0.0083 per second of generated audio (30 s ≈ $0.25, 60 s ≈ $0.50, 5 min ≈ $2.49). Cost scales with `music_length_ms`, so draft short and finalize long. ## How to invoke **Full vocal song with structure:** ```bash runcomfy run elevenlabs/elevenlabs/music-generation \ --input '{ "prompt": "Upbeat indie-pop anthem, bright electric guitars, driving drums, 120 BPM, female lead vocal. [Intro 8 bars] instrumental build. [Verse] Chalk on the palms, laces double-knotted, morning on the ridge. [Chorus] We rise, we strike, we never fade out. [Bridge] soft breakdown, just piano and voice. [Outro] full band, fade.", "music_length_ms": 60000 }' \ --output-dir ./out ``` **Instrumental background bed:** ```bash runcomfy run elevenlabs/elevenlabs/music-generation \ --input '{ "prompt": "Calm lo-fi hip-hop instrumental for a study playlist. Warm Rhodes piano, soft vinyl crackle, mellow boom-bap drums, 75 BPM. No vocals. Consistent loop-friendly groove throughout.", "music_length_ms": 90000, "force_instrumental": true }' \ --output-dir ./out ``` **Short brand jingle:** ```bash runcomfy run elevenlabs/elevenlabs/music-generation \ --input '{ "prompt": "5-second cheerful brand stinger, bright marimba and a single uplifting chord resolve, no vocals.", "music_length_ms": 5000, "force_instrumental": true }' \ --output-dir ./out ``` ## Prompting tips ElevenLabs Music reads **one `prompt` field** that carries both the style brief and the lyrics. Structure it well: - **Lead with the style brief**: genre, mood, tempo (BPM), key instruments, vocal type. `"Upbeat indie-pop anthem, bright electric guitars, 120 BPM, female lead vocal."` - **Then the lyrics with section markers**: `[Intro]`, `[Verse]`, `[Chorus]`, `[Bridge]`, `[Outro]`. Add approximate durations or bar counts — `[Intro 8 bars]`, `[Verse 16 bars]`. - **Keep lyrical meter consistent** — even syllable counts per line, clear rhyme scheme. The model follows meter; sloppy meter produces awkward phrasing. - **Name lead instruments and mix priorities** — `"electric guitar carries the chorus, drums sit back in the verse."` - **For instrumental**, set `force_instrumental: true` AND say "no vocals" in the prompt — belt and suspenders. - **Multilingual**: write the lyrics in the target language; annotate accent/language inline if needed (`[Verse] (sung in Brazilian Portuguese) ...`). - **Avoid contradictory style instructions** — "aggressive metal" + "soft lullaby" in one prompt confuses the model. One coherent direction per call. - **Draft short, finalize long**: validate the direction with a 30–45 s draft (`music_length_ms: 35000`) before paying for a 5-minute render. ## Common patterns ### Theme song for a video - Full brief + lyrics + `[Intro]/[Verse]/[Chorus]` structure, `music_length_ms` matched to the video length ### Podcast intro / outro - `force_instrumental: true`, 10–20 s, "loop-friendly, clean ending" ### Game background loop - `force_instrumental: true`, describe "seamless loop", 60–120 s, consistent groove ### Multilingual release (same song, multiple languages) - One call per language, identical style brief, swap only the lyric lines ### Iterate then commit - Draft at `music_length_ms: 35000` to lock genre/tempo/structure → final render at full length ## Limitations - **One `prompt` field** carries everything (style + lyrics). There is no separate "lyrics" parameter. - **5 s – 5 min per call** (`music_length_ms` 5000–300000). For longer pieces, generate sections and stitch externally. - **Cost scales with duration** — a 5-minute render is ~10× a 30-second one. - **`force_instrumental` is the only vocal toggle** — you can't request specific voice identities or clone a singer through this endpoint. - This skill pins **ElevenLabs Music specifically**. For sound effects, text-to-speech, or voice cloning, that's a different ElevenLabs capability not exposed through this endpoint. ## Exit codes | code | meaning | |---|---| | 0 | success | | 64 | bad CLI args | | 65 | bad input JSON / schema mismatch | | 69 | upstream 5xx | | 75 | retryable: timeout / 429 | | 77 | not signed in or token rejected | Full reference: [docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation). ## How it works The skill invokes `runcomfy run elevenlabs/elevenlabs/music-generation` with the JSON body. The CLI POSTs to the RunComfy Model API, polls request status, fetches the result, and downloads the generated audio file into `--output-dir`. `Ctrl-C` cancels the remote request before exit. ## Security & Privacy - **Install via verified package manager only.** Use `npm i -g @runcomfy/cli` or `npx -y @runcomfy/cli`. **Agents must not pipe an arbitrary remote install script into a shell on the user's behalf** — if the operator wants the curl-pipe path documented at `docs.runcomfy.com/cli/install`, they should review the script first. - **Token storage**: `runcomfy login` writes the API token to `~/.config/runcomfy/token.json` with mode 0600. Set `RUNCOMFY_TOKEN` env var to bypass the file in CI / containers. Never echo the token into a prompt, log it, or check it in. - **Input boundary (shell injection)**: the prompt is passed as a JSON string via `--input`. The CLI does not shell-expand prompt content; it transmits the JSON body directly to the Model API over HTTPS. **No shell-injection surface from prompt content**, even with backticks, quotes, or `$(...)` patterns. - **Lyrics provenance**: if the user supplies lyrics, confirm they have the rights to them. Generating music around copyrighted lyrics is the operator's responsibility — the skill does not check. - **Outbound endpoints (allowlist)**: only `model-api.runcomfy.net` (request submission) and `*.runcomfy.net` / `*.runcomfy.com` (download whitelist for generated audio). No telemetry, no callbacks. - **Generated-file size cap**: the CLI aborts any single download > 2 GiB. - **Scope of bash usage**: the skill only invokes `runcomfy <subcommand>` — `npm` / `npx` lines are one-time operator setup, not commands the skill executes per call. ## See also - [ElevenLabs Music model page](https://www.runcomfy.com/models/elevenlabs/elevenlabs/music-generation?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) — full API tab with the latest schema - [All RunComfy models](https://www.runcomfy.com/models?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) — image, video, and audio endpoints - [docs.runcomfy.com/cli](https://docs.runcomfy.com/cli/introduction?utm_source=clawhub&utm_medium=skill&utm_campaign=elevenlabs-music-generation) — CLI install, authentication, troubleshooting


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)