音频(Audio)Suno
风格翻唱
以另一种风格翻唱已有歌曲。源用 task_id + audio_index。
已提交字段无论当前模式是否生效,都须通过类型、范围和长度校验,不是静默忽略。
custom=true:prompt/title/tags/negative_tags/style_weight/weirdness/audio_weight/persona_id生效。custom=false:只认gpt_description(必填,缺了 400)。- 不传
custom时:有prompt→自定义;无prompt但有gpt_description→灵感;否则有tags/title→自定义。 - 给
tags即可按自定义风格翻唱(推荐)。新请求用weirdness。
用法 A(推荐) — 源歌曲 + 目标风格:
{
"model": "suno-cover",
"task_id": "task_xxx",
"audio_index": 1,
"version": "v6",
"tags": "jazz, slow"
}用法 B — 灵感模式,必须给 gpt_description:
{
"model": "suno-cover",
"task_id": "task_xxx",
"audio_index": 1,
"version": "v6",
"custom": false,
"gpt_description": "把这首歌翻唱成慢速爵士风格"
}version:v6/v6-wild/v6-mini,默认v6;与custom_model_id互斥。max_mode要求自定义模式,2 倍计费。duration_s仅自定义。- 提交接口:
POST /v1/music/generations,model: "suno-cover"。 - 任务查询:
GET /v1/music/generations/{task_id}。
Authorization
BearerAuth
AuthorizationBearer <token>
使用 MAPI Bearer Token 认证。格式:Authorization: Bearer sk-xxxxxx。
In: header
Request Body
application/json
model*string
固定填写 suno-cover。
task_id*string
产出源音轨的任务 ID,必填。
audio_index?integer
源任务 result.music[] 第几首,1-based,默认 1。
Default
1version?string
公共版本,省略默认 v6。用自定义模型时省略。
Default
"v6"Value in
"v6" | "v6-wild" | "v6-mini"custom_model_id?string
自定义模型 UUID。与 version、persona_id 互斥。
custom?boolean
true 自定义(prompt 作歌词);false 灵感(gpt_description)。不传则按内容推断。
prompt?string
歌词,custom=true 时生效。
gpt_description?string
灵感提示词。custom=false 时必填,缺了提交期 400。
title?string
标题。仅 custom=true。
tags?string
目标风格标签。仅 custom=true。给 tags 会自动按自定义处理。
negative_tags?string
排除风格。仅 custom=true。
style_weight?number
风格权重。仅 custom=true。
Range
0 <= value <= 1weirdness?number
创意度。新请求用本字段。
Range
0 <= value <= 1weirdness_constraint?number
weirdness 兼容旧名。
Range
0 <= value <= 1audio_weight?number
音频权重。仅 custom=true。
Range
0 <= value <= 1vocal_gender?string
人声性别,两种模式均生效。
Value in
"Male" | "Female"persona_id?string
Persona ID。仅 custom=true,与 custom_model_id 互斥。
duration_s?number
目标时长 10–360 秒,仅 custom=true。
Range
10 <= value <= 360variety?string
Value in
"off" | "normal" | "high" | "extra" | "max"max_mode?boolean
Max 模式。启用要求自定义模式,2 倍计费。
Default
falseaudio_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-cover", "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw", "audio_index": 1, "version": "v6", "tags": "piano, ambient" }'{
"code": 200,
"message": "success",
"data": [
{
"status": "submitted",
"task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
}
]
}{
"code": "invalid_request",
"message": "task_id is required",
"data": null
}最后更新于