跳到主要内容

上传并翻唱音乐

POST 
/api/v1/generate/upload-cover

此 API 通过在保留其核心旋律的同时将音轨转换为新样式来覆盖音轨。它结合了 Suno 的上传功能，使用户能够上传音频文件进行处理。预期的结果是刷新了具有新风格的音轨，同时保持了原始旋律的完整性。

参数使用指南​

  • 当 customMode 为 true（自定义模式）时：

    • 如果 instrumental 为 true：需要提供 style、title 和 uploadUrl
    • 如果 instrumental 为 false：需要提供 style、prompt、title和uploadUrl
    • prompt 长度限制：3000字符
    • style 长度限制：200字符
    • title 长度限制：80字符
    • uploadUrl 用于指定音频文件的上传位置;确保上传的音频长度不超过 2 分钟。

  • 当 customMode 为 false（非自定义模式）时：

    • 无论 instrumental 设置如何，只需要提供 prompt和uploadUrl
    • prompt 长度限制：400字符
    • 其他参数应留空

开发者注意事项​

  1. 新用户推荐设置：将 customMode 设为 false，instrumental 设为 false，只提供 prompt和uploadUrl。这是最简单的配置，可以快速测试API并体验结果。
  2. 生成的文件将保留15天后删除
  3. 请根据 customMode 和 instrumental 设置确保提供所有必要参数，避免出错
  4. 请注意 prompt、style 和 title 的字符长度限制，确保成功处理
  5. 回调过程有三个阶段：text（文本生成完成）、first（第一首完成）、complete（全部完成）
  6. 您可以使用音乐生成详情查询接口主动检查任务状态，而不必等待回调
  7. 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
      },
      {
        "id": "bd15****1873",
        "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": 228.28
      }
    ]
  }
}

Callbacks Responses​

回调接收成功