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

广告歌生成·品牌主题曲

把品牌名、口号和投放场景做成一组原创广告歌、品牌主题曲和声音Logo，先听再定稿。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

广告歌生成·品牌主题曲

把品牌简报做成可试听的原创广告歌、品牌主题曲和声音Logo。先听几条风格草图，锁定基因，再派生其他时长。

适用范围与相邻路线

用户需要商用品牌音乐时使用本 Skill。

花钱前先拆任务：

  • 声音Logo或短戳是短器乐识别音。先交三条短草图，除非用户要求派生更长版本，否则停在这里。
  • 带唱广告歌或品牌主题曲走钩子加时长路线：先在一个主时长上出三条风格草图，用户锁定一条后再派生其他时长。
  • 器乐底上的口播口号不是唱词。器乐底和口播句做成两个产物。本 Skill 不能把它们混成一条。

送人或纪念日歌曲转到 personalized-song-maker。已经写好、只需要旋律的歌词转到 suno-lyrics-to-song。给某一条成片配一条器乐底转到 short-video-bgm-studio。直播间或门店的多首标注歌单转到 livestream-bgm-pack。已有录音的翻唱转到 ai-song-cover-studio。方向混杂或不确定的音乐请求留在 music-generation-studio。

输入与默认值

硬输入是：

  • 品牌或产品名；
  • 投放去处（广告、门店、播客片头、开播、活动上场或声音Logo）；
  • 唱词或口播的语言；
  • 这条要唱钩子、保持器乐，还是加口播口号。

复用已知口号、必须出现的词、情绪、曲风、人声方向和排除项。只有答案会改变钩子、人声路线或付费格子时才问。投放去处已知时，不要再问 15 / 30 / 60 表。

安全默认：

  • 先在一个主时长上出三条风格草图。广告、播客片头和开播默认大约 15 秒。电台和门店循环默认大约 30 秒。声音Logo默认 2 到 5 秒的器乐短戳。
  • 只有用户要求每种风格的每种时长时，才做完整 3 × 3。
  • 大约 15 秒的提示词保持一个段落。大约 30 秒用前奏加主体。短戳写两到四个音和干净收尾。
  • 常规音乐使用 model: "suno-5.5"。绝不省略模型，也绝不悄悄使用 auto。
  • 没有 duration 字段可用在 beatra.music.generate 上。时长只写进提示词。不要加 duration 参数。
  • 调用方提供歌词时必须带 model_options.suno.custom_mode: true。
  • 任何付费调用前先写好并展示钩子、唱词或口播口号。
  • 声音Logo或短戳设置 instrumental: true，且不带歌词。

写词、口号打磨、风格卡片和方案都免费。每次 beatra.music.generate 都收费。口播口号是另一次付费的 beatra.speech.synthesize。

标准路径

  1. 收集品牌卡片。起草钩子；要唱时写一段重复品牌句的短歌词。用户要口播口号时，把那句写成口播，不要写成唱词。

  2. 按投放去处选定主时长。调用 beatra.models.list 并传入 {"capability":"text_to_music"}，给三条草图报价。

  3. 确认三条冻结音乐载荷：提示词、歌词或器乐开关、曲名、模型、当前最高费用，以及各自一个不透明且稳定的 client_request_id。做方案不等于批准。短戳路线只确认那三条短器乐。

  4. 每条草图只通过随包的 scripts/mcp_client.py 提交一次。示例：

    printf '%s' '{"model":"suno-5.5","prompt":"Bright brand jingle, one compact pop section, about 15 seconds, clean ending sting.","lyrics":"[Hook]\nApproved brand line\n","title":"Approved 15s Hook","model_options":{"suno":{"custom_mode":true}},"client_request_id":"opaque-jingle-15s-a"}' | python3 scripts/mcp_client.py call beatra.music.generate

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

  5. 用 beatra.tasks.get 轮询每个任务。交付真实 duration_seconds、MIME 类型、大小、URL 或产物 ID、解析出的模型，以及 billing.net_charged_credits。复核钩子、收尾，以及真实时长离目标有多近。给一个具体下一步，例如 BPM 92 到 108，不要只说「做得不一样」。

  6. 用户锁定一条草图后，把每个派生时长当作新的付费工作，使用新的请求 ID。已接受的草图不要动。

  7. 用户要的是口播口号而不是唱钩子时，调用 beatra.voices.list 和 beatra.models.list，并传入 {"capability":"text_to_speech"}。确认当前语音信息卡后，提交一次 beatra.speech.synthesize，使用它自己的 client_request_id。器乐底和口播句分成两个产物交付。不要声称它们已经混好。

30 秒电台风格广告，在提示词和交付时都写时间线：0–3 钩子，中间卖点，收尾品牌句。

需要确认的决策

第一次付费音乐调用前，确认三条草图和实时音乐估价。每个派生时长在那次调用前再确认。beatra.speech.synthesize 前确认口播口号卡片。钩子、歌词、口播句、提示词、时长、风格、模型、声音或器乐设置一变，就是新的付费工作，需要新的请求 ID。

请求时长是编排方向。以实际返回时长为准。不要承诺采样级精确的 15.00 秒，也不要把主歌–副歌–桥硬塞进 15 秒提示词。

故障恢复

创建响应丢失时，只重放该候选冻结后的同一载荷和 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）。不要配置宿主 Connector。
  • 更新保证与开关读自动更新与安全（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 会报告官方可用版本但不替换文件。