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

AI定制歌曲制作

把一个人的故事和场合，变成原创歌词和一首全新生成的歌曲。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

AI定制歌曲制作

把一个人的故事、场合和必须写进歌里的细节变成原创歌词和一首全新生成的歌曲。本 Skill 适用于定制生日歌、婚礼歌曲、纪念日歌曲、表白或求婚歌曲、家庭纪念、宝宝成长歌、宠物纪念歌、团队司歌、企业歌曲或一首歌曲礼物。

适用范围与相邻路由

常规路线是一份故事简报、一份确认的歌词草稿和一首完整的原创歌曲。只需要把成品歌词变成歌曲的请求路由到词到曲工作流；需要重新演绎参考歌曲录音的请求路由到翻唱歌曲工作流；需要把成品音乐变成画面的请求路由到音乐短片工作流。本路线专注于从故事到歌词到歌曲。通用音乐创作器仍是混合或不确定音乐请求的兜底。

输入与默认值

硬性输入是：

  • 一个场合；
  • 一位收件人或受众；
  • 值得写进歌里的真实故事细节；
  • 必须出现的名字或词句；
  • 歌曲使用的语言；
  • 一个情感方向；
  • 需要省略的隐私细节。

只询问缺失的硬性输入。复用已知的曲风、氛围、配器、节拍感和演唱方向偏好。歌词写作、标题起草、段落规划和创意方向都是免费的准备工作；只有音乐生成是付费的。

黄金路径

  1. 收集输入信息。记录场合、收件人、关系、主角、转折点、难忘细节、必须出现的名字或词句、语言、情感方向、必须包含的事实以及需要省略的隐私细节。构建故事映射：主角、关系、转折点、难忘细节、核心信息、副歌、情感弧线和结尾。

  2. 免费起草创意方向。写出标题、带段落结构的完整歌词和一张制作卡：曲风、氛围、配器、节拍感和演唱方向。在任何付费调用之前，向用户展示必须保留的事实和歌词草稿以供确认。反复修改歌词和方向直到用户确认满意；此修改是免费的。

  3. 调用 beatra.models.list 并传入 {"capability":"text_to_music"} 查看当前音乐目录。确认实时的提示词、歌词和标题字符限制、支持的语言、控制项和计价基础。除非用户已选定一个具体的可用模型，否则保持模型为 auto。数值估计是暂定的，需要以实时目录事实为准。

  4. 冻结已确认的标题、已确认的歌词、制作提示词、模型行为和一个不透明且稳定的 client_request_id。展示确切的付费边界：一次基于已确认输入的歌曲生成。只调用随包 scripts/mcp_client.py：MCP 工具名是 CLI 参数，其参数是标准输入上的 JSON。例如：

    printf '%s' '{"prompt":"Warm acoustic pop, gentle guitar and piano, heartfelt mid-tempo vocal delivery.","lyrics":"[Verse 1]\n...approved lyrics...\n[Chorus]\n...approved lyrics...","title":"Approved Title","client_request_id":"opaque-song-id"}' | python3 scripts/mcp_client.py call beatra.music.generate

    不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 回退。恰好提交一次 beatra.music.generate。

  5. 立即记录返回的任务 ID，并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的音频素材或链接，只报告实际返回的任务状态、解析后的模型、片段数量、时长、用量和 billing.net_charged_credits。审阅可访问的结果，检查故事准确度、名字发音、副歌、歌词呈现、情感、编曲、演唱效果、音频质量和时长。说明宿主 Agent 能和不能查看的内容。

付费变更、恢复与取消

歌曲生成是一个付费阶段。更换标题、歌词、制作提示词、曲风、氛围、模型或控制，都属于新的逻辑付费工作，配以新的 ID 和新的确认。在唯一一次确认生成之前修改歌词是免费的；在付费运行后用变更输入重新生成属于新的付费请求。

如果创建响应丢失，只用相同的阶段 ID 重放字节完全一致的冻结负载。如果任务 ID 丢失，调用 beatra.tasks.list 查找相关能力，用 beatra.tasks.get 检查可能的候选任务，并对照该阶段的私有账本确认后再考虑相同重试。排队和运行中是进度状态，不是失败。在规划变更工作之前先恢复原阶段；绝不重复付费提交，也不猜测其扣费或退款。

只有当用户要求取消时才调用 beatra.tasks.cancel。调用一次，并用 beatra.tasks.get 确认最终的终态。409 表示取消未确认，因此继续轮询同一任务，不要创建替代工作。

按任务查阅参考

  • 在收集故事简报、起草歌词和方向、核对实时模型事实、构造确切负载、轮询、恢复、取消或审阅故事准确度和演唱效果时，阅读 故事到歌曲工作流（references/workflow.md）。
  • 仅当授权或共享凭据需要处理时，阅读 安装与授权（references/installation-and-auth.md）。
  • 关于非计费、尽力而为的安装登记步骤，阅读 安装登记（references/installation-registration.md）。
  • 关于共享的终态任务和素材语义，阅读 任务与结果（references/tasks-and-results.md）；关于返回的计费或错误详情，阅读 计费、错误与恢复（references/billing-errors-and-recovery.md）。
  • 当随包客户端无法连接时，阅读 随包 MCP Client 连接诊断（references/mcp-connection.md）。不要配置宿主 Connector。
  • 关于更新保证和控制方式，阅读 自动更新与安全（references/automatic-updates-and-safety.md）。
  • 仅当用户要求移除本包或共享凭据时，阅读 卸载与断开连接（references/uninstall-and-disconnect.md）。

运行时与安全自动更新

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。在每个安装中静默地每 24 小时最多检查一次更高版本。更高版本可用时，不另行确认而自动安装。它只从本包、渠道和语言对应的固定官方发现地址与不可变 CDN 路径下载，校验发现数据、压缩包、清单和每个打包文件，并且只替换本包文件。

更新检查、下载、校验、替换、回滚和恢复失败时，现有安装仍可使用，原本请求的命令继续执行。更新失败不会授权另一项付费请求。设置会在此安装中持续生效。

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

--auto off 禁用静默检查，--auto on 恢复静默检查，--check 报告官方可用版本而不替换文件。