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

短视频配乐工作室

描述一下画面，就能拿到一条专为它写的原创纯音乐，生成的音乐归你所有、可直接商用。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

短视频配乐工作室

把一段画面描述变成为它而写的原创纯音乐：读懂场景，写出与这条片子情绪相符的情绪曲线，交付可以先听再发的成品。

适用范围与路线选择

当视频、直播、播客、门店或品牌场景需要背景音乐、且不要人声演唱时，使用本 Skill。适合短视频投稿、vlog、商品与开箱视频、教程与课程画面、直播间与门店循环、播客片头片尾，以及相册与活动回顾。

带演唱歌词的歌曲请使用 beatra-ai-music-creator。已经写好的歌词要谱曲请使用 suno-lyrics-to-song，送人或生日、纪念日等特殊场合的定制歌请使用 personalized-song-maker，已有歌曲的翻唱或改编请使用 ai-song-cover-studio。围绕成品曲目做的音乐视频请使用 ai-music-video-clip-maker，口播旁白请使用 short-form-voiceover-audio。

输入与默认值

唯一的硬性输入是这段音乐用在哪儿：它要托住的场景、产品或情绪。复用对话中已有的平台、画面描述、品牌调性、目标时长和参考曲目。

只有当答案会改变付费结果时才询问：用户只说「做个音乐」而没有交代场景时，问用途。

避免多余提问的默认值：

  • instrumental: true 且不带歌词，因为这条路线做的是背景音乐。
  • 由安静走向抬升、干净收尾的情绪走向，适合需要利落结束的剪辑。
  • 常规生成使用 model: "suno-5.5"。绝不省略模型，也绝不悄悄使用 auto；只有用户点名时才换用其他模型。
  • 给人声留出位置，因为多数短视频 BGM 都要垫在口播下面。

标准流程

写卡片和做方案都免费，只有生成调用是付费的。

  1. 从画面出发写一份简短的音乐卡片：用途与投放位置、情绪、曲风、节奏感、乐器、整条剪辑的情绪走向、目标时长、上面是否有口播，以及需要避开的东西。
  2. 把卡片写成一段正向提示词，让曲风、情绪、节奏感、乐器、结构和用途汇成一个连贯方向。
  3. 当兼容性、控制项或价格重要时，用 beatra.models.list 读取文生音乐能力的实时卡片；用户提供了参考录音时，改读参考音频生成音乐能力的卡片。读卡片上的实时信息，不要臆测模型、控制项或输入限制。
  4. 付费前确认。 展示冻结后的提示词、instrumental: true、曲名、模型、卡片接受的模型选项、当前最高费用，以及一个不透明且稳定的 client_request_id。
  5. 只提交一次 beatra.music.generate，立刻记下任务 ID，并轮询同一个任务。
  6. 按顺序交付每一条返回的音频，附上真实时长、MIME 类型、大小和 URL 或 artifact ID，以及返回的曲名（如果有）、解析出的模型、实际用量和 billing.net_charged_credits。
  7. 对照音乐卡片复核结果。以实际返回的时长为准而不是请求的时长，并如实说明宿主 Agent 听不到哪些东西。

目标时长、便于循环的编排，以及给口播留出的位置，都作为编排方向写进提示词。音乐卡片、提示词写法、载荷、模型选项、参考曲目引导、故障恢复与交付复核见短视频配乐工作流（references/workflow.md）。

本 Skill 的执行方式

每个远程 Beatra 操作都使用随包的 scripts/mcp_client.py：在 call 后写入 MCP 工具名，并在标准输入中传入一个 JSON 对象。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。首次使用时通过 beatra.installations.register 注册本包。每次创作都是异步任务：提交一次，然后跟踪该任务直到终态。

需要确认的决策

提交之前先确认：冻结后的提示词、纯音乐设置、曲名、模型与模型选项，以及当前最高费用。更换提示词、曲名、模型、选项、参考曲目或纯音乐设置，都属于新的付费工作，需要新的请求 ID。

用户提供参考录音时，通过随包客户端上传一次，说清哪些要延续、哪些要改变，并把它当作音乐方向而不是对旋律或编排的承诺。

故障恢复

任务 ID 一返回就立即保存，并用 beatra.tasks.get 轮询；queued 和 running 表示继续等待。只有在创建请求的响应确实未知、且每个已校验参数在同一请求 ID 下逐字节相同时，才重放一次创建。任务 ID 丢失时，调用 beatra.tasks.list 查找，用 beatra.tasks.get 确认候选，先找回原任务再考虑新的工作。请求 ID 本身丢失时，不要臆造新 ID，也不要重放。只有用户要求时才调用 beatra.tasks.cancel；遇到 409 时继续轮询原任务，只有其终态为 canceled 时才报告已取消。

按任务查阅参考

  • 短视频配乐工作流（references/workflow.md）：音乐卡片、提示词构建、载荷、模型选项、参考曲目引导、故障恢复与交付复核。
  • 安装与认证（references/installation-and-auth.md）和安装注册（references/installation-registration.md）：首次使用与共享凭据。
  • 任务与结果（references/tasks-and-results.md）和计费、错误与恢复（references/billing-errors-and-recovery.md）：任务、artifact 与计费事实。
  • 随包 MCP Client 连接诊断（references/mcp-connection.md）：客户端操作与连接诊断；不要配置宿主 Connector。
  • 自动更新与安全（references/automatic-updates-and-safety.md）：更新行为与开关。
  • 卸载与断开连接（references/uninstall-and-disconnect.md）：移除本包与清理共享凭据。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只使用针对本包、渠道和语言环境固定的 Beatra 官方发现地址和不可变 CDN 路径，在替换前校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。更新检查、下载、校验、替换和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费生成的理由。这个设置会在后续命令中持续生效。

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 会报告官方可用版本但不替换文件。详见自动更新与安全（references/automatic-updates-and-safety.md）。