跳到主要内容

上传并扩展音乐

POST 
/api/v1/generate/upload-extend

此 API 在保留音频轨道原始样式的同时扩展了音轨。它包括 Suno 的上传功能，允许用户上传音频文件进行处理。预期的结果是更长的音轨，无缝地延续输入的风格。

参数使用指南​

  • 当 defaultParamFlag 为 true（自定义参数）时：

    • 需要提供 prompt、style、title、continueAt和uploadUrl
    • prompt 长度限制：3000字符
    • style 长度限制：200字符
    • title 长度限制：80字符
    • continueAt 音频开始扩展的秒数
    • uploadUrl 用于指定音频文件的上传位置;确保上传的音频长度不超过 2 分钟。

  • 当 defaultParamFlag 为 false（使用默认参数）时：

    • 仅需提供 uploadUrl
    • 其他参数将使用原音频的参数

开发者注意事项​

  1. 生成的文件将保留15天
  2. 模型版本必须与源音乐保持一致
  3. 此功能非常适合通过延长现有音乐创作更长的作品
  4. uploadUrl 参数用于指定音频文件的上传位置;请提供有效的 URL。

Request​

Responses​

请求成功

Callbacks​

POST 
{$request.body#/callBackUrl}

当音频生成完成时，系统会调用此回调通知结果。

回调示例​

{
  "code": 200,
  "msg": "All generated successfully.",
  "data": {
    "callbackType": "complete",
    "task_id": "2fac****9f72",
    "data": [
      {
        "id": "8551****662c",
        "audio_url": "https://example.cn/****.mp3",
        "source_audio_url": "https://example.cn/****.mp3",
        "stream_audio_url": "https://example.cn/****",
        "source_stream_audio_url": "https://example.cn/****",
        "image_url": "https://example.cn/****.jpeg",
        "source_image_url": "https://example.cn/****.jpeg",
        "prompt": "[Verse] 夜晚城市 灯火辉煌",
        "model_name": "chirp-v3-5",
        "title": "钢铁侠",
        "tags": "electrifying, rock",
        "createTime": "2025-01-01 00:00:00",
        "duration": 198.44
      }
    ]
  }
}

Callbacks Responses​

回调接收成功