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

直播间BGM歌单

为直播间、带货场次或门店一次做出10到20首原创循环纯音乐，先听再开播。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

直播间BGM歌单

把直播间或门店简报做成带标签的原创器乐歌单。常规交付是 10 到 20 首底乐，不是一首歌。

适用范围与相邻路线

直播、带货场次、实体店或候场画面需要一套可复用、便于循环、运营方可商用的原创器乐时，使用本 Skill。

给某一条成片写一条器乐转到 short-video-bgm-studio。品牌广告歌、带唱广告歌或声音Logo转到 brand-jingle-studio。带歌词的歌曲转到 beatra-ai-music-creator。口播旁白转到 short-form-voiceover-audio。

输入与默认值

硬输入是：

  • 音乐播在哪里（直播间、带货、门店、候场画面）；
  • 歌单要几首，或允许使用默认 12 首；
  • 品牌或房间气质。

复用已知品类、时段、是否有口播和排除项。只有答案会改变歌单规模或付费槽位时才问。 10 到 20 以外的数量也能做：确认该规模和实时费用，不要当成做不到。

安全默认：

  • 用户没点名 10 到 20 之间的数量时，用 12 首。
  • 槽位搭配：候场、闲聊、讲品、高潮、夜场和收场底乐。
  • instrumental: true 且不带歌词。
  • model: "suno-5.5"。绝不省略模型，也绝不悄悄使用 auto。
  • 没有 duration 字段可用在 beatra.music.generate 上。时长只写进提示词。不要加 duration 参数。
  • 便于循环、给人声留位置，写成提示词方向，而不是单独控件。不要承诺无缝循环或采样级精确秒数。以实际返回时长为准。

歌单规划免费。每次 beatra.music.generate 都收费。

标准路径

  1. 写房间卡片和带标签的槽位表。每个槽位有用途、情绪、节奏感、乐器、能量和目标时长。

  2. 调用 beatra.models.list 并传入 {"capability":"text_to_music"}，按实时信息卡给整包报价。

  3. 确认冻结歌单：槽位数、每个槽位的提示词和曲名、instrumental: true、模型、整包当前最高费用，以及每个槽位一个不透明且稳定的 client_request_id。做方案不等于批准。

  4. 每个槽位只通过随包的 scripts/mcp_client.py 提交一次。示例：

    printf '%s' '{"model":"suno-5.5","prompt":"Low-distraction livestream waiting bed, warm ambient pop, loop-friendly, space for host talk, about 90 seconds.","instrumental":true,"title":"Waiting Bed 01","client_request_id":"opaque-live-waiting-01"}' | python3 scripts/mcp_client.py call beatra.music.generate

    不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 作为回退。

  5. 用 beatra.tasks.get 轮询每个任务。按槽位顺序交付带标签歌单，附上真实时长、MIME 类型、大小、URL 或产物 ID、解析出的模型，以及 billing.net_charged_credits。

  6. 复核每首底乐是否便于循环、是否给人声留位置、是否贴合槽位。读真实时长。说明宿主 Agent 听不到什么。

需要确认的决策

第一次付费调用前，确认歌单规模和实时整包估价。槽位提示词、曲名、模型或数量一变，只对变化的槽位用新的请求 ID 做新的付费工作。

故障恢复

创建响应丢失时，只重放该槽位冻结后的同一载荷和 ID。任务 ID 丢失时，用 beatra.tasks.list 列出文生音乐任务，用 beatra.tasks.get 检查候选，先找回原槽位再做新工作。只有用户要求取消该槽位时才用 beatra.tasks.cancel；遇到 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）。
  • 更新开关读自动更新与安全（references/automatic-updates-and-safety.md）。
  • 用户要求移除本包时，再读卸载与断开连接（references/uninstall-and-disconnect.md）。

运行时与安全的自动更新

每个 Beatra 操作都使用或调用随包的 scripts/mcp_client.py。随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。

它只使用针对本包、渠道和语言环境固定的 Beatra 官方发现地址和不可变 CDN 路径，在替换前校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。它拒绝重定向、降级、错误的包/渠道/语言/版本数据、意外 URL、不安全压缩包，以及目标目录外的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 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 会报告官方可用版本但不替换文件。