Upload and Extend

Submit this Suno capability through POST /v1/music/generations with model: "suno-upload-extend". Provide a public audio_url and continue_at. You do not need to call suno-upload first.

Authorization

BearerAuth

AuthorizationBearer <token>

使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。

In: header

Request Body

application/json

model*string

固定填写 suno-upload-extend。

audio_url*string

公网可访问的 HTTP(S) 音频直链，建议不超过 8 分钟。本地路径与 blob: URL 不可用。

Formaturi

continue_at*number

延伸起点，必须大于等于 1 秒，并严格小于源音频实际时长。

Range1 <= value

version?string

公共版本：v6 / v6-wild / v6-mini。省略默认 v6。使用 custom_model_id 时省略。

Default"v6"

Value in"v6" | "v6-wild" | "v6-mini"

custom_model_id?string

创建模型任务返回的完整 UUID。与 version、persona_id 互斥。

prompt?string

延伸段歌词，不超过 5000 个字符；省略时按纯音乐延伸语义使用。

Lengthlength <= 5000

tags?string

风格描述，不超过 1000 个字符。

Lengthlength <= 1000

title?string

标题，不超过 80 个字符。

Lengthlength <= 80

negative_tags?string

不希望出现的风格。

style_weight?number

风格权重，范围 0–1。

Range0 <= value <= 1

weirdness?number

创意度权重，范围 0–1。

Range0 <= value <= 1

audio_weight?number

音频权重，范围 0–1。

Range0 <= value <= 1

auto_lyrics?boolean

是否对输入歌词进行二次创作。

vocal_gender?string

人声性别：Male / Female。

Value in"Male" | "Female"

persona_id?string

Persona ID，与 custom_model_id 互斥。

duration_s?integer

目标生成时长，范围 10–360 秒。实际成品时长以任务结果为准。

Range10 <= value <= 360

variety?string

风格变化程度：off / normal / high / extra / max。

Value in"off" | "normal" | "high" | "extra" | "max"

max_mode?boolean

是否启用 Max 模式；启用后按普通售价的 2 倍计费。

Defaultfalse

audio_format?string

输出格式：mp3 / m4a / wav。

Value in"mp3" | "m4a" | "wav"

Response Body

application/json

curl -X POST "https://loading/v1/music/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-upload-extend",
    "version": "v6-mini",
    "audio_url": "https://example.com/reference.wav",
    "continue_at": 30,
    "prompt": "[Outro]\n下一段旅途，我们一起走",
    "tags": "acoustic pop",
    "duration_s": 60,
    "max_mode": true,
    "audio_format": "mp3"
  }'

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-upload-extend",    "version": "v6-mini",    "audio_url": "https://example.com/reference.wav",    "continue_at": 30,    "prompt": "[Outro]\n下一段旅途，我们一起走",    "tags": "acoustic pop",    "duration_s": 60,    "max_mode": true,    "audio_format": "mp3"  }'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"
    }
  ]
}

{
  "code": "invalid_request",
  "message": "audio_url is required",
  "data": null
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json