Suno 自定义歌曲上传

用于上传一段可访问的音频文件，获取后续 Suno 自定义歌曲生成、续写、翻唱、分轨等任务可使用的歌曲 ID。

接口地址

POST /suno/upload

请求参数

参数	类型	必填	默认值	说明
audio_url	string	是	-	需要上传的音频文件 URL
async_mode	boolean	否	false	是否使用异步模式

上传的音频会经过 Suno 官方版权验证。如果音频被识别为可能存在版权风险，接口会返回失败结果。

请求示例

{
  "audio_url": "https://example.com/test.mp3",
  "async_mode": false
}

Python 示例

import requests

url = "https://your-domain.com/suno/upload"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "audio_url": "https://example.com/test.mp3",
    "async_mode": False,
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.text)

响应说明

响应中的 data 通常只包含一首歌曲，结构与歌曲生成接口返回的歌曲结构一致。上传完成后，data[0].id 可作为后续 upload_extend、cover、upload_cover、stems、all_stems 等任务的 audio_id 使用。

{
  "success": true,
  "task_id": "upload-task-id",
  "trace_id": "trace-id",
  "data": [
    {
      "id": "uploaded-audio-id",
      "title": "Uploaded Audio",
      "image_url": "",
      "lyric": "",
      "audio_url": "https://example.com/test.mp3",
      "video_url": "",
      "created_at": "2025-04-12T10:38:32.131Z",
      "model": "",
      "state": "succeeded",
      "prompt": null,
      "style": "",
      "duration": 180.0
    }
  ]
}

后续使用

如果要基于上传后的音频继续生成歌曲，请在 歌曲生成 中使用 upload_extend，并传入上传接口返回的 audio_id。

如果要直接通过外部音频 URL 进行上传并生成，可以在 歌曲生成 中使用 upload_generate。

扣费说明

功能	参考积分
自定义歌曲上传	0.02