跳转到主要内容
POST
/
eleven
/
upload
上传音频（Inpainting 前置步骤）
curl --request POST \
  --url https://api.mountsea.ai/eleven/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "audioUrl": "https://example.com/song.mp3",
  "extractCompositionPlan": false
}
'
{
  "taskId": "<string>"
}
此端点仅限具备 Inpainting 权限的企业客户使用。
将已有音频文件上传至 ElevenLabs，获取 song_id 用于 Inpainting 编辑。
这是一个异步任务。响应中包含 taskId — 使用获取任务状态轮询获取 songId 和可选的 compositionPlan。

​
Inpainting 工作流程

1

上传音频

调用 POST /eleven/upload 传入音频 URL，获取 song_id。
2

在作曲计划中引用

在 POST /eleven/music 中，使用 song_id 填入 compositionPlan.sections[].source_from，引用上传歌曲的特定片段。
3

定义编辑范围

使用 source_from.range 指定要保留的时间范围，negative_ranges 排除该范围内的子片段。
设置 extractCompositionPlan: true 可同时提取上传音频的结构作为作曲计划，然后修改并用于重新生成。

授权

​
Authorization
string
header
必填

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

请求体

application/json
​
audioUrl
string
必填

音频文件 URL (http/https)，支持格式: .mp3, .wav, .flac, .m4a, .aac, .ogg, .wma, .opus

Pattern: AUDIO_EXTENSION_REGEX
示例:

"https://example.com/song.mp3"

​
extractCompositionPlan
boolean
默认值:false

是否提取并返回上传音频的作曲计划（composition_plan）。设为 true 时，响应中将包含解析出的段落结构信息，但会增加接口延迟

响应

200 - application/json

任务创建成功

​
taskId
string
必填

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