official-format (文本转音频)

来源: https://docs.surgeai.one/docs/api/Suno/suno-music/official-format/text-to-audio

使用 Suno AI 强大的音乐生成模型，从文本描述生成高质量音乐。通过简单的文本提示词创作原创歌曲、背景音乐和音频作品。

Suno 的文本转音频接口。

参数

参数	类型	必填	默认值	描述
`prompt`	string	否	`Compose a tense pre-battle anthem`	自定义模式歌词或描述。为自定义模式提供详细的音乐文本描述，包含具体的歌词或主题。
`gpt_description_prompt`	string	否	`Ethereal female vocals blending with cinematic drums`	灵感模式提示词。使用 AI 从高层级描述生成音乐。此模式让 AI 根据您的创意描述进行解读和创作。非常适合探索新的音乐创意。
`make_instrumental`	boolean	否	`false`	设置为 `true` 生成无人声的纯音乐。设置为 `false` 在生成的音乐中包含人声。
`mv`	string	否	`chirp-v3-0`	生成所使用的模型版本。可用选项：- `"chirp-v3-5"` - 最新模型，质量更优 - `"chirp-v3-0"` - 默认稳定模型
`tags`	string	否	`cinematic,epic,ambient`	自定义模式的音乐风格标签，用逗号分隔（例如 "cinematic,epic,ambient"、"orchestral,dramatic,intense"）。这些标签有助于引导生成音乐的风格和氛围。
`title`	string	否	`Before the Charge`	自定义模式生成歌曲的标题。如未提供，将根据提示词或描述自动生成标题。
`continue_at`	number	否	`8`	延伸长度（秒）。指定从原始片段延伸多少秒（例如 8 表示延伸 8 秒）。用于延伸现有音乐。
`continue_clip_id`	string	否	`clip-123456`	要延伸的片段 ID（例如 "clip-123456"）。使用此参数继续或延伸之前生成的音乐片段。从之前的生成响应中获取片段 ID。
`task_id`	string	否	`task-001`	用于跟踪相关生成任务的后续任务 ID。使用此参数将多个生成请求关联在一起，以便更好地组织和管理。

生成模式

Suno 支持两种主要生成模式：

灵感模式（AI 驱动）

使用 gpt_description_prompt 让 AI 解读您的创意描述并生成音乐。

适用于： 创意探索，希望 AI 解读您的想法

{
  "gpt_description_prompt": "Ethereal female vocals blending with cinematic drums",
  "mv": "chirp-v3-5",
  "make_instrumental": false
}

自定义模式（直接控制）

使用 prompt、tags 和 title 对输出进行更直接的控制。

适用于： 明确需求，确切知道自己想要什么

{
  "prompt": "Compose a tense pre-battle anthem",
  "tags": "cinematic,epic,ambient",
  "title": "Before the Charge",
  "make_instrumental": true,
  "mv": "chirp-v3-5"
}

延伸/续写模式

使用 continue_clip_id 和 continue_at 延伸现有音乐片段。

适用于： 制作更长的曲目，创建变奏

{
  "continue_clip_id": "clip-123456",
  "continue_at": 8,
  "mv": "chirp-v3-5"
}

模型选择

模型	适用场景	特点
`chirp-v3-5`	最新功能，最高质量	音频质量提升，风格遵循度更好
`chirp-v3-0`	稳定、可靠的生成	默认选择，经过充分测试

参数推荐

使用场景	推荐设置
背景音乐	`make_instrumental: true`, tags: "ambient,background,subtle"
游戏音效	`make_instrumental: true`, mv: "chirp-v3-5"
播客片头	`make_instrumental: true`, tags: "intro,professional,upbeat"
视频内容	使用 `gpt_description_prompt` 获得创作自由度
自定义歌曲	设置自定义 `title`，指定详细的 `prompt` 和 `tags`
音乐延伸	使用 `continue_clip_id` 和 `continue_at`

official-format (文本转音频)

参数#

生成模式#

灵感模式（AI 驱动）#

自定义模式（直接控制）#

延伸/续写模式#

模型选择#