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

任务查询与模式说明

任务创建后，需要通过 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"
}

特点：

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

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

支持上传自定义音频续写

保持风格的连贯性

请求参数

Authorization

Header 参数

Body 参数application/json

示例


{
    "prompt": "[Verse]\nLights are flashing\nIt's so bright (ooh-yeah!)\nFeel the rhythm\nGroove all night (ooh-yeah!)\nMove your body\nFeel alive\nDance it out\nLet’s all arrive\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Verse 2]\nBass is pumping\nHands are high (hands are high!)\nMusic lifts us to the sky (to the sky!)\nKeep it going\nDon’t look back\nIn the night\nWe’re on track\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Bridge]\nFeel the magic\nIn your soul (soul!)\nLose control\nLet it roll (roll!)\nWhere the night will take us\nWho knows?\nBut we’ll dance till the moon blows\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title": "City Lights"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

任务查询与模式说明#

1. 灵感模式#

2. 自定义模式#

3. 续写模式#

普通续写#

上传音频续写#

请求参数

请求示例代码

返回响应

任务查询与模式说明

1. 灵感模式

2. 自定义模式

3. 续写模式

普通续写

上传音频续写