{
  "instrumental": false,
  "lyrics": "[Chorus] 灯火更亮，我们继续向前",
  "prompt": "[Verse] 霓虹雨下城市低鸣",
  "style": "Electropop",
  "title": "Shimmer (Extended)",
  "continueAt": 45,
  "uploadUrl": "https://storage.example.com/upload",
  "model": "V6",
  "callBackUrl": "https://example.com/callback",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65,
  "variety": 1
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

POST

api

generate

upload-extend

{
  "instrumental": false,
  "lyrics": "[Chorus] 灯火更亮，我们继续向前",
  "prompt": "[Verse] 霓虹雨下城市低鸣",
  "style": "Electropop",
  "title": "Shimmer (Extended)",
  "continueAt": 45,
  "uploadUrl": "https://storage.example.com/upload",
  "model": "V6",
  "callBackUrl": "https://example.com/callback",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65,
  "variety": 1
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

模型版本

当前模型：V6（默认）、V6_WILD、V6_MINI
已废弃模型：V5_5、V5、V4_5PLUS、V4_5ALL、V4_5、V4
废弃值仅为向后兼容保留，新接入请使用 V6 系列模型。

参数使用指南

本接口固定为自定义参数，简单模式不可用。
提供源音频（uploadUrl）即可生成。lyrics、prompt、style、title 均为选填。
instrumental（boolean，可选）：决定是否生成纯音乐，默认值为 false
- 如果 instrumental 为 true：生成纯音乐。无需填写 prompt、lyrics 和 vocalGender
- 如果 instrumental 为 false：优先使用 lyrics 作为歌词；未传 lyrics 时使用 prompt。二者均为选填。vocalGender 也为选填
prompt 为选填，按歌词语义使用。同时传入 lyrics 时，优先使用 lyrics，prompt 不再作为歌词
lyrics 为选填，优先于 prompt 作为歌词。未传 lyrics 时使用 prompt 作为歌词
字符限制（基于模型）：
- V4 模型（已废弃）：prompt 最多 3000 字符，style 最多 200 字符，title 最多 80 字符
- V4_5、V4_5PLUS、V5、V5_5 和 V4_5ALL 模型（已废弃）：prompt 最多 5000 字符，style 最多 1000 字符；V4_5ALL 的 title 最多 80 字符，其余最多 100 字符
- V6、V6_WILD 和 V6_MINI 模型：prompt 与 lyrics 最多 5000 字符，style 最多 1000 字符，title 最多 100 字符
model（string，必填）：V6、V6_WILD、V6_MINI。已废弃：V4_5ALL、V4、V4_5、V4_5PLUS、V5、V5_5。
continueAt 音频开始扩展的秒数（该参数必填，需大于 0，且小于所上传音频的时长）
uploadUrl 源音频 URL，必填。确保上传的音频长度不超过 8 分钟。

可选参数

以下字段为可选控制项：

lyrics（string）：延长所用歌词。选填。优先于 prompt；未传时使用 prompt 作为歌词。V6、V6_WILD、V6_MINI 最多 5000 字符。
vocalGender（string）：可选，无论 instrumental 为 true 无需填写。允许值：m（男）、f（女）
styleWeight（number）：风格贴合权重，范围 0–1（建议保留两位小数）
weirdnessConstraint（number）：创造性/新颖度约束，范围 0–1（建议保留两位小数）
audioWeight（number）：音频一致性相对权重，范围 0–1（建议保留两位小数）
variety（integer）：生成结果的多样性。范围 0–4 的整数，默认 1。0 关，1 普通（默认），2 高，3 额外，4 最大。
personaId（string）：应用到生成音乐的 Persona ID 或 Suno Voice 生成的 voiceId。如果使用 Voice 生成的 ID，personaModel 必须设置为 voice_persona。
personaModel（string）：Persona 类型。生成 Persona 接口返回的 ID 使用 style_persona，Suno Voice 生成的 ID 使用 voice_persona。

{
  "instrumental": false,
  "lyrics": "[Chorus] 灯火更亮，我们继续向前",
  "prompt": "[Verse] 霓虹雨下城市低鸣",
  "style": "Electropop",
  "title": "Shimmer (Extended)",
  "continueAt": 45,
  "uploadUrl": "https://storage.example.com/upload",
  "model": "V6",
  "callBackUrl": "https://example.com/callback",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65,
  "variety": 1
}

开发者注意事项

生成的文件将保留14天
模型版本必须与源音乐保持一致
此功能非常适合通过延长现有音乐创作更长的作品
请注意 prompt、lyrics、style 和 title 的字符长度限制，确保成功处理
uploadUrl 为源音频 URL，提供后即可生成；请提供有效的 URL。

授权

Authorization

string

header

必填

🔑 API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

访问 API Key 管理页面获取您的 API Key

使用方式

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

⚠️ 注意：

请妥善保管您的 API Key，不要泄露给他人

如果怀疑 API Key 泄露，请立即在管理页面重置

请求体

application/json

uploadUrl

string<uri>

必填

源音频 URL。必填。提供源音频即可生成；lyrics、prompt、style、title 均为选填。确保上传的音频长度不超过 8 分钟。

示例:

"https://api.example.com/upload"

continueAt

number

必填

音频开始扩展的时间点（以秒为单位）。

必填。
取值范围：大于0且小于上传音频的总时长。
指定从原始音频的哪个时间点开始进行扩展。

示例:

60

model

enum<string>

默认值:V6

必填

AI 模型版本。默认值：V6。

V6：当前标准模型，推荐默认使用。
V6_WILD：当前实验性、创造性更强的模型。
V6_MINI：当前轻量模型。
已废弃：V5_5、V5、V4_5PLUS、V4_5ALL、V4_5、V4。这些值仅为向后兼容保留，新接入请使用 V6 系列模型。

可用选项:

V6,

V6_WILD,

V6_MINI,

V5_5,

V5,

V4_5PLUS,

V4_5ALL,

V4_5,

V4

示例:

"V6"

callBackUrl

string<uri>

必填

在音乐延长完成时接收任务完成通知的URL。

详细的回调格式和实现指南，请参见上传并扩展音频回调
或者，您也可以使用获取音乐生成详情接口来轮询任务状态

示例:

"https://api.example.com/callback"

instrumental

boolean

默认值:false

决定音频是否为纯音乐（无歌词）。本接口固定为自定义参数。可选，默认值为 false。

如果为 true：生成纯音乐。无需填写 prompt、lyrics 和 vocalGender。
如果为 false：优先使用 lyrics 作为歌词；未传 lyrics 时使用 prompt。二者均为选填。无需填写 vocalGender。
style 和 title 在两种情况下均为选填。

示例:

false

prompt

string

延长所用歌词。选填。提供后按歌词使用。若同时传入 lyrics，优先使用 lyrics，prompt 不再作为歌词。不同模型的字符限制：

V4（已废弃）：最大3000字符
V4_5、V4_5PLUS、V4_5ALL、V5 和 V5_5（已废弃）：最大5000字符
V6、V6_WILD 和 V6_MINI：最大5000字符

示例:

"[Verse] 霓虹雨下城市低鸣"

lyrics

string

延长所用歌词。选填。优先于 prompt 作为歌词。未传 lyrics 时使用 prompt 作为歌词。

V6、V6_WILD 和 V6_MINI：最大5000字符

示例:

"[Chorus] 灯火更亮，我们继续向前"

style

string

音乐风格，例如爵士、古典、电子等。选填。仅提供源音频（uploadUrl）即可生成。不同模型的字符限制：

V4（已废弃）：最大200字符
V4_5、V4_5PLUS、V5、V5_5 和 V4_5ALL（已废弃）：最大1000字符
V6、V6_WILD 和 V6_MINI：最大1000字符

示例:

"古典"

title

string

音乐标题。选填。不同模型的字符限制：

V4 和 V4_5ALL（已废弃）：最大80字符
V4_5、V4_5PLUS、V5 和 V5_5（已废弃）：最大100字符
V6、V6_WILD 和 V6_MINI：最大100字符

示例:

"宁静钢琴延长版"

personaId

string

应用到生成音乐的 Persona ID，可选。你可以传入以下两类 ID：

通过生成 Persona 接口生成的 Persona ID。此时可使用 personaModel: style_persona，或省略 personaModel 使用默认值。
通过 Suno Voice 流程生成的 voiceId。当使用 Voice 生成的 ID 时，必须设置 personaModel: voice_persona。

示例:

"persona_123"

personaModel

enum<string>

默认值:style_persona

使用 personaId 时应用的 Persona 模型类型，可选。

style_persona（默认）：用于生成 Persona 接口返回的 Persona ID。
voice_persona：当 personaId 使用 Suno Voice 生成的 voiceId 时必须选择该值。该选项仅在 V5（已废弃）、V5_5（已废弃）、V6、V6_WILD 和 V6_MINI 模型下可用。

可用选项:

style_persona,

voice_persona

示例:

"style_persona"

negativeTags

string

需要在生成中排除的音乐风格

示例:

"舒缓钢琴"

vocalGender

enum<string>

偏好人声性别。可选， instrumental 为 true 无需填写。允许值：'m'（男）、'f'（女）。

可用选项:

m,

f

示例:

"m"

styleWeight

number

风格贴合权重。可选。范围：0-1。建议保留两位小数。

必填范围: 0 <= x <= 1必须是以下数值的倍数 0.01

示例:

0.65

weirdnessConstraint

number

创造性/新颖度约束。可选。范围：0-1。建议保留两位小数。

必填范围: 0 <= x <= 1必须是以下数值的倍数 0.01

示例:

0.65

audioWeight

number

音频一致性与其他控制项的相对权重。可选。范围：0-1。建议保留两位小数。

必填范围: 0 <= x <= 1必须是以下数值的倍数 0.01

示例:

0.65

variety

integer

默认值:1

生成结果的多样性。可选。范围 0–4 的整数，默认值为 1。

0：关，完全关闭，严格用同一风格
1：普通，默认值，在稳定性和多样性之间保持平衡
2：高，生成风格差异明显的结果
3：额外，更高程度的变化，鼓励大胆探索
4：最大，最大程度增加多样性

必填范围: 0 <= x <= 4必须是以下数值的倍数 1

示例:

1

回调

POST

{$request.body#/callBackUrl}audioExtend

请求体

application/json

code

integer

状态码

示例:

200

msg

string

返回消息

示例:

"All generated successfully"

data

object

Show child attributes

响应

200

回调接收成功

响应

请求成功

code

enum<integer>

状态码说明

✅ 200 - 请求成功
⚠️ 400 - 参数错误
⚠️ 401 - 没有访问权限
⚠️ 404 - 请求方式或者路径错误
⚠️ 405 - 调用超过限制
⚠️ 413 - 主题或者prompt过长
⚠️ 429 - 积分不足
⚠️ 430 - 您的调用频率过高。请稍后再试。
⚠️ 455 - 网站维护
❌ 500 - 服务器异常

可用选项:

200,

400,

401,

404,

405,

413,

429,

430,

455,

500

示例:

200

msg

string

当 code != 200 时，展示错误信息

示例:

"success"

data

object

Show child attributes

Generate Music

Suno Voice

Lyrics Generation

Generate Sounds

WAV Conversion

Vocal Removal

Music Video Generation

Account Management

文件上传API

上传并扩展音乐

模型版本

参数使用指南

可选参数

开发者注意事项

授权

🔑 API 认证说明

获取 API Key

使用方式

请求体

回调

请求体

响应

响应

状态码说明

​模型版本

​参数使用指南

​可选参数

​开发者注意事项

授权

🔑 API 认证说明

获取 API Key

使用方式

请求体

回调

请求体

响应

响应

状态码说明

模型版本

参数使用指南

可选参数

开发者注意事项