场景6 - 混音重制（使用参考音频）

POST

/suno/generate

场景说明

使用参考音频进行混音重制：

提供参考音频的 reference_clip_id

可添加描述、歌词或风格指导

系统基于参考音频创作新版本

两种模式

模式A: 上传的音频

必须指定 mv (chirp-v4/chirp-auk/chirp-bluejay)

设置 task: "upload_reference"

模式B: 系统生成的音频

不需要 mv 和 task

直接使用 clip_id

适用场景

基于现有音乐创作变体

改变音乐风格但保持主题

创作混音版本

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

模式A - 混音上传的音频（带版本）模式B - 混音系统生成的音频（不带版本）

{
    "prompt": "描述或歌词",
    "tags": "",
    "negative_tags": "",
    "mv": "chirp-v4",
    "title": "标题",
    "reference_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
    "task": "upload_reference"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

模式A - 混音上传的音频（带版本）模式B - 混音系统生成的音频（不带版本）

curl --location --request POST 'api.gptuu.cc/suno/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "描述或歌词",
    "tags": "",
    "negative_tags": "",
    "mv": "chirp-v4",
    "title": "标题",
    "reference_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
    "task": "upload_reference"
}'

返回响应

🟢200成功

application/json

成功创建生成任务

Body

示例

{
    "clips": [
        {
            "id": "abcd-1234-5678-efgh",
            "status": "submitted"
        }
    ],
    "request_id": "req-123456"
}

🟠400请求有误

🟠401未认证

修改于 2025-11-14 13:20:51

场景5 - 续写/扩展已有音频

场景7 - 替换歌曲指定片段

场景6 - 混音重制（使用参考音频）

场景说明#

两种模式#

模式A: 上传的音频#

模式B: 系统生成的音频#

适用场景#