ElevenLabs AI音乐生成API：根据文本提示生成器乐、歌曲，支持作曲计划细粒度控制

music by elevenlabs/skills

1,300 周安装量

142 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/elevenlabs/skills --skill music

AI/机器学习开发音频处理

🇨🇳中文介绍

ElevenLabs 音乐生成

根据文本提示生成音乐 - 支持器乐曲目、带歌词的歌曲，以及通过作曲计划进行细粒度控制。

设置： 请参阅安装指南。对于 JavaScript，请仅使用 @elevenlabs/* 包。

快速开始

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
)

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

JavaScript

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,
});
audio.pipe(createWriteStream("output.mp3"));

cURL

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

705,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

245,300 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

196,800 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

128,699 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

curl -X POST "https://api.elevenlabs.io/v1/music" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "A chill lo-fi beat", "music_length_ms": 30000}' --output output.mp3

方法	描述
`music.compose`	根据提示或作曲计划生成音频
`music.composition_plan.create`	生成用于细粒度控制的结构化计划
`music.compose_detailed`	生成音频 + 作曲计划 + 元数据
`music.upload`	上传音频文件以供后续修复工作流使用，并可选择提取其作曲计划

完整参数详情请参阅 API 参考。

music.upload 仅对有权访问修复功能的企业客户可用。

要进行细粒度控制，请先生成作曲计划，修改它，然后进行作曲：

plan = client.music.composition_plan.create(
    prompt="An epic orchestral piece building to a climax",
    music_length_ms=60000
)

# 检查/修改风格和段落
print(plan.positiveGlobalStyles)  # 例如 ["orchestral", "epic", "cinematic"]

audio = client.music.compose(
    composition_plan=plan,
    music_length_ms=60000
)

不能引用特定的艺术家、乐队或受版权保护的歌词
bad_prompt 错误会包含一个带有替代措辞的 prompt_suggestion
bad_composition_plan 错误会包含一个 composition_plan_suggestion

try:
    audio = client.music.compose(prompt="...", music_length_ms=30000)
except Exception as e:
    print(f"API error: {e}")

常见错误：401（密钥无效）、422（参数无效）、429（速率限制）。

🇺🇸English

ElevenLabs Music Generation

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

Setup: See Installation Guide. For JavaScript, use @elevenlabs/* packages only.

Quick Start

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
)

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

JavaScript

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,
});
audio.pipe(createWriteStream("output.mp3"));

cURL

curl -X POST "https://api.elevenlabs.io/v1/music" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "A chill lo-fi beat", "music_length_ms": 30000}' --output output.mp3

Methods

Method	Description
`music.compose`	Generate audio from a prompt or composition plan
`music.composition_plan.create`	Generate a structured plan for fine-grained control
`music.compose_detailed`	Generate audio + composition plan + metadata
`music.upload`	Upload an audio file for later inpainting workflows and optionally extract its composition plan

See API Reference for full parameter details.

music.upload is available to enterprise clients with access to the inpainting feature.

Composition Plans

For granular control, generate a composition plan first, modify it, then compose:

plan = client.music.composition_plan.create(
    prompt="An epic orchestral piece building to a climax",
    music_length_ms=60000
)

# Inspect/modify styles and sections
print(plan.positiveGlobalStyles)  # e.g. ["orchestral", "epic", "cinematic"]

audio = client.music.compose(
    composition_plan=plan,
    music_length_ms=60000
)

Content Restrictions

Cannot reference specific artists, bands, or copyrighted lyrics
bad_prompt errors include a prompt_suggestion with alternative phrasing
bad_composition_plan errors include a composition_plan_suggestion

Error Handling

try:
    audio = client.music.compose(prompt="...", music_length_ms=30000)
except Exception as e:
    print(f"API error: {e}")

Common errors: 401 (invalid key), 422 (invalid params), 429 (rate limit).

References

Weekly Installs

1.3K

Repository

elevenlabs/skills

GitHub Stars

142

First Seen

Jan 29, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli920

codex920

opencode904

claude-code867

github-copilot810

kimi-cli758

ElevenLabs AI音乐生成API：根据文本提示生成器乐、歌曲，支持作曲计划细粒度控制

🇨🇳中文介绍

ElevenLabs 音乐生成

快速开始

Python

JavaScript

cURL

相关 Skills

方法

作曲计划

内容限制

错误处理

参考

🇺🇸English

ElevenLabs Music Generation

Quick Start

Python

JavaScript

cURL

Methods

Composition Plans

Content Restrictions

Error Handling

References