MAPI
音频(Audio)Suno

续写延长

在已有歌曲的某个时间点之后续写延长。源用 task_id + audio_index(默认 1)。

  • continue_at 必填,必须 ≥1 且小于源音轨实际时长,支持小数秒。
  • version:v6 / v6-wild / v6-mini,省略默认 v6;与 custom_model_id 互斥。
  • custom 省略默认 true(按 prompt 歌词续写);只有显式 custom=false 时才用 gpt_description。
  • max_mode 启用时要求 custom=true,2 倍计费。duration_s 仅 custom=true。新请求用 weirdness。
  • 提交接口:POST /v1/music/generations,model: "suno-extend"。
  • 任务查询:GET /v1/music/generations/{task_id}。
POST
/v1/music/generations

Authorization

BearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

model*string

固定填写 suno-extend。

task_id*string

产出源音轨那次任务的 MAPI 公开 task_id,必填。

audio_index?integer

源任务 result.music[] 中的第几首(1-based,默认 1)。

Default1
continue_at*number

从第几秒开始续写,必须 ≥1 且小于源音轨实际时长。支持小数秒。

version?string

公共版本,省略默认 v6。使用 custom_model_id 时省略。

Default"v6"
Value in"v6" | "v6-wild" | "v6-mini"
custom_model_id?string

自定义模型 UUID。与 version、persona_id 互斥。

custom?boolean

true 按 prompt 歌词续写;false 为灵感续写。省略默认 true。

Defaulttrue
prompt?string

续写歌词,custom=true 时生效。

gpt_description?string

灵感提示词,仅显式 custom=false 时生效。

title?string

标题。仅 custom=true 时生效。

tags?string

风格标签。仅 custom=true 时生效。

negative_tags?string

排除的风格标签。仅 custom=true 时生效。

vocal_gender?string

人声性别。两种模式均生效。

Value in"Male" | "Female"
style_weight?number

风格权重 0.00–1.00。仅 custom=true 时生效。

Range0 <= value <= 1
weirdness?number

创意度。新请求用本字段;兼容 weirdness_constraint。

Range0 <= value <= 1
weirdness_constraint?number

weirdness 的兼容旧名。

Range0 <= value <= 1
audio_weight?number

音频权重。仅 custom=true 时生效。

Range0 <= value <= 1
auto_lyrics?boolean

对输入歌词二次创作。仅 custom=true 时生效。

persona_id?string

Persona ID。仅 custom=true,与 custom_model_id 互斥。

duration_s?number

目标时长 10–360 秒,仅 custom=true。

Range10 <= value <= 360
variety?string

风格变化程度,可省略。

Value in"off" | "normal" | "high" | "extra" | "max"
max_mode?boolean

Max 模式。启用要求 custom=true,按 2 倍计费。

Defaultfalse
audio_format?string

输出音频格式。

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

Response Body

application/json

application/json

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-extend",    "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",    "audio_index": 1,    "continue_at": 120,    "version": "v6",    "custom": true,    "prompt": "[Outro]\n我们一起走向远方"  }'
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
    }
  ]
}
{
  "code": "invalid_request",
  "message": "continue_at is required",
  "data": null
}

最后更新于