Suno 歌词成曲

技能文档

---
name: suno-lyrics-to-song
title: Suno 歌词成曲
category: 内容创作
description: 输入完整歌词、歌词草稿、零散歌词行或一个 hook，把歌词变成一首可试听的歌曲。支持保留模式（逐字保留原词）与优化模式（改善措辞、节奏、押韵、hook 与演唱流畅度），自动整理主歌、副歌、桥段结构，确定曲风、情绪、编曲与人声方向，通过 Beatra MCP 以 Suno 自定义歌词模式生成歌曲。当用户要求歌词成曲、歌词谱曲、用歌词生成音乐、AI 作曲时触发。
---

# Suno 歌词成曲

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

## 技能工作流

### 步骤1：确定歌词调整模式

用户只要整理歌词、没有要求生成时停在歌词。生成走 `beatra.music.generate`；不要登录 Suno 账号。

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

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

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

### 步骤2：整理成可以制作的歌曲版本

硬输入是完整或零散歌词。先标主歌、副歌和桥再付费。自定义歌词必须带段落标签。

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

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` 控制；其他角色分配通过歌词和音乐方向表达。

### 步骤3：一次确认，一次执行

先整理骨架与段落标签，取得用户对歌词的确认，再出示一张成曲确认卡。不要整首自动重做。

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

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

### 步骤4：使用随包 MCP Client

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

只有用户询问当前可用性、兼容性、模型比较或价格时才调用 `beatra.models.list`。不要静默把 Suno 5.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](https://beatra.ai) 查看和管理。

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

## 积分与计费

工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

用户问还剩多少积分时，调用 `beatra.wallet.get`。问扣了什么时，调用 `beatra.wallet.ledger`。两者只读。不要发明账户余额或充值工具。不要把 `wallet.get` 当成每次付费提交前的必做步骤。

## 按任务查阅资料

- 保留原词、优化歌词、必留句和段落结构：[歌词接收与模式](references/lyrics-intake-and-modes.md)
- 曲风、编曲、人声和精确 Suno 参数：[歌曲方向与请求](references/song-direction-and-request.md)
- 准备、确认、提交和跟踪的完整流程：[工作流](references/workflow.md)
- 任务丢失、取消、终态结果和审听：[审阅和恢复](references/review-and-recovery.md)
- 随包 MCP Client 命令与排查：[MCP Client 连接诊断](references/mcp-connection.md)
- 任务查询与结果字段：[任务与结果](references/tasks-and-results.md)
- 余额、校验、提交状态不确定与错误：[计费、错误与恢复](references/billing-errors-and-recovery.md)

使用说明

# Suno 歌词成曲

把已有歌词变成一首可试听的歌曲：支持保留原词与优化措辞两种模式，自动整理段落结构、确定曲风与编曲方向，经一次确认后通过 Beatra MCP 生成 Suno 歌曲。

## 使用

```text
这是我写的歌词，帮我谱成一首城市流行风格的歌，保留原词。
```

```text
优化一下这段副歌的押韵和节奏，然后生成歌曲，标题《夜航》。
```

## 工作原理

按「确认歌词调整模式 → 整理可制作版本 → 一次确认一次执行 → 提交生成并轮询 → 交付与恢复」推进。歌词逐字保留或经许可优化后必须带段落标签；生成使用 suno-5.5 自定义歌词模式，提交前展示包含完整歌词与参数的制作卡，批准即授权一次付费生成。任务通过 `scripts/mcp_client.py` 调用（凭证存放于 ~/.beatra/credentials.json），交付时报告真实任务 ID 与实际扣费。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。