Skip to main content
POST
创建作曲计划(不消耗 credits)
Generate a structured composition plan from a text prompt. The plan includes sections with styles, durations, and lyrics — ready to be customized and passed to Generate Music.
This endpoint is free and does not consume credits. Use it to preview and customize the composition structure before generating music.
Optionally provide a sourceCompositionPlan as a reference to guide the new plan’s structure. The musicLengthMs parameter is optional here — if omitted, the AI determines the length.

Authorizations

Authorization
string
header
required

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

Body

application/json
prompt
string
required

文字提示

Example:

"An upbeat pop song about summer adventures"

musicLengthMs
number

目标长度(毫秒),范围 3000-600000

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

180000

sourceCompositionPlan
object

参考的已有作曲计划

model
enum<string>
default:music_v1

模型 ID

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

Response

200 - application/json

任务创建成功

taskId
string
required

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