music

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ElevenLabs Music Generation

ElevenLabs 音乐生成

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.

通过文本提示词生成音乐——支持器乐曲目、带歌词的歌曲，以及通过创作计划实现精细化控制。

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

Quick Start

快速开始

Python

python

from elevenlabs.client 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)

python

from elevenlabs.client 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

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"));

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

bash

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

bash

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

See API Reference for full parameter details.

方法	描述
`music.compose`	通过提示词或创作计划生成音频
`music.composition_plan.create`	生成结构化计划以实现精细化控制
`music.compose_detailed`	生成音频+创作计划+元数据

有关完整参数详情，请查看API参考文档。

Composition Plans

创作计划

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

python

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

如需精细化控制，请先生成创作计划，修改后再进行音乐生成：

python

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 )

undefined

print(plan.positiveGlobalStyles) # 例如：["orchestral", "epic", "cinematic"]

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

undefined

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

不得提及特定艺术家、乐队或受版权保护的歌词
```
bad_prompt
```
错误会包含
```
prompt_suggestion
```
字段，提供替代表述

bad_composition_plan

错误会包含

composition_plan_suggestion

字段

Error Handling

错误处理

python

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).

python

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

常见错误：401（无效密钥）、422（无效参数）、429（请求频率超限）。

References

参考资料

Installation Guide
API Reference

安装指南
API参考文档