# ElevenLabs Music 编曲计划创建

> 音频生成

根据文字描述生成结构化编曲计划，可用于后续音乐生成。该端点不消耗额度。

## 请求地址

`POST https://api.modelverse.cn/v1/audio/music/plan`

## 请求体

## 响应

- **200** — 生成的编曲计划。
- **400** — 
- **default** — 

## OpenAPI 定义

```json
{
  "openapi": "3.1.0",
  "x-language": "zh-CN",
  "info": {
    "title": "elevenlabs-music接口文档",
    "version": "1.0.0",
    "description": "这是 ModelVerse 上 `elevenlabs-music` 的音频生成接口文档，说明如何提交音乐或音效生成请求、读取结果以及处理错误。\n接口路径包括 `POST /v1/audio/music/generate`、`POST /v1/audio/music/stream`、`POST /v1/audio/music/detailed`、`POST /v1/audio/music/plan`。\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "ModelVerse API endpoint shown in the source document."
    }
  ],
  "tags": [
    {
      "name": "ElevenLabs Music",
      "description": "ElevenLabs `music-v1` 音乐生成和编曲计划接口。"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/audio/music/generate": {
      "post": {
        "tags": [
          "ElevenLabs Music"
        ],
        "operationId": "createElevenLabsMusicGeneration",
        "summary": "ElevenLabs Music 音乐生成",
        "description": "生成音乐。请求中提供音乐描述或编曲计划，响应返回音频内容或元数据。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ElevenLabsMusicGenerationRequest"
              },
              "examples": {
                "promptMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicGeneratePromptRequest"
                },
                "compositionPlanMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicGeneratePlanRequest"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "生成的音频二进制流。",
            "headers": {
              "song-id": {
                "description": "生成歌曲的唯一标识。",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "audio/mpeg": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicAudioBinary"
                },
                "examples": {
                  "generatedMp3": {
                    "summary": "生成的 MP3 字节流",
                    "value": "<binary MP3 audio bytes>"
                  }
                }
              },
              "application/octet-stream": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicAudioBinary"
                },
                "examples": {
                  "generatedAudio": {
                    "summary": "生成的音频字节流",
                    "value": "<binary audio bytes>"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ElevenLabsMusicInvalidRequest"
          },
          "default": {
            "$ref": "#/components/responses/ElevenLabsMusicError"
          }
        }
      }
    },
    "/v1/audio/music/stream": {
      "post": {
        "tags": [
          "ElevenLabs Music"
        ],
        "operationId": "streamElevenLabsMusicGeneration",
        "summary": "ElevenLabs Music 流式音乐生成",
        "description": "流式生成音乐。接口直接返回音频字节流，适合边生成边播放。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ElevenLabsMusicGenerationRequest"
              },
              "examples": {
                "promptMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicStreamRequest"
                },
                "compositionPlanMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicGeneratePlanRequest"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "流式音频二进制数据。",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicAudioBinary"
                },
                "examples": {
                  "streamedMp3": {
                    "summary": "流式 MP3 字节流",
                    "value": "<streamed binary MP3 audio bytes>"
                  }
                }
              },
              "application/octet-stream": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicAudioBinary"
                },
                "examples": {
                  "streamedAudio": {
                    "summary": "流式音频字节流",
                    "value": "<streamed binary audio bytes>"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ElevenLabsMusicInvalidRequest"
          },
          "default": {
            "$ref": "#/components/responses/ElevenLabsMusicError"
          }
        }
      }
    },
    "/v1/audio/music/detailed": {
      "post": {
        "tags": [
          "ElevenLabs Music"
        ],
        "operationId": "createElevenLabsMusicDetailedGeneration",
        "summary": "ElevenLabs Music 元数据音乐生成",
        "description": "生成音乐。请求中提供音乐描述或编曲计划，响应返回音频内容或元数据。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ElevenLabsMusicDetailedRequest"
              },
              "examples": {
                "promptMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicDetailedRequest"
                },
                "compositionPlanMusic": {
                  "$ref": "#/components/examples/ElevenLabsMusicDetailedPlanRequest"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Multipart response containing metadata JSON and audio bytes.",
            "content": {
              "multipart/mixed": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicDetailedMultipartResponse"
                },
                "examples": {
                  "detailedMultipart": {
                    "$ref": "#/components/examples/ElevenLabsMusicDetailedMultipartResponse"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ElevenLabsMusicInvalidRequest"
          },
          "default": {
            "$ref": "#/components/responses/ElevenLabsMusicError"
          }
        }
      }
    },
    "/v1/audio/music/plan": {
      "post": {
        "tags": [
          "ElevenLabs Music"
        ],
        "operationId": "createElevenLabsMusicCompositionPlan",
        "summary": "ElevenLabs Music 编曲计划创建",
        "description": "根据文字描述生成结构化编曲计划，可用于后续音乐生成。该端点不消耗额度。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ElevenLabsMusicPlanRequest"
              },
              "examples": {
                "lullabyPlan": {
                  "$ref": "#/components/examples/ElevenLabsMusicPlanRequest"
                },
                "basedOnExistingPlan": {
                  "$ref": "#/components/examples/ElevenLabsMusicPlanFromSourceRequest"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "生成的编曲计划。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ElevenLabsMusicCompositionPlan"
                },
                "examples": {
                  "lullabyPlan": {
                    "$ref": "#/components/examples/ElevenLabsMusicPlanResponse"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ElevenLabsMusicInvalidRequest"
          },
          "default": {
            "$ref": "#/components/responses/ElevenLabsMusicError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "使用 API Key 进行 Bearer 认证，格式 `Authorization: Bearer <YOUR_API_KEY>`。\n"
      }
    },
    "responses": {
      "ElevenLabsMusicInvalidRequest": {
        "description": "请求参数无效，例如 `music_length_ms` 越界、`input` 与 `composition_plan` 同时传、或 `composition_plan` 模式下传了 `music_length_ms`。\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ElevenLabsMusicErrorResponse"
            },
            "examples": {
              "invalidMusicLength": {
                "$ref": "#/components/examples/ElevenLabsMusicInvalidRequestError"
              }
            }
          }
        }
      },
      "ElevenLabsMusicError": {
        "description": "上游服务错误。错误信息会原样透传上游返回的具体原因（如 422 时返回 ElevenLabs 的 detail message），客户端可据此定位问题。\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ElevenLabsMusicErrorResponse"
            },
            "examples": {
              "error": {
                "$ref": "#/components/examples/ElevenLabsMusicInvalidRequestError"
              }
            }
          }
        }
      }
    },
    "schemas": {
      "ElevenLabsMusicModel": {
        "type": "string",
        "const": "music-v1",
        "description": "模型名称，固定为 `music-v1`。"
      },
      "ElevenLabsMusicInput": {
        "type": "string",
        "maxLength": 4100,
        "description": "音乐描述提示词，最多 4100 字符。与 `composition_plan` 互斥，不可同时使用。",
        "examples": [
          "A happy piano melody with soft jazz undertones"
        ]
      },
      "ElevenLabsMusicPrompt": {
        "type": "string",
        "maxLength": 4100,
        "description": "编曲计划描述提示词，最多 4100 字符。仅 `/v1/audio/music/plan` 端点使用。",
        "examples": [
          "A soft lullaby with gentle piano and female vocals"
        ]
      },
      "ElevenLabsMusicLengthMs": {
        "type": "integer",
        "minimum": 1,
        "maximum": 600000,
        "description": "音乐时长（毫秒），范围 1-600000。\n仅 `input` 模式下必填；`composition_plan` 模式禁止传该参数，否则上游返回 422。\n",
        "examples": [
          30000
        ]
      },
      "ElevenLabsMusicPlanLengthMs": {
        "type": "integer",
        "minimum": 3000,
        "maximum": 600000,
        "description": "编曲计划总时长（毫秒），范围 3000-600000。不填则由模型自动决定。仅 `/v1/audio/music/plan` 端点使用。",
        "examples": [
          30000
        ]
      },
      "ElevenLabsMusicSeed": {
        "type": "integer",
        "minimum": 0,
        "maximum": 2147483647,
        "description": "随机种子，范围 0-2147483647。仅与 `composition_plan` 配合使用，不可与 `input` 同时使用。",
        "examples": [
          12345
        ]
      },
      "ElevenLabsMusicOutputFormat": {
        "type": "string",
        "description": "输出音频格式，如 `mp3_22050_32`（mp3，22.05kHz，32kbps）。不填默认 mp3。",
        "examples": [
          "mp3_22050_32"
        ]
      },
      "ElevenLabsMusicGenerationRequest": {
        "description": "音乐生成请求体。`input` 与 `composition_plan` 二选一，互斥：\n- `input` 模式：必填 `music_length_ms`，时长由该参数决定；\n- `composition_plan` 模式：禁止传 `music_length_ms`（上游会 422），时长由各 section 的 `duration_ms` 加总决定。\n",
        "oneOf": [
          {
            "$ref": "#/components/schemas/ElevenLabsMusicPromptGenerationRequest"
          },
          {
            "$ref": "#/components/schemas/ElevenLabsMusicPlanGenerationRequest"
          }
        ]
      },
      "ElevenLabsMusicPromptGenerationRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input",
          "music_length_ms"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/ElevenLabsMusicModel"
          },
          "input": {
            "$ref": "#/components/schemas/ElevenLabsMusicInput"
          },
          "music_length_ms": {
            "$ref": "#/components/schemas/ElevenLabsMusicLengthMs"
          },
          "force_instrumental": {
            "type": "boolean",
            "default": false,
            "description": "是否强制生成纯音乐，默认 `false`。仅与 `input` 配合使用。"
          },
          "output_format": {
            "$ref": "#/components/schemas/ElevenLabsMusicOutputFormat"
          }
        }
      },
      "ElevenLabsMusicPlanGenerationRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "composition_plan"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/ElevenLabsMusicModel"
          },
          "composition_plan": {
            "$ref": "#/components/schemas/ElevenLabsMusicCompositionPlan"
          },
          "seed": {
            "$ref": "#/components/schemas/ElevenLabsMusicSeed"
          },
          "output_format": {
            "$ref": "#/components/schemas/ElevenLabsMusicOutputFormat"
          }
        },
        "description": "composition_plan 模式。注意：禁止传 `music_length_ms`，否则上游返回 422。\n计费时长由 `composition_plan.sections[].duration_ms` 加总得到。\n"
      },
      "ElevenLabsMusicDetailedRequest": {
        "description": "详细模式音乐生成请求体。`input` 与 `composition_plan` 二选一，互斥：\n- `input` 模式：必填 `music_length_ms`；\n- `composition_plan` 模式：禁止传 `music_length_ms`（上游会 422）。\n",
        "oneOf": [
          {
            "$ref": "#/components/schemas/ElevenLabsMusicPromptDetailedRequest"
          },
          {
            "$ref": "#/components/schemas/ElevenLabsMusicPlanDetailedRequest"
          }
        ]
      },
      "ElevenLabsMusicPromptDetailedRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input",
          "music_length_ms"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/ElevenLabsMusicModel"
          },
          "input": {
            "$ref": "#/components/schemas/ElevenLabsMusicInput"
          },
          "music_length_ms": {
            "$ref": "#/components/schemas/ElevenLabsMusicLengthMs"
          },
          "force_instrumental": {
            "type": "boolean",
            "default": false,
            "description": "是否强制生成纯音乐，默认 `false`。仅与 `input` 配合使用。"
          },
          "with_timestamps": {
            "type": "boolean",
            "default": false,
            "description": "是否返回歌词时间戳，默认 `false`。"
          },
          "output_format": {
            "$ref": "#/components/schemas/ElevenLabsMusicOutputFormat"
          }
        }
      },
      "ElevenLabsMusicPlanDetailedRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "composition_plan"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/ElevenLabsMusicModel"
          },
          "composition_plan": {
            "$ref": "#/components/schemas/ElevenLabsMusicCompositionPlan"
          },
          "seed": {
            "$ref": "#/components/schemas/ElevenLabsMusicSeed"
          },
          "respect_sections_durations": {
            "type": "boolean",
            "default": true,
            "description": "是否严格遵循乐章时长，默认 `true`。仅与 `composition_plan` 配合使用。"
          },
          "with_timestamps": {
            "type": "boolean",
            "default": false,
            "description": "是否返回歌词时间戳，默认 `false`。"
          },
          "output_format": {
            "$ref": "#/components/schemas/ElevenLabsMusicOutputFormat"
          }
        },
        "description": "composition_plan 模式。注意：禁止传 `music_length_ms`，否则上游返回 422。\n"
      },
      "ElevenLabsMusicPlanRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "prompt"
        ],
        "properties": {
          "model": {
            "$ref": "#/components/schemas/ElevenLabsMusicModel"
          },
          "prompt": {
            "$ref": "#/components/schemas/ElevenLabsMusicPrompt"
          },
          "music_length_ms": {
            "$ref": "#/components/schemas/ElevenLabsMusicPlanLengthMs"
          },
          "source_composition_plan": {
            "$ref": "#/components/schemas/ElevenLabsMusicCompositionPlan"
          }
        }
      },
      "ElevenLabsMusicCompositionPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "positive_global_styles",
          "negative_global_styles",
          "sections"
        ],
        "properties": {
          "positive_global_styles": {
            "type": "array",
            "description": "全局正面风格标签（必填）。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "jazz",
                "upbeat"
              ]
            ]
          },
          "negative_global_styles": {
            "type": "array",
            "description": "全局负面风格标签，不希望出现的风格（必填）。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "heavy metal",
                "aggressive"
              ]
            ]
          },
          "sections": {
            "type": "array",
            "description": "乐章列表（必填）。",
            "items": {
              "$ref": "#/components/schemas/ElevenLabsMusicCompositionSection"
            }
          }
        }
      },
      "ElevenLabsMusicCompositionSection": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "section_name",
          "positive_local_styles",
          "negative_local_styles",
          "duration_ms",
          "lines"
        ],
        "properties": {
          "section_name": {
            "type": "string",
            "description": "乐章名称（必填）。",
            "examples": [
              "Intro"
            ]
          },
          "positive_local_styles": {
            "type": "array",
            "description": "乐章正面风格标签（必填）。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "piano",
                "light percussion"
              ]
            ]
          },
          "negative_local_styles": {
            "type": "array",
            "description": "乐章负面风格标签（必填）。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "vocals",
                "distortion"
              ]
            ]
          },
          "duration_ms": {
            "type": "integer",
            "description": "乐章时长（毫秒，必填）。计费时长为各 section 的 duration_ms 加总。",
            "examples": [
              3000
            ]
          },
          "lines": {
            "type": "array",
            "description": "该乐章的歌词行（必填，纯音乐段落传空数组 `[]`）。",
            "items": {
              "type": "string"
            },
            "examples": [
              []
            ]
          }
        }
      },
      "ElevenLabsMusicDetailedMetadata": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "composition_plan",
          "song_metadata"
        ],
        "properties": {
          "composition_plan": {
            "$ref": "#/components/schemas/ElevenLabsMusicCompositionPlan"
          },
          "song_metadata": {
            "$ref": "#/components/schemas/ElevenLabsMusicSongMetadata"
          }
        }
      },
      "ElevenLabsMusicSongMetadata": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "title": {
            "type": "string",
            "description": "歌曲标题。",
            "examples": [
              "Jazz Evening"
            ]
          },
          "description": {
            "type": "string",
            "description": "歌曲描述。",
            "examples": [
              "An upbeat jazz composition"
            ]
          },
          "genres": {
            "type": "array",
            "description": "音乐流派。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "jazz"
              ]
            ]
          },
          "languages": {
            "type": "array",
            "description": "歌词使用的语言。",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "en"
              ]
            ]
          },
          "is_explicit": {
            "type": "boolean",
            "description": "歌曲是否包含成人内容。"
          }
        }
      },
      "ElevenLabsMusicAudioBinary": {
        "type": "string",
        "format": "binary",
        "description": "生成的音频二进制流，格式由 `output_format` 决定，默认 mp3。"
      },
      "ElevenLabsMusicDetailedMultipartResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "metadata",
          "audio"
        ],
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/ElevenLabsMusicDetailedMetadata"
          },
          "audio": {
            "$ref": "#/components/schemas/ElevenLabsMusicAudioBinary"
          }
        },
        "description": "`/v1/audio/music/detailed` 端点的 multipart/mixed 响应，包含两部分：JSON 元数据（编曲计划 + 歌曲元信息）和音频二进制数据。响应原样透传上游，与 ElevenLabs 官方 API 行为一致。\n"
      },
      "ElevenLabsMusicErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ElevenLabsMusicErrorObject"
          }
        }
      },
      "ElevenLabsMusicErrorObject": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "message",
          "type"
        ],
        "properties": {
          "message": {
            "type": "string",
            "description": "错误说明。",
            "examples": [
              "Invalid param"
            ]
          },
          "type": {
            "type": "string",
            "description": "错误类型。",
            "examples": [
              "invalid_request_error"
            ]
          },
          "code": {
            "type": [
              "string",
              "null"
            ],
            "description": "机器可读的错误码。",
            "examples": [
              "param_error"
            ]
          },
          "param": {
            "type": [
              "string",
              "null"
            ],
            "description": "与错误相关的请求参数。",
            "examples": [
              "music_length_ms"
            ]
          }
        }
      }
    },
    "examples": {
      "ElevenLabsMusicGeneratePromptRequest": {
        "summary": "根据文本提示词生成音乐（input 模式）",
        "value": {
          "model": "music-v1",
          "input": "A happy piano melody with soft jazz undertones",
          "music_length_ms": 30000,
          "output_format": "mp3_22050_32"
        }
      },
      "ElevenLabsMusicGeneratePlanRequest": {
        "summary": "根据 composition_plan 生成音乐",
        "description": "composition_plan 模式示例。注意：不能传 `music_length_ms`，时长由各 section 的 `duration_ms` 加总决定。\n",
        "value": {
          "model": "music-v1",
          "composition_plan": {
            "positive_global_styles": [
              "jazz",
              "upbeat"
            ],
            "negative_global_styles": [
              "heavy metal",
              "aggressive"
            ],
            "sections": [
              {
                "section_name": "Intro",
                "positive_local_styles": [
                  "piano",
                  "light percussion"
                ],
                "negative_local_styles": [
                  "vocals",
                  "distortion"
                ],
                "duration_ms": 3000,
                "lines": []
              },
              {
                "section_name": "Verse",
                "positive_local_styles": [
                  "saxophone",
                  "swing rhythm"
                ],
                "negative_local_styles": [
                  "harsh drums"
                ],
                "duration_ms": 7000,
                "lines": [
                  "Swinging through the night..."
                ]
              }
            ]
          },
          "seed": 12345,
          "output_format": "mp3_22050_32"
        }
      },
      "ElevenLabsMusicStreamRequest": {
        "summary": "流式生成音乐（input 模式）",
        "value": {
          "model": "music-v1",
          "input": "A calm guitar piece with nature sounds",
          "music_length_ms": 30000,
          "output_format": "mp3_22050_32"
        }
      },
      "ElevenLabsMusicDetailedRequest": {
        "summary": "input 模式生成带元数据音乐",
        "value": {
          "model": "music-v1",
          "input": "An upbeat jazz tune",
          "music_length_ms": 10000
        }
      },
      "ElevenLabsMusicDetailedPlanRequest": {
        "summary": "composition_plan 模式生成带元数据音乐",
        "description": "composition_plan 模式示例，禁止传 `music_length_ms`。",
        "value": {
          "model": "music-v1",
          "composition_plan": {
            "positive_global_styles": [
              "jazz",
              "upbeat"
            ],
            "negative_global_styles": [
              "heavy metal",
              "aggressive"
            ],
            "sections": [
              {
                "section_name": "Intro",
                "positive_local_styles": [
                  "piano",
                  "light percussion"
                ],
                "negative_local_styles": [
                  "vocals",
                  "distortion"
                ],
                "duration_ms": 3000,
                "lines": []
              },
              {
                "section_name": "Verse",
                "positive_local_styles": [
                  "saxophone",
                  "swing rhythm"
                ],
                "negative_local_styles": [
                  "harsh drums"
                ],
                "duration_ms": 7000,
                "lines": [
                  "Swinging through the night..."
                ]
              }
            ]
          },
          "respect_sections_durations": true,
          "with_timestamps": false
        }
      },
      "ElevenLabsMusicDetailedMultipartResponse": {
        "summary": "multipart 元数据和音频响应",
        "value": {
          "metadata": {
            "composition_plan": {
              "positive_global_styles": [
                "jazz",
                "upbeat"
              ],
              "negative_global_styles": [
                "heavy metal",
                "aggressive"
              ],
              "sections": [
                {
                  "section_name": "Intro",
                  "positive_local_styles": [
                    "piano",
                    "light percussion"
                  ],
                  "negative_local_styles": [
                    "vocals",
                    "distortion"
                  ],
                  "duration_ms": 3000,
                  "lines": []
                },
                {
                  "section_name": "Verse",
                  "positive_local_styles": [
                    "saxophone",
                    "swing rhythm"
                  ],
                  "negative_local_styles": [
                    "harsh drums"
                  ],
                  "duration_ms": 7000,
                  "lines": [
                    "Swinging through the night..."
                  ]
                }
              ]
            },
            "song_metadata": {
              "title": "Jazz Evening",
              "description": "An upbeat jazz composition",
              "genres": [
                "jazz"
              ],
              "languages": [
                "en"
              ],
              "is_explicit": false
            }
          },
          "audio": "<binary MP3 audio bytes>"
        }
      },
      "ElevenLabsMusicPlanRequest": {
        "summary": "根据文字描述创建编曲计划",
        "value": {
          "model": "music-v1",
          "prompt": "A soft lullaby with gentle piano and female vocals",
          "music_length_ms": 30000
        }
      },
      "ElevenLabsMusicPlanFromSourceRequest": {
        "summary": "基于已有编曲计划创建新编曲计划",
        "value": {
          "model": "music-v1",
          "prompt": "A longer version with gentle piano and soft female vocals",
          "music_length_ms": 60000,
          "source_composition_plan": {
            "positive_global_styles": [
              "lullaby",
              "soft",
              "gentle",
              "calming",
              "acoustic"
            ],
            "negative_global_styles": [
              "loud",
              "heavy drums",
              "fast tempo",
              "aggressive"
            ],
            "sections": [
              {
                "section_name": "Verse 1",
                "positive_local_styles": [
                  "soft female vocal",
                  "gentle acoustic guitar",
                  "slow tempo"
                ],
                "negative_local_styles": [
                  "percussion",
                  "bass guitar"
                ],
                "duration_ms": 15000,
                "lines": [
                  "Close your eyes and drift away,",
                  "Safe and sound until the day."
                ]
              }
            ]
          }
        }
      },
      "ElevenLabsMusicPlanResponse": {
        "summary": "生成的编曲计划",
        "value": {
          "positive_global_styles": [
            "lullaby",
            "soft",
            "gentle",
            "calming",
            "acoustic"
          ],
          "negative_global_styles": [
            "loud",
            "heavy drums",
            "fast tempo",
            "aggressive"
          ],
          "sections": [
            {
              "section_name": "Verse 1",
              "positive_local_styles": [
                "soft female vocal",
                "gentle acoustic guitar",
                "slow tempo"
              ],
              "negative_local_styles": [
                "percussion",
                "bass guitar"
              ],
              "duration_ms": 15000,
              "lines": [
                "Close your eyes and drift away,",
                "Safe and sound until the day."
              ]
            },
            {
              "section_name": "Verse 2",
              "positive_local_styles": [
                "soft female vocal",
                "hushed delivery",
                "dreamy atmosphere"
              ],
              "negative_local_styles": [
                "strong vocals",
                "drums"
              ],
              "duration_ms": 15000,
              "lines": [
                "Stars above are shining bright,",
                "Sleep now, darling, sleep so deep."
              ]
            }
          ]
        }
      },
      "ElevenLabsMusicInvalidRequestError": {
        "summary": "源文档中的无效参数示例",
        "value": {
          "error": {
            "message": "music_length_ms must be between 1 and 600000.",
            "type": "invalid_request_error",
            "code": "param_error",
            "param": "music_length_ms"
          }
        }
      }
    }
  }
}
```