Cover Song

Cover an existing song in another style. Source: task_id + audio_index.

Submitted fields are validated even if the current mode does not use them. They are not silently ignored.

custom=true: prompt / title / tags / negative_tags / style_weight / weirdness / audio_weight / persona_id apply.
custom=false: only gpt_description (required).
If custom is omitted: prompt → custom; else gpt_description → inspiration; else tags/title → custom.
Sending tags is the recommended style-cover path. Use weirdness on new requests.

Usage A (recommended) — source song + target style:

{
  "model": "suno-cover",
  "task_id": "task_xxx",
  "audio_index": 1,
  "version": "v6",
  "tags": "jazz, slow"
}

Usage B — inspiration mode, gpt_description required:

{
  "model": "suno-cover",
  "task_id": "task_xxx",
  "audio_index": 1,
  "version": "v6",
  "custom": false,
  "gpt_description": "Re-arrange this song as a slow jazz version"
}

version: v6 / v6-wild / v6-mini, default v6. Mutually exclusive with custom_model_id.
max_mode requires custom mode and bills at 2×.

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

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"
  }'

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
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json