Skip to main content
POST
/
eleven
/
plan
创建作曲计划(不消耗 credits)
curl --request POST \
  --url https://api.mountsea.ai/eleven/plan \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "An upbeat pop song about summer adventures",
  "musicLengthMs": 180000,
  "sourceCompositionPlan": {
    "positive_global_styles": [
      "epic orchestral",
      "cinematic"
    ],
    "negative_global_styles": [
      "lo-fi",
      "acoustic"
    ],
    "sections": [
      {
        "section_name": "Verse",
        "positive_local_styles": [
          "soft piano",
          "building tension"
        ],
        "negative_local_styles": [
          "heavy drums"
        ],
        "duration_ms": 15000,
        "lines": [
          "First line of lyrics",
          "Second line"
        ]
      }
    ]
  },
  "model": "music_v1"
}
'
{
  "taskId": "<string>"
}
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

Response

200 - application/json

任务创建成功

taskId
string
required

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