在现有 Suno Music 任务中选择版本，并描述希望创作的音乐。简单请求可以使用简洁提示词；自定义歌曲要求可以包含风格、标题与计划发展的歌词文字。选择纯音乐或带人声创作，使用对应工作流提供的偏好，再试听全部返回候选并选定曲目。当前表单列出 V4、V4.5、V4.5 All、V4.5 Plus 与 V5。
Vidgo 通过 PoYo 音乐工具接入提供 Suno Music 服务。模型、工具名称与商标归各自所有者所有。填写要求之前，先选择版本与创作模式。简单请求需要清楚描述情绪、曲风与乐器；自定义模式需要准备风格、标题与适用歌曲文字，再根据该方向检查返回候选。
使用 model: generate-music，并通过 mv 选择版本。简单模式的 custom_mode 为 false，文档中的提示词上限为 500 个字符。自定义模式需要准备 style 与 title，创作带人声作品时提供歌曲文字。文档给出的 V4 提示词/风格上限为 3,000/200 个字符，V4.5、V4.5 All、V4.5 Plus 与 V5 为 5,000/1,000 个字符，title 上限为 80 个字符。请根据目标是纯音乐还是带人声作品设置 instrumental。
| 模型 / 任务 | 输入与工作流 |
|---|---|
| Suno Music | AI 音乐生成工具，支持自定义风格、人声，并对音乐特征与质量提供完整创作控制。 |
使用该操作要求的输入，结合来源检查返回结果。下方说明介绍如何准备请求、检查输出，以及保存下一步创作或开发需要的信息。
{
"model": "generate-music",
"input": {
"prompt": "A quiet coastal harbor at dusk, paper lanterns swaying above the water; warm acoustic instruments and a gentle unhurried rhythm.",
"style": "Gentle acoustic folk instrumental, nylon guitar, soft upright bass, brushed percussion, reflective evening atmosphere",
"title": "Harbor Paper Lanterns",
"mv": "V5",
"custom_mode": true,
"instrumental": true
}
}通过简单要求准备曲风、情绪、重点乐器与预期聆听用途，再结合返回音乐检查该方向作为完整曲目的表现。
{
"model": "generate-music",
"input": {
"prompt": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery road can start from here\nOne small step and skies are clear",
"style": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal, hopeful tone",
"title": "Windows After Rain",
"mv": "V5",
"custom_mode": true,
"instrumental": false
}
}选择自定义模式，将歌曲文字与音乐风格、标题一并组织，再结合目标文字与请求氛围检查完成的带人声结果。
根据目标曲目类型设置 instrumental。在带人声自定义模式中，可以使用适用 vocal_gender 偏好，并试听结果，再决定哪个候选适合项目。
{
"model": "generate-music",
"input": {
"prompt": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery road can start from here\nOne small step and skies are clear",
"style": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal, hopeful tone",
"title": "Windows After Rain",
"mv": "V5",
"custom_mode": true,
"instrumental": false
}
}请求需要时，使用文档中的风格、创意偏离与音频特征权重。在支持的自定义模式中应用已有 Persona，再结合完整提示词与风格方向检查下一项结果。
读取完成音乐结果中的全部 files，试听各个候选并检查实际时长，再保存选定音频地址、task_id 与 audio_id，用于后续延长、处理或视觉展示。
两次原创 V5 自定义请求分别创作原声纯音乐与带人声民谣，每次实际返回两个候选。可以结合实际提示词、风格与来源标识聆听四条录音，并根据各自创作要求比较同一次请求中的候选。
黄昏宁静的海滨港湾，纸灯笼在水面上方摇曳；温暖的原声乐器与轻柔、从容的节奏。
{
"model": "generate-music",
"input": {
"prompt": "A quiet coastal harbor at dusk, paper lanterns swaying above the water; warm acoustic instruments and a gentle unhurried rhythm.",
"style": "Gentle acoustic folk instrumental, nylon guitar, soft upright bass, brushed percussion, reflective evening atmosphere",
"title": "Harbor Paper Lanterns",
"mv": "V5",
"custom_mode": true,
"instrumental": true
}
}
原始英文歌词： [Verse] Rain has left the window bright Morning folds away the night On the table, bread and tea There is room for you and me [Chorus] Open up the day again Let the sunlight wander in Every road can start from here One small step and skies are clear 中文释义： [主歌] 雨水让窗户变得明亮 清晨收起了夜色 桌上摆着面包与茶 这里容得下你和我 [副歌] 再次迎接新的一天 让阳光自在走进来 每条道路都能从这里开始 迈出一小步，天空便晴朗
{
"model": "generate-music",
"input": {
"prompt": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery road can start from here\nOne small step and skies are clear",
"style": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal, hopeful tone",
"title": "Windows After Rain",
"mv": "V5",
"custom_mode": true,
"instrumental": false
}
}
准备音乐要求或自己选定的歌词，以及请求需要使用的曲风、情绪与乐器。方向中需要 Persona 时，在支持的自定义模式中应用已有 persona_id。从上传音频来源开始操作时，请打开对应上传翻唱或上传延长任务，并准备其要求的输入。
在自定义模式中准备自己的歌词文字、风格与标题，再选择带人声创作，检查返回候选的目标文字、音乐特征与演唱表达。
描述情绪、节奏与重点乐器，再选择纯音乐生成，并结合目标画面或背景作用试听候选。
准备完整要求，并为各次请求明确选择版本。检查适合项目的工作流时，保留设置与返回音乐。
描述项目情绪与音乐作用，再生成候选。结合计划演示检查完整曲目，再选择需要使用的结果。
聆听初始结果，根据观察细节修订要求、风格或支持偏好，再结合相同创作目标检查下一组候选。
选定需要继续发展的已完成候选，保存标识，并准备下一操作所需字段。将原音频作为延长、分离或视觉展示的来源参考。
下表读取一次音乐生成请求的当前费率。请读取完成结果中的 files，查看实际返回候选与各自时长。后续延长、音频处理、封面图片或视频请求分别使用自身任务费率。生成之前查看当前请求价格，并按新增请求安排后续创作迭代预算。
| 工具 | 厂商 | 操作 | 输入 | 结果类型 | 当前费率 |
|---|---|---|---|---|---|
| Suno Music | PoYo | 音乐生成 | 音乐要求或自定义歌词/风格输入与所选 mv | 生成音乐候选 | $0.1 / 次请求 |
准备来源输入， 再检查完成结果与下一步用途。
打开 Suno Music，选择版本与简单或自定义模式，准备对应提示词、风格与标题，选择纯音乐或带人声创作，再查看当前请求价格。生成后完整试听返回候选，并保存需要继续发展的曲目。
通过现有任务、当前请求费率与 API 文档，将来源准备、结果检查与下一项音乐工作流衔接。
准备音乐要求或自己选定的歌词，以及请求需要使用的曲风、情绪与乐器。方向中需要 Persona 时，在支持的自定义模式中应用已有 persona_id。从上传音频来源开始操作时，请打开对应上传翻唱或上传延长任务，并准备其要求的输入。
试听各个返回候选，并结合要求检查音乐方向、人声处理或纯音乐编配。在带人声自定义模式中，结合检查目标歌词与演唱表达。在带人声自定义模式中，可以通过 vocal_gender 的 m 或 f 表达人声偏好。style_weight 设置风格遵循程度，weirdness_constraint 设置创意偏离程度，audio_weight 设置文档中的音频特征平衡；三项范围均为 0–1，最多两位小数。根据观察结果完善下一次请求，并为后续工具保留各条选定曲目的 task_id 与 audio_id。
下表读取一次音乐生成请求的当前费率。请读取完成结果中的 files，查看实际返回候选与各自时长。后续延长、音频处理、封面图片或视频请求分别使用自身任务费率。生成之前查看当前请求价格，并按新增请求安排后续创作迭代预算。
提交 model: generate-music，并在 input 中填写 prompt、mv、custom_mode、instrumental 及所选模式要求的字段。保存 task_id，再查询音乐详情，读取全部返回候选及其 audio_id、音频地址和可用封面或时长信息。
使用 Vidgo API 凭据进行身份验证，提交准确模型标识与所需输入字段。保存返回处理 task_id，使应用能够跟踪操作并取得结果。配置完成通知时，请按照任务文档准备。
使用返回处理 ID 查询 /api/generate/detail/music?task_id=YOUR_PROCESSING_TASK_ID，或处理已配置通知。任务完成后，检查 files 中对应操作的结果，并保留来源关联。试听各个返回候选，并结合要求检查音乐方向、人声处理或纯音乐编配。在带人声自定义模式中，结合检查目标歌词与演唱表达。在带人声自定义模式中，可以通过 vocal_gender 的 m 或 f 表达人声偏好。style_weight 设置风格遵循程度，weirdness_constraint 设置创意偏离程度，audio_weight 设置文档中的音频特征平衡；三项范围均为 0–1，最多两位小数。根据观察结果完善下一次请求，并为后续工具保留各条选定曲目的 task_id 与 audio_id。
在现有 Suno Music 任务中选择版本，并描述希望创作的音乐。简单请求可以使用简洁提示词；自定义歌曲要求可以包含风格、标题与计划发展的歌词文字。选择纯音乐或带人声创作，使用对应工作流提供的偏好，再试听全部返回候选并选定曲目。当前表单列出 V4、V4.5、V4.5 All、V4.5 Plus 与 V5。
阅读音乐工具介绍、API 指南与平台比较，了解所需来源、返回结果、请求费用与后续工作流。
