模型端点 · POST /v2/extend

Extend Song API

把已完成的生成延续到原结尾之后。可以继承源音轨的设置,也可以用你自己的提示词、风格和标题引导续写——全部通过一个异步 REST 端点完成。

按原音轨的模型价格计费

不必重做即可延长歌曲

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
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_idstring必填原始生成请求的 task_id
extend_audio_indexnumber必填要延长哪个返回音频:0 或 1
custom_modeboolean可选false 继承源参数(默认);true 启用自定义字段
promptstring自定义模式新歌词或描述,≤ 5000 字符——超长会被截断
stylestring可选续写风格,≤ 1000 字符——截断
titlestring可选延长音轨的标题,≤ 80 字符——截断
extensionStartTimenumber可选起始点(秒);限制在 1 …(源时长 − 1)
callback_urlstring可选接收最终结果的公开 HTTPS webhook

被拒绝或失败的延长会自动退款——422 响应会说明要修正的参数;受理后的失败在 feed 中标记为 FAILED 并退回积分。

工作原理

从已完成的生成到更长音轨,只需四步。

  1. 1

    生成源音轨

    用 /v2/generate 创建歌曲并等待 SUCCESS。保存 task_id 并选定音频序号。

  2. 2

    提交延长

    携带 origin_task_id、extend_audio_index 和可选自定义字段向 /v2/extend 发起 POST。

  3. 3

    轮询或接收回调

    每 5–10 秒调用 GET /v2/feed?workId=...,或设置 callback_url 接收 webhook。

  4. 4

    下载音频

    状态为 SUCCESS 时,feed 包含延长音频的 URL——请保存到自己的存储中。

按原模型价格付费

延长按原音轨的模型价格计费——chirp-v6 服务的音轨约 $0.12,chirp-v6-mini 约 $0.10,按 1 USD = 100 积分折算。

被拒绝(422)和失败的延长会自动退款。按需积分永不过期。

限制与说明

  • 需要一个已完成的源任务,并选择 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——两种情况都退还积分。