[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C24227ZSYHA79F39T6WNX4":3,"skill-same:01M7C24227ZSYHA79F39T6WNX4":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":6,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M7C24227ZSYHA79F39T6WNX4","music",null,"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.","om-scogo\u002Fskillsh-scraper","om-scogo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160466840?v=4","01M79AWB6DFVCQ7RK70CS34B96","Om Achrekar","01M79AWB6ZM9SKR8KDH1WSSM22",0,"MIT","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Felevenlabs-skills\u002Fmusic\u002Fmusic\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: music\ndescription: 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.\nlicense: MIT\ncompatibility: Requires internet access and an ElevenLabs API key (ELEVENLABS_API_KEY).\nmetadata: {\"openclaw\": {\"requires\": {\"env\": [\"ELEVENLABS_API_KEY\"]}, \"primaryEnv\": \"ELEVENLABS_API_KEY\"}}\n---\n\n# ElevenLabs Music Generation\n\nGenerate music from text prompts - supports instrumental tracks, songs with lyrics, and fine-grained control via composition plans.\n\n> **Setup:** See [Installation Guide](references\u002Finstallation.md). For JavaScript, use `@elevenlabs\u002F*` packages only.\n\nAll examples below default to `music_v2`, the current generation model. Pass `model_id=\"music_v1\"` only when explicitly requested to.\n\n## Quick Start\n\n### Python\n\n```python\nfrom elevenlabs import ElevenLabs\n\nclient = ElevenLabs()\n\naudio = client.music.compose(\n    prompt=\"A chill lo-fi hip hop beat with jazzy piano chords\",\n    music_length_ms=30000,\n    model_id=\"music_v2\",\n)\n\nwith open(\"output.mp3\", \"wb\") as f:\n    for chunk in audio:\n        f.write(chunk)\n```\n\n### TypeScript\n\n```typescript\nimport { ElevenLabsClient } from \"@elevenlabs\u002Felevenlabs-js\";\nimport { createWriteStream } from \"fs\";\n\nconst client = new ElevenLabsClient();\nconst audio = await client.music.compose({\n  prompt: \"A chill lo-fi hip hop beat with jazzy piano chords\",\n  musicLengthMs: 30000,\n  modelId: \"music_v2\",\n});\naudio.pipe(createWriteStream(\"output.mp3\"));\n```\n\n### cURL\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"A chill lo-fi beat\", \"music_length_ms\": 30000, \"model_id\": \"music_v2\"}' \\\n  --output output.mp3\n```\n\n## Methods\n\n| Method | Description |\n|--------|-------------|\n| `music.compose` | Generate audio from a prompt or composition plan |\n| `music.stream` | Stream audio chunks as they are generated (paid plans) |\n| `music.composition_plan.create` | Generate a structured plan for fine-grained control |\n| `music.compose_detailed` | Generate audio + composition plan + metadata; pass `store_for_inpainting=True` to enable inpainting |\n| `music.compose_detailed_stream` | Stream audio plus composition plan, metadata, and optional word timestamps as Server-Sent Events |\n| `music.video_to_music` | Generate background music from one or more uploaded video files |\n| `music.upload` | Upload an audio file for later inpainting workflows, optionally extracting its composition plan or word-level timestamps |\n\nSee [API Reference](references\u002Fapi_reference.md) for full parameter details.\n\n`music.upload` is available to enterprise clients with access to the inpainting feature.\n\n## Video to Music\n\nGenerate background music from uploaded video clips via\n[`POST \u002Fv1\u002Fmusic\u002Fvideo-to-music`](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fmusic\u002Fvideo-to-music)\n(`client.music.video_to_music`). This is separate from prompt-based\n[`music.compose`](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fmusic\u002Fcompose) (`POST \u002Fv1\u002Fmusic`).\n\nThe API combines videos in order, accepts an optional natural-language description, and lets you\nsteer style with up to 10 tags such as `upbeat` or `cinematic`. This endpoint still defaults to\n`music_v1`; pass `model_id=\"music_v2\"` to use the newer model.\n\n### Python\n\n```python\nfrom elevenlabs import ElevenLabs\n\nclient = ElevenLabs()\n\naudio = client.music.video_to_music(\n    videos=[\"trailer.mp4\"],\n    description=\"Build suspense, then resolve with a warm cinematic finish.\",\n    tags=[\"cinematic\", \"suspenseful\", \"uplifting\"],\n    model_id=\"music_v2\",\n)\n\nwith open(\"video-score.mp3\", \"wb\") as f:\n    for chunk in audio:\n        f.write(chunk)\n```\n\n### TypeScript\n\n```typescript\nimport { ElevenLabsClient } from \"@elevenlabs\u002Felevenlabs-js\";\nimport { createReadStream, createWriteStream } from \"fs\";\n\nconst client = new ElevenLabsClient();\n\nconst audio = await client.music.videoToMusic({\n  videos: [createReadStream(\"trailer.mp4\")],\n  description: \"Build suspense, then resolve with a warm cinematic finish.\",\n  tags: [\"cinematic\", \"suspenseful\", \"uplifting\"],\n  modelId: \"music_v2\",\n});\n\naudio.pipe(createWriteStream(\"video-score.mp3\"));\n```\n\n### cURL\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\u002Fvideo-to-music\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" \\\n  -F \"videos=@trailer.mp4\" \\\n  -F \"description=Build suspense, then resolve with a warm cinematic finish.\" \\\n  -F \"tags=cinematic\" \\\n  -F \"tags=suspenseful\" \\\n  -F \"tags=uplifting\" \\\n  -F \"model_id=music_v2\" \\\n  --output video-score.mp3\n```\n\nConstraints from the current API schema:\n\n- Upload 1-10 video files per request\n- Keep total combined upload size at or below 200 MB\n- Keep total combined video duration at or below 600 seconds\n- Use `description` for high-level musical direction and `tags` for concise style cues\n\n## Composition Plans\n\n`music_v2` composition plans are an ordered list of `chunks`. Each chunk specifies its own\n`text` (section label, lyrics, inline cues), `duration_ms`, `positive_styles`, `negative_styles`,\nand `context_adherence` (`low`, `medium`, or `high`, default `high`). Up to 30 chunks per plan,\neach 3,000–120,000 ms, total length 3 s to 10 minutes.\n\nGenerate a plan first, edit it, then compose:\n\n```python\nplan = client.music.composition_plan.create(\n    prompt=\"An epic orchestral piece building to a climax\",\n    music_length_ms=60000,\n    model_id=\"music_v2\",\n)\n\n# Edit chunks in place\nplan[\"chunks\"][0][\"text\"] = \"[Intro]\\nQuiet strings rising\"\n\naudio = client.music.compose(\n    composition_plan=plan,\n    model_id=\"music_v2\",\n)\n```\n\n```typescript\nconst plan = await client.music.compositionPlan.create({\n  prompt: \"An epic orchestral piece building to a climax\",\n  musicLengthMs: 60000,\n  modelId: \"music_v2\",\n});\n\nplan.chunks[0].text = \"[Intro]\\nQuiet strings rising\";\n\nconst audio = await client.music.compose({\n  compositionPlan: plan,\n  modelId: \"music_v2\",\n});\n```\n\nOr hand-build a plan to control lyrics and style per section:\n\n```python\ncomposition_plan = {\n    \"chunks\": [\n        {\n            \"text\": \"[Verse]\\nWalking down an empty street\",\n            \"duration_ms\": 15000,\n            \"positive_styles\": [\"pop\", \"upbeat\", \"female vocals\", \"acoustic guitar\"],\n            \"negative_styles\": [\"dark\", \"slow\"],\n            \"context_adherence\": \"high\",\n        },\n        {\n            \"text\": \"[Chorus]\\nThis is my moment\",\n            \"duration_ms\": 15000,\n            \"positive_styles\": [\"powerful vocals\", \"full band\"],\n            \"negative_styles\": [],\n            \"context_adherence\": \"high\",\n        },\n    ]\n}\n\naudio = client.music.compose(composition_plan=composition_plan, model_id=\"music_v2\")\n```\n\n```typescript\nconst compositionPlan = {\n  chunks: [\n    {\n      text: \"[Verse]\\nWalking down an empty street\",\n      durationMs: 15000,\n      positiveStyles: [\"pop\", \"upbeat\", \"female vocals\", \"acoustic guitar\"],\n      negativeStyles: [\"dark\", \"slow\"],\n      contextAdherence: \"high\",\n    },\n    {\n      text: \"[Chorus]\\nThis is my moment\",\n      durationMs: 15000,\n      positiveStyles: [\"powerful vocals\", \"full band\"],\n      negativeStyles: [],\n      contextAdherence: \"high\",\n    },\n  ],\n};\n\nconst audio = await client.music.compose({\n  compositionPlan,\n  modelId: \"music_v2\",\n});\n```\n\nPut broader characteristics (genre, instrumentation, vocal style) in `positive_styles`, not in\n`text`. The first chunk's styles set the overall tone — include 6–7 styles there.\n\n## Output Formats\n\nUse the `output_format` query parameter on compose, detailed compose, or stream requests to select\nthe generated audio format. `auto` chooses a model-appropriate MP3 format; for `music_v2`, it\nselects `mp3_48000_192`. Higher-bitrate MP3 options include `mp3_48000_240` and `mp3_48000_320`.\n\n## Streaming\n\nFor paid plans, stream audio chunks as they are generated instead of waiting for the full file:\n\n```python\nfrom io import BytesIO\n\nstream = client.music.stream(\n    prompt=\"A driving synthwave track with arpeggiated leads\",\n    music_length_ms=30000,\n    model_id=\"music_v2\",\n)\n\nbuffer = BytesIO()\nfor chunk in stream:\n    if chunk:\n        buffer.write(chunk)\n```\n\n```typescript\nconst stream = await client.music.stream({\n  prompt: \"A driving synthwave track with arpeggiated leads\",\n  musicLengthMs: 30000,\n  modelId: \"music_v2\",\n});\n\nconst chunks: Buffer[] = [];\nfor await (const chunk of stream) {\n  chunks.push(chunk);\n}\n```\n\n### Detailed streaming\n\nUse detailed streaming when the application needs generated music metadata while audio is still\narriving. `POST \u002Fv1\u002Fmusic\u002Fdetailed\u002Fstream` accepts the same prompt or composition-plan body as\ndetailed compose, streams `text\u002Fevent-stream`, and can include word timestamps with\n`with_timestamps`.\n\n```bash\ncurl -N -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\u002Fdetailed\u002Fstream?output_format=auto\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"A bright indie pop hook with warm guitars\", \"music_length_ms\": 30000, \"model_id\": \"music_v2\", \"with_timestamps\": true}'\n```\n\n## Inpainting\n\nInpainting edits or extends a stored song by mixing **audio reference chunks** (unchanged slices\nof a stored song) with new **generation chunks** in a single composition plan. \n\nStep 1 — get a `song_id`, either by storing a fresh generation or uploading existing audio:\n\n```python\n# Option A: keep a generation for later editing\nresult = client.music.compose_detailed(\n    prompt=\"An upbeat pop song with verse and chorus\",\n    music_length_ms=60000,\n    model_id=\"music_v2\",\n    store_for_inpainting=True,\n)\nsong_id = result.song_id\n\n# Option B: upload an existing track and extract its plan\nuploaded = client.music.upload(\n    file=open(\"my-song.mp3\", \"rb\"),\n    extract_composition_plan=\"music_v2\",\n)\nsong_id = uploaded.song_id\ncomposition_plan = uploaded.composition_plan\n```\n\n```typescript\nimport { createReadStream } from \"fs\";\n\n\u002F\u002F Option A: keep a generation for later editing\nconst result = await client.music.composeDetailed({\n  prompt: \"An upbeat pop song with verse and chorus\",\n  musicLengthMs: 60000,\n  modelId: \"music_v2\",\n  storeForInpainting: true,\n});\nlet songId = result.songId;\n\n\u002F\u002F Option B: upload an existing track and extract its plan\nconst uploaded = await client.music.upload({\n  file: createReadStream(\"my-song.mp3\"),\n  extractCompositionPlan: \"music_v2\",\n});\nsongId = uploaded.songId;\nconst compositionPlan = uploaded.compositionPlan;\n```\n\nStep 2 — compose a plan that references the stored audio and regenerates the part you want to\nchange:\n\n```python\nplan = {\n    \"chunks\": [\n        {\"song_id\": song_id, \"range\": {\"start_ms\": 0, \"end_ms\": 30000}},\n        {\n            \"text\": \"[Chorus]\\nWe're rising up tonight\",\n            \"duration_ms\": 30000,\n            \"positive_styles\": [\"bigger drums\", \"layered vocals\", \"anthemic\"],\n            \"negative_styles\": [\"sparse\"],\n            \"context_adherence\": \"high\",\n        },\n    ]\n}\n\naudio = client.music.compose(composition_plan=plan, model_id=\"music_v2\")\n```\n\n```typescript\nconst plan = {\n  chunks: [\n    { songId, range: { startMs: 0, endMs: 30000 } },\n    {\n      text: \"[Chorus]\\nWe're rising up tonight\",\n      durationMs: 30000,\n      positiveStyles: [\"bigger drums\", \"layered vocals\", \"anthemic\"],\n      negativeStyles: [\"sparse\"],\n      contextAdherence: \"high\",\n    },\n  ],\n};\n\nconst audio = await client.music.compose({\n  compositionPlan: plan,\n  modelId: \"music_v2\",\n});\n```\n\nTo match the feel of a stored slice without copying it, attach a `conditioning_ref` (up to\n30,000 ms) plus a `condition_strength` of `low`, `medium`, `high`, or `xhigh` to a generation\nchunk. Conditioning placed on the first chunk influences every later chunk.\n\nSee [API Reference](references\u002Fapi_reference.md) for the full inpainting parameter list.\n\n## Content Restrictions\n\n- Cannot reference specific artists, bands, or copyrighted lyrics\n- `bad_prompt` errors include a `prompt_suggestion` with alternative phrasing\n- `bad_composition_plan` errors include a `composition_plan_suggestion`\n\n## Error Handling\n\n```python\ntry:\n    audio = client.music.compose(prompt=\"...\", music_length_ms=30000)\nexcept Exception as e:\n    print(f\"API error: {e}\")\n```\n\n```typescript\ntry {\n  const audio = await client.music.compose({\n    prompt: \"...\",\n    musicLengthMs: 30000,\n  });\n} catch (err) {\n  console.error(\"API error:\", err);\n}\n```\n\nCommon errors: 401 (invalid key), 422 (invalid params), 429 (rate limit).\n\n## References\n\n- [Installation Guide](references\u002Finstallation.md)\n- [API Reference](references\u002Fapi_reference.md)\n","# ElevenLabs Music Generation\n\nGenerate music from text prompts - supports instrumental tracks, songs with lyrics, and fine-grained control via composition plans.\n\n> **Setup:** See [Installation Guide](references\u002Finstallation.md). For JavaScript, use `@elevenlabs\u002F*` packages only.\n\nAll examples below default to `music_v2`, the current generation model. Pass `model_id=\"music_v1\"` only when explicitly requested to.\n\n## Quick Start\n\n### Python\n\n```python\nfrom elevenlabs import ElevenLabs\n\nclient = ElevenLabs()\n\naudio = client.music.compose(\n    prompt=\"A chill lo-fi hip hop beat with jazzy piano chords\",\n    music_length_ms=30000,\n    model_id=\"music_v2\",\n)\n\nwith open(\"output.mp3\", \"wb\") as f:\n    for chunk in audio:\n        f.write(chunk)\n```\n\n### TypeScript\n\n```typescript\nimport { ElevenLabsClient } from \"@elevenlabs\u002Felevenlabs-js\";\nimport { createWriteStream } from \"fs\";\n\nconst client = new ElevenLabsClient();\nconst audio = await client.music.compose({\n  prompt: \"A chill lo-fi hip hop beat with jazzy piano chords\",\n  musicLengthMs: 30000,\n  modelId: \"music_v2\",\n});\naudio.pipe(createWriteStream(\"output.mp3\"));\n```\n\n### cURL\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"A chill lo-fi beat\", \"music_length_ms\": 30000, \"model_id\": \"music_v2\"}' \\\n  --output output.mp3\n```\n\n## Methods\n\n| Method | Description |\n|--------|-------------|\n| `music.compose` | Generate audio from a prompt or composition plan |\n| `music.stream` | Stream audio chunks as they are generated (paid plans) |\n| `music.composition_plan.create` | Generate a structured plan for fine-grained control |\n| `music.compose_detailed` | Generate audio + composition plan + metadata; pass `store_for_inpainting=True` to enable inpainting |\n| `music.compose_detailed_stream` | Stream audio plus composition plan, metadata, and optional word timestamps as Server-Sent Events |\n| `music.video_to_music` | Generate background music from one or more uploaded video files |\n| `music.upload` | Upload an audio file for later inpainting workflows, optionally extracting its composition plan or word-level timestamps |\n\nSee [API Reference](references\u002Fapi_reference.md) for full parameter details.\n\n`music.upload` is available to enterprise clients with access to the inpainting feature.\n\n## Video to Music\n\nGenerate background music from uploaded video clips via\n[`POST \u002Fv1\u002Fmusic\u002Fvideo-to-music`](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fmusic\u002Fvideo-to-music)\n(`client.music.video_to_music`). This is separate from prompt-based\n[`music.compose`](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fmusic\u002Fcompose) (`POST \u002Fv1\u002Fmusic`).\n\nThe API combines videos in order, accepts an optional natural-language description, and lets you\nsteer style with up to 10 tags such as `upbeat` or `cinematic`. This endpoint still defaults to\n`music_v1`; pass `model_id=\"music_v2\"` to use the newer model.\n\n### Python\n\n```python\nfrom elevenlabs import ElevenLabs\n\nclient = ElevenLabs()\n\naudio = client.music.video_to_music(\n    videos=[\"trailer.mp4\"],\n    description=\"Build suspense, then resolve with a warm cinematic finish.\",\n    tags=[\"cinematic\", \"suspenseful\", \"uplifting\"],\n    model_id=\"music_v2\",\n)\n\nwith open(\"video-score.mp3\", \"wb\") as f:\n    for chunk in audio:\n        f.write(chunk)\n```\n\n### TypeScript\n\n```typescript\nimport { ElevenLabsClient } from \"@elevenlabs\u002Felevenlabs-js\";\nimport { createReadStream, createWriteStream } from \"fs\";\n\nconst client = new ElevenLabsClient();\n\nconst audio = await client.music.videoToMusic({\n  videos: [createReadStream(\"trailer.mp4\")],\n  description: \"Build suspense, then resolve with a warm cinematic finish.\",\n  tags: [\"cinematic\", \"suspenseful\", \"uplifting\"],\n  modelId: \"music_v2\",\n});\n\naudio.pipe(createWriteStream(\"video-score.mp3\"));\n```\n\n### cURL\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\u002Fvideo-to-music\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" \\\n  -F \"videos=@trailer.mp4\" \\\n  -F \"description=Build suspense, then resolve with a warm cinematic finish.\" \\\n  -F \"tags=cinematic\" \\\n  -F \"tags=suspenseful\" \\\n  -F \"tags=uplifting\" \\\n  -F \"model_id=music_v2\" \\\n  --output video-score.mp3\n```\n\nConstraints from the current API schema:\n\n- Upload 1-10 video files per request\n- Keep total combined upload size at or below 200 MB\n- Keep total combined video duration at or below 600 seconds\n- Use `description` for high-level musical direction and `tags` for concise style cues\n\n## Composition Plans\n\n`music_v2` composition plans are an ordered list of `chunks`. Each chunk specifies its own\n`text` (section label, lyrics, inline cues), `duration_ms`, `positive_styles`, `negative_styles`,\nand `context_adherence` (`low`, `medium`, or `high`, default `high`). Up to 30 chunks per plan,\neach 3,000–120,000 ms, total length 3 s to 10 minutes.\n\nGenerate a plan first, edit it, then compose:\n\n```python\nplan = client.music.composition_plan.create(\n    prompt=\"An epic orchestral piece building to a climax\",\n    music_length_ms=60000,\n    model_id=\"music_v2\",\n)\n\n# Edit chunks in place\nplan[\"chunks\"][0][\"text\"] = \"[Intro]\\nQuiet strings rising\"\n\naudio = client.music.compose(\n    composition_plan=plan,\n    model_id=\"music_v2\",\n)\n```\n\n```typescript\nconst plan = await client.music.compositionPlan.create({\n  prompt: \"An epic orchestral piece building to a climax\",\n  musicLengthMs: 60000,\n  modelId: \"music_v2\",\n});\n\nplan.chunks[0].text = \"[Intro]\\nQuiet strings rising\";\n\nconst audio = await client.music.compose({\n  compositionPlan: plan,\n  modelId: \"music_v2\",\n});\n```\n\nOr hand-build a plan to control lyrics and style per section:\n\n```python\ncomposition_plan = {\n    \"chunks\": [\n        {\n            \"text\": \"[Verse]\\nWalking down an empty street\",\n            \"duration_ms\": 15000,\n            \"positive_styles\": [\"pop\", \"upbeat\", \"female vocals\", \"acoustic guitar\"],\n            \"negative_styles\": [\"dark\", \"slow\"],\n            \"context_adherence\": \"high\",\n        },\n        {\n            \"text\": \"[Chorus]\\nThis is my moment\",\n            \"duration_ms\": 15000,\n            \"positive_styles\": [\"powerful vocals\", \"full band\"],\n            \"negative_styles\": [],\n            \"context_adherence\": \"high\",\n        },\n    ]\n}\n\naudio = client.music.compose(composition_plan=composition_plan, model_id=\"music_v2\")\n```\n\n```typescript\nconst compositionPlan = {\n  chunks: [\n    {\n      text: \"[Verse]\\nWalking down an empty street\",\n      durationMs: 15000,\n      positiveStyles: [\"pop\", \"upbeat\", \"female vocals\", \"acoustic guitar\"],\n      negativeStyles: [\"dark\", \"slow\"],\n      contextAdherence: \"high\",\n    },\n    {\n      text: \"[Chorus]\\nThis is my moment\",\n      durationMs: 15000,\n      positiveStyles: [\"powerful vocals\", \"full band\"],\n      negativeStyles: [],\n      contextAdherence: \"high\",\n    },\n  ],\n};\n\nconst audio = await client.music.compose({\n  compositionPlan,\n  modelId: \"music_v2\",\n});\n```\n\nPut broader characteristics (genre, instrumentation, vocal style) in `positive_styles`, not in\n`text`. The first chunk's styles set the overall tone — include 6–7 styles there.\n\n## Output Formats\n\nUse the `output_format` query parameter on compose, detailed compose, or stream requests to select\nthe generated audio format. `auto` chooses a model-appropriate MP3 format; for `music_v2`, it\nselects `mp3_48000_192`. Higher-bitrate MP3 options include `mp3_48000_240` and `mp3_48000_320`.\n\n## Streaming\n\nFor paid plans, stream audio chunks as they are generated instead of waiting for the full file:\n\n```python\nfrom io import BytesIO\n\nstream = client.music.stream(\n    prompt=\"A driving synthwave track with arpeggiated leads\",\n    music_length_ms=30000,\n    model_id=\"music_v2\",\n)\n\nbuffer = BytesIO()\nfor chunk in stream:\n    if chunk:\n        buffer.write(chunk)\n```\n\n```typescript\nconst stream = await client.music.stream({\n  prompt: \"A driving synthwave track with arpeggiated leads\",\n  musicLengthMs: 30000,\n  modelId: \"music_v2\",\n});\n\nconst chunks: Buffer[] = [];\nfor await (const chunk of stream) {\n  chunks.push(chunk);\n}\n```\n\n### Detailed streaming\n\nUse detailed streaming when the application needs generated music metadata while audio is still\narriving. `POST \u002Fv1\u002Fmusic\u002Fdetailed\u002Fstream` accepts the same prompt or composition-plan body as\ndetailed compose, streams `text\u002Fevent-stream`, and can include word timestamps with\n`with_timestamps`.\n\n```bash\ncurl -N -X POST \"https:\u002F\u002Fapi.elevenlabs.io\u002Fv1\u002Fmusic\u002Fdetailed\u002Fstream?output_format=auto\" \\\n  -H \"xi-api-key: $ELEVENLABS_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"A bright indie pop hook with warm guitars\", \"music_length_ms\": 30000, \"model_id\": \"music_v2\", \"with_timestamps\": true}'\n```\n\n## Inpainting\n\nInpainting edits or extends a stored song by mixing **audio reference chunks** (unchanged slices\nof a stored song) with new **generation chunks** in a single composition plan. \n\nStep 1 — get a `song_id`, either by storing a fresh generation or uploading existing audio:\n\n```python\n# Option A: keep a generation for later editing\nresult = client.music.compose_detailed(\n    prompt=\"An upbeat pop song with verse and chorus\",\n    music_length_ms=60000,\n    model_id=\"music_v2\",\n    store_for_inpainting=True,\n)\nsong_id = result.song_id\n\n# Option B: upload an existing track and extract its plan\nuploaded = client.music.upload(\n    file=open(\"my-song.mp3\", \"rb\"),\n    extract_composition_plan=\"music_v2\",\n)\nsong_id = uploaded.song_id\ncomposition_plan = uploaded.composition_plan\n```\n\n```typescript\nimport { createReadStream } from \"fs\";\n\n\u002F\u002F Option A: keep a generation for later editing\nconst result = await client.music.composeDetailed({\n  prompt: \"An upbeat pop song with verse and chorus\",\n  musicLengthMs: 60000,\n  modelId: \"music_v2\",\n  storeForInpainting: true,\n});\nlet songId = result.songId;\n\n\u002F\u002F Option B: upload an existing track and extract its plan\nconst uploaded = await client.music.upload({\n  file: createReadStream(\"my-song.mp3\"),\n  extractCompositionPlan: \"music_v2\",\n});\nsongId = uploaded.songId;\nconst compositionPlan = uploaded.compositionPlan;\n```\n\nStep 2 — compose a plan that references the stored audio and regenerates the part you want to\nchange:\n\n```python\nplan = {\n    \"chunks\": [\n        {\"song_id\": song_id, \"range\": {\"start_ms\": 0, \"end_ms\": 30000}},\n        {\n            \"text\": \"[Chorus]\\nWe're rising up tonight\",\n            \"duration_ms\": 30000,\n            \"positive_styles\": [\"bigger drums\", \"layered vocals\", \"anthemic\"],\n            \"negative_styles\": [\"sparse\"],\n            \"context_adherence\": \"high\",\n        },\n    ]\n}\n\naudio = client.music.compose(composition_plan=plan, model_id=\"music_v2\")\n```\n\n```typescript\nconst plan = {\n  chunks: [\n    { songId, range: { startMs: 0, endMs: 30000 } },\n    {\n      text: \"[Chorus]\\nWe're rising up tonight\",\n      durationMs: 30000,\n      positiveStyles: [\"bigger drums\", \"layered vocals\", \"anthemic\"],\n      negativeStyles: [\"sparse\"],\n      contextAdherence: \"high\",\n    },\n  ],\n};\n\nconst audio = await client.music.compose({\n  compositionPlan: plan,\n  modelId: \"music_v2\",\n});\n```\n\nTo match the feel of a stored slice without copying it, attach a `conditioning_ref` (up to\n30,000 ms) plus a `condition_strength` of `low`, `medium`, `high`, or `xhigh` to a generation\nchunk. Conditioning placed on the first chunk influences every later chunk.\n\nSee [API Reference](references\u002Fapi_reference.md) for the full inpainting parameter list.\n\n## Content Restrictions\n\n- Cannot reference specific artists, bands, or copyrighted lyrics\n- `bad_prompt` errors include a `prompt_suggestion` with alternative phrasing\n- `bad_composition_plan` errors include a `composition_plan_suggestion`\n\n## Error Handling\n\n```python\ntry:\n    audio = client.music.compose(prompt=\"...\", music_length_ms=30000)\nexcept Exception as e:\n    print(f\"API error: {e}\")\n```\n\n```typescript\ntry {\n  const audio = await client.music.compose({\n    prompt: \"...\",\n    musicLengthMs: 30000,\n  });\n} catch (err) {\n  console.error(\"API error:\", err);\n}\n```\n\nCommon errors: 401 (invalid key), 422 (invalid params), 429 (rate limit).\n\n## References\n\n- [Installation Guide](references\u002Finstallation.md)\n- [API Reference](references\u002Fapi_reference.md)\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":29},{"openclaw":25},{"requires":26,"primaryEnv":28},{"env":27},[28],"ELEVENLABS_API_KEY","Requires internet access and an ElevenLabs API key (ELEVENLABS_API_KEY).","main","8859218955d9504cd18b59e7892100718039d3b4","data\u002Fskills\u002Felevenlabs-skills\u002Fmusic\u002Fmusic",1,"https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper","https:\u002F\u002Fgithub.com\u002Fom-scogo","SDE-1 @ Scogo ","2026-07-18 12:22:46",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add om-scogo\u002Fskillsh-scraper --skill music",{"tool":44,"command":45},"bunx","bunx skills add om-scogo\u002Fskillsh-scraper --skill music",{"tool":47,"command":48},"pnpm","pnpm dlx skills add om-scogo\u002Fskillsh-scraper --skill music","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Felevenlabs-skills\u002Fmusic\u002Fmusic\u002FSKILL.md",true,[],[53,60,65,72,77,84],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7D6MC9FAAEV4CMNYX8W7JTG","arxiv-search","Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002Fskills\u002Farxiv-search\u002FSKILL.md",[],[],{"skillNo":61,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7D6M85CKKN87TA98VCQV4H7","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002FSkill.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7D4ZTCS4DR3CE4JY06X84T2","working-with-legacy-code","Safely change and test untested codebases using Feathers' \"Working Effectively with Legacy Code\". Use when the user mentions \"legacy code\", \"no tests\", \"untested codebase\", \"how do I test this\", \"seams\", \"characterization tests\", \"golden master\", \"sprout method\", \"afraid to change this code\", \"monster method\", \"dependency breaking\", or \"inherited a messy codebase\". Also trigger when changing code without tests safely, getting a class under test when constructors, statics, or singletons block it, adding features to tangled modules, or planning incremental test coverage for an old codebase. Covers the legacy-code change algorithm, seams, characterization tests, sprout\u002Fwrap, and dependency-breaking techniques. For refactoring code that already has tests, see refactoring-patterns. For day-to-day code quality, see clean-code.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002Fworking-with-legacy-code\u002FSKILL.md",[],[],{"skillNo":73,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7D4ZHZKJD2RSNGAF63V14P4","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002FSkill.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7D4ZB4CJBFW5JE67CPH2QRV","web-typography","Select, pair, and implement typefaces for web projects. Use when the user mentions \"font pairing\", \"which typeface\", \"line height\", \"responsive typography\", \"web font loading\", \"type hierarchy\", \"variable fonts\", \"FOUT\u002FFOIT\", \"typographic scale\", or \"the text is hard to read\". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002Fweb-typography\u002FSKILL.md",[],[],{"skillNo":85,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7D4Z4MVYVY3NMJ18BNV6WNA","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002FSkill.md",[],[]]