音乐延伸

对已有音频续写，异步任务
用 clip_id 引用源音频，指定起点与时长
产出的是新的 clip_id，后续操作要用新值

POST/v1/music/generations/extendFlowMusic

认证

string必填

所有接口均使用 Bearer Token 进行认证。

获取 API Key：访问控制台创建。

请求时在请求头中添加：

Authorization: Bearer YOUR_OAIRoute_KEY

请求参数

string必填

固定填 flowmusic，大小写不敏感。

string必填

源音频标识，取自成功任务的 result.music[].clip_id。

源任务必须已完成。外部音频需先调「上传音频」接口换取 clip_id。

number必填

从第几秒开始续写。不能超过源 clip 的实际时长，超出返回 400。

number必填

续写时长，单位秒。上限 164 秒，超出返回 400。

string必填

续写编辑指令。例如「延续主歌旋律，加入弦乐」。

string可选

续写后作品的标题。

string可选

随机种子，用于复现结果。

结果字段

result.music[] 的元素字段 · 7 项

string

新的音频标识。后续再做延伸或分轨时要用这个新值，不是原来的 clip_id。

string

标题，未指定时形如 Untitled (Extended)。

string

时长，字符串形式的浮点秒数，例如 "39.95733333"。

string

音频地址，.m4a。

string

WAV 格式地址。

string

封面图地址。

array

时间轴标记，元素为 [时间, 值] 二元数组。

两个数值上限

字段	上限	超限结果
`extend_from_s`	源 clip 的实际时长	400
`extend_s`	164 秒	400

extend_from_s 的上限不是固定值，取决于源音频多长。所以要先查一次源任务，拿到 duration_seconds 再决定起点。

duration_seconds 是字符串。做比较前要先转成浮点数，否则 "39.9" > 40 这种字符串比较会给出错误结果。

Field	Limit	Result when exceeded
`extend_from_s`	The source clip's actual duration	400
`extend_s`	164 seconds	400

The extend_from_s limit isn't fixed; it depends on how long the source audio is. So query the source task first to get duration_seconds before deciding the start point.

duration_seconds is a string. Convert it to a float before comparing, or string comparison like "39.9" > 40 gives the wrong answer.

错误码

错误响应的格式、状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

使用示例

提交一个任务并拿到 task_id：

提交成功只表示任务已受理。真正的产物要拿返回的 task_id 去任务查询接口轮询，status 变成 completed 之后才有结果。

curl --request POST \ --url 'https://api.oairoute.com/v1/music/generations/extendFlowMusic' \ --header 'Authorization: Bearer YOUR_OAIRoute_KEY' \ --header 'Content-Type: application/json' \ --data '{ "model": "flowmusic", "clip_id": "c_01KA", "extend_from_s": 30, "extend_s": 60, "instruction": "延续主歌旋律，加入弦乐" }'

import requests res = requests.post( "https://api.oairoute.com/v1/music/generations/extendFlowMusic", headers={ "Authorization": "Bearer YOUR_OAIRoute_KEY", "Content-Type": "application/json", }, json={ "model": "flowmusic", "clip_id": "c_01KA", "extend_from_s": 30, "extend_s": 60, "instruction": "延续主歌旋律，加入弦乐", }, ) print(res.json()["data"][0]["task_id"])

const url = "https://api.oairoute.com/v1/music/generations/extendFlowMusic"; const options = { method: "POST", headers: { "Authorization": "Bearer YOUR_OAIRoute_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "model": "flowmusic", "clip_id": "c_01KA", "extend_from_s": 30, "extend_s": 60, "instruction": "延续主歌旋律，加入弦乐" }), }; fetch(url, options) .then((res) => res.json()) .then((json) => console.log(json)) .catch((err) => console.error(err));