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

新年配乐·零售歌单

按已经写好的档期气氛，做成8到15首能在店里循环的器乐。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

新年配乐·零售歌单

把已经写好的新年档期气氛，做成带标签的原创器乐歌单。常规交付是 8 到 15 首底乐，不是一首歌。

适用范围与相邻路线

零售楼层需要一套可复用的原创器乐，覆盖新年档期时，使用本 Skill。

日间办公或联合办公歌单转到 coworking-day-pack。 直播、夜班或带货歌单转到 livestream-bgm-pack。 品牌广告歌或带唱广告转到 brand-jingle-studio。 带词歌曲转到 beatra-ai-music-creator。

收集楼层

硬输入是：

  • 音乐播在哪里（精品店、商场铺位、商超通道，或其他已点名的零售楼层）；
  • 歌单要几首，或允许使用默认 10 首；
  • 卖方已经写好的新年气氛。

复用已知时段、是否要盖过人声、以及排除项。只补问缺失的硬输入。8 到 15 以外的数量也能做：确认该规模和实时费用。

不要编造促销日期、促销价、品牌口号或歌词。

先做免费分轨表

任何付费写曲前，先写带标签的新年分轨表。卖方没有另报 8 到 15 之间的数量时，默认十首：开门、逛店、试穿或取货、午间、下午和收工，其余用安静的档期重置补齐。每首记下用途、气质、节奏感、乐器、能量，以及写成提示词方向的目标时长。

这份清单就是免费可见结果。规划不是批准。

安全默认：

  • instrumental: true 且不带歌词。
  • model: "suno-5.5"。绝不省略模型，也绝不悄悄使用 auto。
  • 没有 duration 字段可用在 beatra.music.generate 上。时长只写进提示词。不要加 duration 参数。以实际返回时长为准。

确认生成

任何计费曲目前，读取当前的 beatra.models.list 卡片，能力为 text_to_music。出示一张当前生成生产卡，覆盖冻结后的整包，并等待：

  1. 做什么 — 每个点名分轨一首新年器乐，一次生成 调用（beatra.music.generate）。
  2. 积分 — 刚读到的 text_to_music 价格乘以首数。不要复用记忆中的数字。
  3. 几笔 — 每首一次付费调用。不要把多首塞进同一次提交。
  4. 身份 — 每首一个新的不透明 client_request_id。提示词、曲名、模型或数量变了，就只给变化的分轨换新标识。
  5. 若停在这里 — 带标签的分轨表仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 （https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。卖方说已充值之前不要重试。不要推荐 ¥198。

每首只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。交付实际字节、实际时长和 billing.net_charged_credits。

审听、交付与恢复

按档期贴合和能否盖过人声复核每首底乐。只报告宿主实际听得到的内容。不要承诺无缝循环或精确秒数。

拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用 beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。只有卖方要求时才取消。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "text_to_music"}

printf '%s' '{"model":"suno-5.5","prompt":"Warm new-year retail browse bed, light bells and soft strings, no vocals, about 90 seconds.","instrumental":true,"title":"Browse 01","client_request_id":"opaque-ny-browse-01"}' | python3 scripts/mcp_client.py call beatra.music.generate

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

按任务查阅的参考

  • 分轨表、载荷和恢复，读 新年歌单工作流（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）。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费写曲请求的理由。这个设置会在本安装中持续生效。见 自动更新与安全（references/automatic-updates-and-safety.md）。

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