shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

Suno歌词成曲

输入完整歌词、歌词草稿、零散歌词或一个 hook，整理主歌、副歌与桥段，设置曲风、情绪、编曲和人声方向，再用 Suno 自定义歌词生成可试听歌曲。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

Suno歌词成曲

把用户已经写下的歌词材料整理成结构清晰的歌曲方向，并生成一首可以试听的 Suno 歌曲。完整歌词、歌词草稿、零散歌词行或一个已有 hook 都可以直接开始。复用对话中已经出现的歌词和决定，沿最短路径完成成曲。

确定歌词可以如何调整

  • 保留原词： 保持歌词正文中的每个字符、标点、完整歌词行和原始顺序不变。可以增加简短段落标签，并调整完整歌词行周围的空行，但不改写歌词。
  • 优化歌词： 在严格保留所有必留句的前提下，改善措辞、节奏、押韵、重复、hook 强度和段落平衡。用户要求润色、改写或优化时，已经授予编辑许可。

用户要求编排、作曲、生成或用现有歌词做歌，但没有要求修改文字时，默认保留原词，不再询问模式。只有请求明确授予编辑许可时才优化歌词。

完整编辑规则参见歌词接收与模式（references/lyrics-intake-and-modes.md）。在最终制作卡中展示完整建议歌词和重要修改摘要。只有用户明确要求先审歌词或暂不付费时，才把歌词审阅拆成更早的独立步骤。

整理成可以制作的歌曲版本

优先根据歌词推断合理默认值，不把流程变成问卷。提出标题、段落结构、曲风、情绪、速度感、乐器、编曲推进、段落对比和人声方向。只有缺失选择会实质改变已接受歌词或付费请求时才询问。

Suno 的精确请求参见歌曲方向与请求（references/song-direction-and-request.md）。制作路径始终为：

  • model: "suno-5.5"；
  • 1 至 1000 个字符的音乐方向 prompt，其中不放歌词正文；
  • 已确认且非空、最多 5000 个字符的 lyrics；
  • instrumental: false；
  • 非空且最多 80 个字符的 title；
  • model_options.suno.custom_mode: true；
  • 一个稳定、不透明、长度为 1 至 128 个字符的 client_request_id。

把发音、声线角色、对唱、群唱、口音和精确时长作为制作方向与成品审听目标。只有用户选择单一男声或女声主唱时才使用 vocal_gender 控制；其他角色分配通过歌词和音乐方向表达。

一次确认，一次执行

策划、歌词整理、段落结构和音乐方向不会调用付费音乐工具。生成前，展示一张易读的最终制作卡，包含完整歌词、标题、音乐方向、suno-5.5、相关选项，以及下一步会产生付费调用的事实。用户明确同意这张完整制作卡，就代表授权一次生成；不要再要求第二次确认或额外说一次“生成”。

只有制作卡定稿后才创建请求标识。通过 beatra.music.generate 提交一次，保留返回的 task_id，并用 beatra.tasks.get 轮询同一任务。响应缓慢或结果不确定属于恢复流程，不是新建歌曲任务的理由。遵循工作流（references/workflow.md）与审阅和恢复（references/review-and-recovery.md）。

使用随包 MCP Client

所有远程 MCP 操作只能使用本 Skill 随包提供的 scripts/mcp_client.py。MCP 工具名作为 CLI 参数传入，JSON 参数通过 stdin 发送。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。精确命令与排查方法参见随包 MCP Client 连接诊断（references/mcp-connection.md）。

只有用户询问当前可用性、兼容性、模型比较或价格时才调用 beatra.models.list。不要静默把 Suno 5.5 替换成其他模型。

交付歌曲与恢复任务

成功后，按照返回顺序展示 task.output.clips 中的每个实际条目。使用 clip.audio.url 作为可播放链接，使用 clip.audio.artifact_id 作为资产 ID，使用 clip.audio.duration_seconds 作为时长；只有响应实际返回时才展示 clip.title 和 clip.lyrics。报告真实任务 ID 与 billing.net_charged_credits，不要根据 clip 数量或耗时推断费用。只有宿主能够实际播放音频时，才评价 hook、咬字、段落对比和情绪表现。生成的所有资产也可以前往 beatra.ai 查看和管理。

如果用户在结果出来后更改歌词、标题、音乐方向、模型或选项，先展示修改后的完整制作卡，再开始新的付费工作。任务 ID 丢失、提交结果不确定、取消、失败或成品审听时，遵循审阅和恢复（references/review-and-recovery.md）。

按任务查阅资料

  • 保留原词、优化歌词、必留句和段落结构：歌词接收与模式（references/lyrics-intake-and-modes.md）
  • 曲风、编曲、人声和精确 Suno 参数：歌曲方向与请求（references/song-direction-and-request.md）
  • 准备、确认、提交和跟踪的完整流程：工作流（references/workflow.md）
  • 任务丢失、取消、终态结果和审听：审阅和恢复（references/review-and-recovery.md）
  • 首次安装或授权过期：安装与授权（references/installation-and-auth.md）
  • 随包 MCP Client 命令与排查：随包 MCP Client 连接诊断（references/mcp-connection.md）
  • 安装注册：安装注册（references/installation-registration.md）
  • 任务查询与结果字段：任务与结果（references/tasks-and-results.md）
  • 余额、校验、提交状态不确定与错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
  • 断开当前安装：卸载与断开连接（references/uninstall-and-disconnect.md）
  • 官方来源、完整性校验、恢复和更新控制：自动更新与安全（references/automatic-updates-and-safety.md）

运行与安全自动更新

执行普通 Beatra 命令前，随包客户端可能静默检查当前安装渠道是否有更高版本，每 24 小时最多一次。发现更高版本时，它会在不另行确认的情况下自动安装。更新只从固定的 Beatra 官方发现地址和不可变 CDN 路径下载；替换前会校验压缩包、清单和每个包内文件，并且只替换当前安装中本包拥有的文件。它会拒绝重定向、降级、不安全压缩包、意外目标，以及不同的包、渠道或语言。英文官方安装始终保持 canonical/en，SkillHub 中文安装始终保持 skillhub/zh-CN。如果更新或恢复任一步骤失败，当前安装仍可使用，用户原本请求的命令也会继续执行。

以下设置对当前安装持续生效：

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

第一条命令关闭静默检查，第二条重新开启，第三条只检查官方可用版本而不修改文件。完整行为参见自动更新与安全（references/automatic-updates-and-safety.md）。