生成歌曲(灵感、自定义、续写)

任务查询与模式说明

任务创建后，需要通过 task id 轮询查询接口获取任务进度和结果。以下是三种不同的创作模式：

1. 灵感模式

最简单的创作模式，只需提供基本描述即可自动生成完整歌曲。

{
    "gpt_description_prompt": "创作描述",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5"
}

特点：

Suno自动生成歌词

自动生成标题

自动生成风格标签

最简化的参数要求

2. 自定义模式

允许用户对创作进行更多控制的模式。

{
    "prompt": "创作提示词",
    "title": "歌曲标题",
    "tags": "风格1,风格2,风格3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5"
}

特点：

可以指定具体的创作提示

自定义歌曲标题

自定义风格标签

更精确的创作控制

3. 续写模式

在自定义模式基础上进行歌曲续写。

普通续写

{
    "prompt": "创作提示词",
    "title": "歌曲标题",
    "tags": "风格1,风格2,风格3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5",
    "task_id": "原任务ID",
    "continue_at": 120.00,
    "continue_clip_id": "原歌曲ID"
}

上传音频续写

{
    "prompt": "创作提示词",
    "title": "歌曲标题",
    "tags": "风格1,风格2,风格3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5-upload",
    "task": "extend",
    "task_id": "原任务ID",
    "continue_at": 120.00,
    "continue_clip_id": "原歌曲ID"
}

特点：

支持在现有歌曲基础上继续创作

可以指定续写的起始时间点

支持上传自定义音频续写

保持风格的连贯性

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

string

必需

示例值:

application/json

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

prompt

string

必需

歌词内容，仅用于自定义模式

string

必需

模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0

title

string

必需

歌曲标题，仅用于自定义模式

tags

string

必需

风格标签，仅用于自定义模式，多个标签用半角逗号分隔

make_instrumental

boolean

必需

是否生成纯音乐版本，true 表示生成纯音乐

task_id

string

必需

任务ID，用于对已有任务进行操作（如续写）

continue_at

number

必需

续写起始时间点，浮点数，单位为秒

continue_clip_id

string

需要续写的歌曲ID

必需

gpt_description_prompt

string

必需

创作描述提示词，仅用于灵感模式

notify_hook

string

必需

任务完成后的回调通知地址

示例

{
  "prompt": "string",
  "mv": "string",
  "title": "string",
  "tags": "string",
  "make_instrumental": true,
  "task_id": "string",
  "continue_at": 0,
  "continue_clip_id": "string",
  "gpt_description_prompt": "string",
  "notify_hook": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

string

必需

data

string

必需

message

string

必需

示例

{
  "code": "success",
  "data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
  "message": ""
}

生成歌曲(灵感、自定义、续写)

任务查询与模式说明#

1. 灵感模式#

2. 自定义模式#

3. 续写模式#

普通续写#

上传音频续写#

请求参数

示例代码

返回响应

任务查询与模式说明

1. 灵感模式

2. 自定义模式

3. 续写模式

普通续写

上传音频续写