描述氛围与配器
演示要求结合梦幻 lo-fi hip hop、柔和钢琴和弦、黑胶噼啪声与温柔鼓点。可以将音乐情绪与重点乐器结合起来说明，使请求具有明确聆听用途，并对照要求中的元素试听第一个候选。
Suno v5 music generation API
通过文字描述情绪、曲风、乐器与预期用途来生成音乐。在现有 Suno 任务中选择 V5，再选择简单提示词工作流，或使用带有风格与标题的自定义模式。Instrumental 设置用于纯音乐请求；人声偏好、风格权重与可选 Persona 可以参与自定义歌曲创作。完成的一次生成可以返回多个候选曲目，供你试听、比较，并通过音乐详情 API 获取。
Suno v5 由 Suno 开发，Vidgo 提供模型调用服务。模型名称与商标归各自所有者所有。探索 Suno v5 模型
打开 Suno v5，将版本设为 V5，并根据准备的素材选择工作流。简单请求可以从简洁的音乐描述开始；使用自定义模式时，可以准备完整提示词、风格与标题。模型
Suno v5 简单模式与自定义音乐输入
进行简单请求时，将 custom_mode 设为 false，并填写不超过 500 个字符的提示词。V5 自定义模式的文档上限为：prompt 5,000 个字符、style 1,000 个字符、title 80 个字符。创作纯音乐时准备风格与标题，创作带人声的作品时再填写完整提示词。设置 instrumental，选择适用的人声偏好，并通过可选权重或 Persona 说明本次生成方向。
| 模型 / 任务 | 输入与工作流 |
|---|---|
| Suno v5 | Suno 最先进的 AI 音乐模型，提供录音室级音频、真实人声、快十倍的生成速度，以及最长八分钟曲目支持。 |
Suno v5：音乐风格编排与候选曲目选择
现有 Suno v5 任务演示将深夜 lo-fi 创作要求与两条 Midnight Margins 候选曲目配对。音频、封面、标签与时长均来自同一份已保存演示。可以试听两个候选结果，并结合结果信息理解创作方向、整理后续工作。
比较同一创作要求的候选曲目
第二个候选属于同一份保存演示。可以完整聆听其结构，并与第一个候选比较钢琴乐句、节奏感与音色层次，再选择更符合目标画面或背景用途的曲目。
结合返回曲名与封面整理作品
保存结果为各个候选提供 Midnight Margins 曲名与封面。检查音乐素材或准备项目交接时，可以将选定音频、曲名与封面一并整理。这里展示的封面直接来自现有音频结果。
说唱；梦幻 lo-fi hip hop 纯音乐，以柔和、轻微失谐的钢琴和弦与轻柔黑胶底噪为中心。慵懒的摇摆鼓点，搭配刷奏军鼓与圆润、带木质感的底鼓；通过轻微侧链处理让和弦留出呼吸空间。贝斯温暖，在混音下方轻轻回响，远处的磁带延迟与微弱反向音色在背景中逐渐展开。整体克制，带有在左右声场中出现又飘散的细小音色点缀，适合在深夜学习时安静循环播放。温柔、轻柔、鼓点、lo-fi、hip hop、柔和。
将音乐细节组织为清楚的风格方向
现有结果标签描述轻微失谐钢琴、摇摆鼓点、刷奏军鼓、温暖贝斯与磁带延迟音色，可以结合这些输出标签理解演示。编写自己的自定义模式请求时，准备风格描述，使用 0 至 1 的 style_weight，并通过 negative_tags 说明希望弱化的风格元素。
[
{
"audio_id": "9c980227-0062-4b36-9d83-3e337178cee8",
"title": "Midnight Margins",
"duration": 109.16
},
{
"audio_id": "c4b1c4d4-557f-49d8-9afe-536b61b560ee",
"title": "Midnight Margins",
"duration": 123.04
}
]保存各个候选标识以衔接后续工作
保存结果为各个候选提供独立 audio_id 与时长。可以使用生成任务 ID 获取音乐详情，再为选定候选保存 audio_id，以衔接文档中的后续工具。返回时长说明实际曲目长度，也有助于判断它是否适合项目。
Suno v5 同一创作要求的配乐候选案例
下方两个候选曲目属于现有任务演示，共用同一段展示创作要求：柔和钢琴、轻微黑胶噼啪声与温柔鼓点，用于深夜学习。保存结果将两条曲目标记为纯音乐，时长分别为 109.16 秒与 123.04 秒。可以完整试听，对照旋律展开、节奏、音色层次以及作为目标背景音乐的适用程度。
音乐要求
一首梦幻的 lo-fi hip hop 曲目，包含柔和的钢琴和弦、轻微的黑胶噼啪声与温柔鼓点，非常适合深夜学习。
音乐要求
一首梦幻的 lo-fi hip hop 曲目，包含柔和的钢琴和弦、轻微的黑胶噼啪声与温柔鼓点，非常适合深夜学习。
Suno v5 的创作应用场景
生成之前，先写明情绪、节奏、配器与音乐在作品中承担的作用。选择纯音乐或带人声的创作方式，试听各个返回候选，并选取符合项目需求的曲目。整理素材或继续使用已有音乐工具时，可以使用选定音频及其标识。
学习与专注背景音乐
准备平静情绪、温和节奏，以及钢琴或轻打击乐等配器，再选择纯音乐生成。试听返回候选，为学习时段或专注主题视频草稿选择合适背景。
场景与短片音乐概念
描述场景的情绪方向、节奏与目标配器。生成候选音乐，并结合计划中的画面序列检查，用于确定配乐方向或提供剪辑参考。
自定义歌曲构思
在自定义模式中准备完整提示词、风格与标题，并选择带人声的创作方式。需要时添加适用的人声性别偏好，再试听返回曲目的音乐处理与目标歌曲方向。
氛围纯音乐草稿
描述情绪、重点乐器与能量感，准备风格与标题，再开启 instrumental。比较返回候选，为氛围场景、展览演示或沉思主题内容选择音乐草稿。
探索多个音乐方向
准备清楚的创作要求并试听全部返回候选。可以在后续请求中完善风格、创意偏离偏好或提示词，再将新结果与此前选定方向进行比较。
为后续工具准备曲目
选定已经完成的候选，保存 task_id 与 audio_id，再打开对应的延长、片段替换或音频处理文档。根据要求使用标识与来源信息，为下一步操作准备输入。
Suno v5 模型规格与 API 价格
价格区读取一次生成请求的当前费率。完成的请求可以包含多个候选曲目，请读取返回的 files，查看实际候选与各自时长。当前任务按生成请求计费，展示起价对应一次请求。提交之前查看任务当前请求价格，需要增加创作迭代时，按新增请求次数安排预算。
| 模型 | 厂商 | 任务类型 | 输入素材 | 音频输出 | 起价 |
|---|---|---|---|---|---|
| Suno v5 | Suno | 音乐生成 | 音乐要求；自定义风格、标题与可选 Persona | 候选音频曲目 | $0.1 / 次生成 |
如何在 Vidgo 使用 Suno v5
先在线测试完整音乐要求， 再将选定工作流接入应用。
在线体验
生成并完整试听候选曲目
打开 Suno v5，选择 V5，并按所选模式准备提示词、自定义风格与标题。选择纯音乐或带人声创作，查看请求价格并生成。试听全部返回候选，结合实际时长选定曲目。
为何在 Vidgo 使用 Suno v5
通过现有音乐任务、请求价格、任务文档与生成记录，将音乐探索衔接到 API 开发。
音乐测试与请求规划
根据音乐要求选择模式
进行简单请求时，将 custom_mode 设为 false，并填写不超过 500 个字符的提示词。V5 自定义模式的文档上限为：prompt 5,000 个字符、style 1,000 个字符、title 80 个字符。创作纯音乐时准备风格与标题，创作带人声的作品时再填写完整提示词。设置 instrumental，选择适用的人声偏好，并通过可选权重或 Persona 说明本次生成方向。
试听后选择候选曲目
打开 Suno v5，选择 V5，并按所选模式准备提示词、自定义风格与标题。选择纯音乐或带人声创作，查看请求价格并生成。试听全部返回候选，结合实际时长选定曲目。
按生成请求规划费用
价格区读取一次生成请求的当前费率。完成的请求可以包含多个候选曲目，请读取返回的 files，查看实际候选与各自时长。当前任务按生成请求计费，展示起价对应一次请求。提交之前查看任务当前请求价格，需要增加创作迭代时，按新增请求次数安排预算。
API 接入与音乐结果管理
准备文档中的音乐字段
打开音乐生成文档，查看身份验证方式、model: generate-music、mv: V5、各模式输入与可选偏好。按所选工作流准备提示词、风格与标题，再查看查询音乐详情的响应字段，了解如何读取候选文件。
保存任务与候选标识
使用返回的 task_id 查询 /api/generate/detail/music?task_id=YOUR_TASK_ID，或处理已配置的完成回调。任务完成后，读取 files，保存选定音频地址、audio_id，以及可用封面与时长信息。准备下一次请求时，可以从账户生成记录回看在线结果。
回看在线生成记录
打开账户生成记录，回看在线创建的音乐请求与结果。将选定曲目与此前创作方向比较，再根据对应任务文档准备下一次生成或后续操作。
Suno v5 API 常见问题
Suno v5 是现有 Suno 任务中可使用的音乐生成版本。API 使用 model: generate-music，并将 input.mv 设为 V5。可以选择简单描述或自定义模式、纯音乐或带人声创作，再通过音乐详情获取完成的候选曲目。
探索更多模型系列
推荐阅读
阅读音乐模型介绍、API 指南与平台比较，了解创作输入、请求费用、候选曲目与接入方式。
