Generate Music
延长音乐
延长或修改现有音乐作品。
POST
参数使用指南
-
model（string，必填）：
V4_5ALL、V4、V4_5、V4_5PLUS、V5、V5_5。V5_5：释放你的声音：定制模型，贴合你的独特品味 — 与V5的自定义参数字数上限一致。 -
当 defaultParamFlag 为 true（自定义参数）时：
- 需要提供
prompt、style、title和continueAt - 按模型的字符限制：
- V4：
prompt最多 3000，style最多 200，title最多 80 - V4_5ALL：
prompt最多 5000，style最多 1000，title最多 80 - V4_5、V4_5PLUS、V5、V5_5：
prompt最多 5000，style最多 1000，title最多 100
- V4：
- 需要提供
-
当 defaultParamFlag 为 false（使用默认参数）时：
- 业务参数仅需
audioId；接口仍必填model与callBackUrl - 其余创作相关字段沿用原音频参数
- 业务参数仅需
可选参数
以下字段为可选控制项：
- vocalGender（string）：偏好人声性别。允许值：
m（男）、f（女） - styleWeight（number）：风格贴合权重，范围 0–1（建议保留两位小数）
- weirdnessConstraint（number）：创造性/新颖度约束，范围 0–1（建议保留两位小数）
- audioWeight（number）：音频一致性相对权重，范围 0–1（建议保留两位小数）
- personaId（string）：使用自定义参数时可传入 Persona ID 或 Suno Voice 生成的
voiceId。如果使用 Voice 生成的 ID，personaModel必须设置为voice_persona。 - personaModel（string）：Persona 类型。生成 Persona 接口返回的 ID 使用
style_persona，Suno Voice 生成的 ID 使用voice_persona。
开发者注意事项
- 生成的文件将保留15天
- 模型版本必须与源音乐保持一致
- 此功能非常适合通过延长现有音乐创作更长的作品
授权
🔑 API 认证说明
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key
- 访问 API Key 管理页面 获取您的 API Key
使用方式
在请求头中添加：
Authorization: Bearer YOUR_API_KEY⚠️ 注意：
- 请妥善保管您的 API Key，不要泄露给他人
- 如果怀疑 API Key 泄露，请立即在管理页面重置
请求体
application/json
控制参数使用模式。
true：使用自定义参数（需要提供continueAt、prompt、style和title）。false：使用原始音频参数（只需提供audioId）。
示例:
true
要延长的音轨的音频ID。这是将要继续的源音轨。
示例:
"e231****-****-****-****-****8cadc7dc"
用于生成的AI模型版本。
- 所有请求都必填。
- 可用选项：
V5：更卓越的音乐表现力，生成速度更快。V5_5：释放你的声音：定制模型，贴合你的独特品味。与 V5 的自定义模式下prompt、style字数上限一致（5000 / 1000）。V4_5PLUS：V4.5+ 音色更丰富，新的创作方式，最长8分钟。V4_5：V4.5 更智能的提示词，更快的生成速度，最长8分钟。V4：V4 改进的人声质量，最长4分钟。V4_5ALL：V4.5-all 更好的歌曲结构，最长8分钟。
可用选项:
V4_5ALL, V4, V4_5, V4_5PLUS, V5, V5_5 示例:
"V4_5ALL"
描述音乐应如何延长。当 defaultParamFlag 为 true 时必填。
示例:
"用更多舒缓的音符延长音乐"
音乐风格，例如爵士、古典、电子等
示例:
"古典"
音乐标题
示例:
"宁静钢琴延长版"
音频开始扩展的时间点（以秒为单位）。
- 当
defaultParamFlag为true时必填。 - 取值范围：大于0且小于该生成音频的总时长。
- 指定从原始音频的哪个时间点开始进行扩展。
示例:
60
仅在开启自定义参数时可用。应用到生成音乐的 Persona ID，可选。你可以传入以下两类 ID：
- 通过 生成 Persona 接口生成的 Persona ID。此时可使用
personaModel: style_persona，或省略personaModel使用默认值。 - 通过 Suno Voice 流程生成的
voiceId。当使用 Voice 生成的 ID 时，必须设置personaModel: voice_persona。
示例:
"persona_123"
使用 personaId 时应用的 Persona 模型类型，可选。
style_persona（默认）：用于生成 Persona 接口返回的 Persona ID。voice_persona：当personaId使用 Suno Voice 生成的voiceId时必须选择该值。该选项仅在 V5 与 V5_5 模型下可用。
可用选项:
style_persona, voice_persona 示例:
"style_persona"
需要在生成中排除的音乐风格
示例:
"舒缓钢琴"
偏好人声性别。可选。允许值：'m'（男）、'f'（女）
可用选项:
m, f 示例:
"m"
风格贴合权重。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.65
创造性/新颖度约束。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.65
音频一致性与其他控制项的相对权重。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.65
回调
响应
请求成功
状态码说明
- ✅ 200 - 请求成功
- ⚠️ 400 - 参数错误
- ⚠️ 401 - 没有访问权限
- ⚠️ 404 - 请求方式或者路径错误
- ⚠️ 405 - 调用超过限制
- ⚠️ 413 - 主题或者prompt过长
- ⚠️ 429 - 积分不足
- ⚠️ 430 - 您的调用频率过高。请稍后再试。
- ⚠️ 455 - 网站维护
- ❌ 500 - 服务器异常
可用选项:
200, 400, 401, 404, 405, 413, 429, 430, 455, 500 示例:
200
当 code != 200 时，展示错误信息
示例:
"success"