Skip to main content
POST
音乐生成
Generate music using ElevenLabs music models (music_v1 / music_v2). Corresponds to ElevenLabs POST /v1/music/detailed — results include lyrics timestamps, composition plan metadata, and other details. Supports two mutually exclusive input modes:
  • Prompt mode: Provide a simple text prompt — quick and easy
  • Composition Plan mode: Provide a structured compositionPlan with section-level control over styles, duration, and lyrics
This is an async task. The response contains a taskId — use Get Task Status to poll for the generated audio.

Modes

Simple Prompt

Set prompt to describe the desired music. Optionally set forceInstrumental: true to generate without vocals. musicLengthMs is recommended in this mode.

Composition Plan

Set compositionPlan with positive_global_styles, negative_global_styles, and a sections array. Each section can have its own section_name, positive_local_styles, negative_local_styles, duration_ms, and lines (lyrics). Track length is determined by section durations.
Use Create Plan to generate a composition plan from a text prompt (free, no credits), then pass it here after reviewing.

Options

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

模型 ID

Available options:
music_v1,
music_v2,
eleven_multilingual_v2,
eleven_turbo_v2_5,
eleven_flash_v2_5,
eleven_v3
Example:

"music_v1"

prompt
string

简单文字提示(与 compositionPlan 互斥)

Example:

"A melancholic indie folk song with acoustic guitar and soft vocals"

compositionPlan
object

详细作曲计划(与 prompt 互斥,通过 /eleven/plan 生成)

musicLengthMs
number

歌曲长度(毫秒),范围 3000-600000ms。prompt 模式建议填写;compositionPlan 模式由段落时长决定

Required range: 3000 <= x <= 600000
Example:

180000

seed
number

随机种子

Example:

877369

forceInstrumental
boolean
default:false

强制纯器乐,仅 prompt 模式

respectSectionsDurations
boolean
default:true

是否严格遵守段落时长,仅 compositionPlan 模式

outputFormat
enum<string>
default:mp3_44100_128

输出格式,格式为 codec_sampleRate_bitrate。MP3 192kbps 需要 Creator 及以上,PCM 44.1kHz 需要 Pro 及以上

Available options:
mp3_22050_32,
mp3_24000_48,
mp3_44100_32,
mp3_44100_64,
mp3_44100_96,
mp3_44100_128,
mp3_44100_192,
pcm_8000,
pcm_16000,
pcm_22050,
pcm_24000,
pcm_32000,
pcm_44100,
pcm_48000,
ulaw_8000,
alaw_8000,
opus_48000_32,
opus_48000_64,
opus_48000_96,
opus_48000_128,
opus_48000_192
storeForInpainting
boolean
default:false

是否保存生成结果用于后续 Inpainting 编辑。仅限具备 Inpainting 权限的企业客户使用

signWithC2pa
boolean
default:false

是否使用 C2PA 签名标记 AI 生成内容。仅适用于 MP3 输出格式,会在文件中嵌入加密的 AI 生成来源证明

Response

200 - application/json

任务创建成功

taskId
string
required

任务 ID,用于后续查询结果