不必重做即可延长歌曲
Extend Song API 可以延续你已生成的音轨。用 origin_task_id 指向已完成的生成,用 extend_audio_index 选择两个返回音频中要继续的那一个,平台就会创作一段从源结尾接续的新片段。
两种模式覆盖常见流程。继承模式(custom_mode: false)复用原始参数——是把喜欢的版本加长的最快方式。自定义模式(custom_mode: true)接受新提示词、风格、标题和 extensionStartTime,可以重定向编曲——例如把高能量的副歌转成平静的尾奏。
快速上手:延长并轮询
携带源任务向 /v2/extend 发起 POST,然后轮询 /v2/feed?workId=...,或设置 callback_url 接收 webhook。
curl -X POST "https://udioapi.pro/api/v2/extend" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
"extend_audio_index": 0,
"custom_mode": true,
"prompt": "Change the music style to be calm and lyrical.",
"style": "lyrical"
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"extensionStartTime 为可选;取值会被限制在 1 …(源时长 − 1)秒内,缺省从源音轨结尾开始。
延长请求参数
延长按原音轨的模型价格计费。用 chirp-v5 或 chirp-v5-5 创建的音轨由 chirp-v6 延长;更早旧模型的音轨由 chirp-v6-mini 延长。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| origin_task_id | string | 必填 | 原始生成请求的 task_id |
| extend_audio_index | number | 必填 | 要延长哪个返回音频:0 或 1 |
| custom_mode | boolean | 可选 | false 继承源参数(默认);true 启用自定义字段 |
| prompt | string | 自定义模式 | 新歌词或描述,≤ 5000 字符——超长会被截断 |
| style | string | 可选 | 续写风格,≤ 1000 字符——截断 |
| title | string | 可选 | 延长音轨的标题,≤ 80 字符——截断 |
| extensionStartTime | number | 可选 | 起始点(秒);限制在 1 …(源时长 − 1) |
| callback_url | string | 可选 | 接收最终结果的公开 HTTPS webhook |
被拒绝或失败的延长会自动退款——422 响应会说明要修正的参数;受理后的失败在 feed 中标记为 FAILED 并退回积分。
工作原理
从已完成的生成到更长音轨,只需四步。
- 1
生成源音轨
用 /v2/generate 创建歌曲并等待 SUCCESS。保存 task_id 并选定音频序号。
- 2
提交延长
携带 origin_task_id、extend_audio_index 和可选自定义字段向 /v2/extend 发起 POST。
- 3
轮询或接收回调
每 5–10 秒调用 GET /v2/feed?workId=...,或设置 callback_url 接收 webhook。
- 4
下载音频
状态为 SUCCESS 时,feed 包含延长音频的 URL——请保存到自己的存储中。
限制与说明
- 需要一个已完成的源任务,并选择 extend_audio_index 0 或 1——多数生成会返回两个音频。
- 延长继承源模型的价格;chirp-v5/chirp-v5-5 音轨由 chirp-v6 延长,更早旧音轨由 chirp-v6-mini 延长。
- 超长的 prompt、style 和 title 会被截断而不是拒绝。
- extensionStartTime 会被收拢到有效区间,不会导致请求失败。
- 音频 URL 是临时的——请把结果下载到自己的存储。
udioapi.pro 是独立的第三方服务,与 Suno、Udio 或 MiniMax 均无关联,未获其认可,也不由其运营。
Extend Song API 常见问题
关于模式、计费与异步工作流的解答。
Extend Song API 做什么?
它把已完成的生成延续到原结尾之后。继承模式复用源参数;自定义模式接受新提示词、风格、标题和 extensionStartTime。
延长如何计费?
按原音轨的模型价格按次计费。延长 chirp-v6 服务的音轨同样是 12 积分,chirp-v6-mini 是 10 积分。被拒绝和失败的延长自动退款。
该延长哪个音频?
extend_audio_index 设 0 延长第一个返回音频,设 1 延长第二个——多数生成请求会产生两个版本。
选继承模式还是自定义模式?
继承模式(custom_mode: false)按原参数续写;自定义模式(custom_mode: true)让新提示词、风格和标题引导续写。
extensionStartTime 超范围会怎样?
该值会被收拢到 1 …(源时长 − 1)秒而不是失败;缺省或无效时从源音轨结尾开始延长。
延长失败会扣积分吗?
不会。校验阶段被拒的请求返回 422,受理后失败的任务在 feed 中标记 FAILED——两种情况都退还积分。