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

AI翻唱歌曲制作

上传一首参考歌曲,把它重新演绎成全新翻唱——换风格、改编曲、换唱法,做出摇滚、民谣、爵士、国风或抒情版本。

personAuthor: beatra01hubOpenAPI

AI翻唱歌曲制作

把一首可访问的歌曲录音重新演绎成一首翻唱或改编歌曲。本 Skill 适用于用户已有一首参考歌曲,并要求翻唱、经典重绎、换风格、不插电版本、摇滚版本、国风编曲、全新演唱或表演方向,或对已有曲目进行重新编曲。

适用范围与相邻路由

常规路线是一首参考歌曲录音、一个重新演绎方向和一首新翻唱。以故事为起点且没有成品歌词或歌曲的请求路由到定制歌曲工作流;以成品歌词为起点的请求路由到词到曲工作流;以成品音乐为起点且需要画面的请求路由到音乐短片工作流。本路线专注于对一首参考录音进行整曲重新演绎。

输入与默认值

硬性输入是:

  • 一首宿主 Agent 可以查看的可访问参考歌曲录音(FLAC、MP3 或 WAV);
  • 所需的重新演绎方向——换风格、新编曲、新演唱风格或重新设定的氛围。

只询问缺失的硬性输入。复用已知的语言、氛围、配器、演唱风格和必须保留的细节。Beatra 没有歌词转写步骤:任何必须准确保留的歌词文本都必须由用户提供并在生成前确认。

对于宿主 Agent 可访问的本地参考文件,仅在查看之后使用随包上传助手:

python3 scripts/mcp_client.py upload ./reference-song.mp3 --mime-type audio/mpeg

上传只是传输,不是创意审阅。保留返回的素材引用,绝不向远程工具传递本地路径。

在任何付费调用之前准备一张简短的制作卡:歌曲标识、语言、氛围、目标风格、能量、配器、演唱风格、必须保留的歌词细节以及希望的重新演绎程度。默认输出一次翻唱生成和 model: "auto"。构建一条正向重新演绎指令,说明本次运行应当交付的那一个主要创作变化。

黄金路径

  1. 查看参考录音。记录其实际 MIME 类型、格式、时长和字节大小。识别歌曲标识、语言、氛围、风格、能量、配器、演唱风格、源声音意图和所要求的重新演绎方向。

  2. 构建制作卡:歌曲标识、语言、氛围、目标风格、能量、配器、演唱风格、必须保留的歌词细节和希望的重新演绎程度。然后写出一条正向重新演绎指令,说明那一个主要创作变化。

  3. 调用 beatra.models.list 并传入 {"capability":"reference_audio_to_music"},确认某张当前模型卡接受参考录音的实际 MIME 类型、格式、时长和字节大小。确认实时的时长和字节大小限制、所接受的参考音频路线以及计价基础。除非用户已选定一个具体的可用模型或所要求的路线需要明确的模型族,否则保持模型为 auto

  4. 明确路由重新演绎方向,向用户展示确切的路线、参考录音、制作提示词、提供时的歌词和标题、模型行为以及付费边界:

    • 不提供歌词的人声重新演绎:使用支持的参考音频卡和简洁的制作提示词;不要声称精确保留歌词;
    • 提供用户歌词的人声重新演绎:当前 auto 参考路线要求 10–300 字符的提示词;提供的歌词必须包含 10–1000 字符并要求非空标题;
    • 纯器乐重新演绎:不要使用 model: "auto";选择一个明确支持此组合的当前模型族;
    • 模型族控制:只发送所选当前族发布的控制项,绝不混用族特定选项。
  5. 用一个不透明且稳定的 client_request_id 冻结路线、参考录音、制作提示词、提供时的歌词和标题、模型以及付费边界;然后恰好调用一次 beatra.music.generate。只调用随包 scripts/mcp_client.py:MCP 工具名是 CLI 参数,其参数是标准输入上的 JSON。例如:

    printf '%s' '{"reference_audio":{"type":"artifact","artifact_id":"art_reference"},"prompt":"Reimagine this ballad as an upbeat acoustic folk cover with warm vocals and a lighter, brighter arrangement.","client_request_id":"opaque-cover-id"}' | python3 scripts/mcp_client.py call beatra.music.generate
    

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

  6. 立即记录返回的任务 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 报告官方可用版本而不替换文件。