MAPI
音频(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}。
POST
/v1/music/generations

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。

Default1
version?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。

Range0 <= value <= 1
weirdness?number

创意度。新请求用本字段。

Range0 <= value <= 1
weirdness_constraint?number

weirdness 兼容旧名。

Range0 <= value <= 1
audio_weight?number

音频权重。仅 custom=true。

Range0 <= value <= 1
vocal_gender?string

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

Value in"Male" | "Female"
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 模式。启用要求自定义模式,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-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
}

最后更新于