← Back to skills
extension
Category: Content & MediaAPI key requirement unconfirmed

活动全套物料

海报、一条预告短片、一段口播,需要时再加一条广告歌。

personAuthor: beatra01hubOpenAPI

活动全套物料

你会拿到

  • 活动文案和一份画面安排。文案带上名称、时间和卖点。
  • 你确认的海报,共用一套样子。
  • 一段你接受的文案的口播。
  • 一条预告:主海报动起来,口播在画面上。
  • 一条垫在口播下面的器乐广告歌,除非你划掉它。

怎么跑

  • 整套。默认。文案和安排,然后海报、口播、预告和广告歌。
  • 文案和安排。在卡上划掉成片。
  • 你提供的声音。一次克隆,只有当你交出一段干净的单人样本,并确认你有权使用它。

门店活动、上新或促销,名称、时间和卖点已经知道,就从这里开始。

范围和相邻路线

这条路线用于一场活动需要的物料:门店活动、上新或促销。没有活动日期的常设品牌样子走视觉创作。一套商品上架图走商品素材。

输入和默认

硬性输入是这场活动:它的名称、什么时候、卖点是什么。这三项里缺了什么就只问什么。默认一张竖屏海报、一张方图、一段用户语言的口播、一条从竖屏海报做出的预告,以及一条器乐广告歌。不要编造票房、直播间或广告账户。

黄金路径

  1. 写出文案和画面安排并展示。这段文字不收费。
  2. 有品牌图或商品图时,用 beatra.assets.upload 上传。第一张海报是 beatra.images.transform,载荷 {"capability": "image_to_image"},从这张图出发;没有图时是 beatra.images.generate,载荷 {"capability": "text_to_image"}。后面的海报是 beatra.images.transform,从已接受的海报出发。名称、时间和卖点放在清楚的色带上;字回来不对时,一次 beatra.images.edit,载荷 {"capability": "image_edit"},写上这些原词。
  3. beatra.voices.list,然后一次 beatra.speech.synthesize,载荷 {"capability": "text_to_speech"}。提供的样本是一次 beatra.voices.clone,载荷 {"capability": "voice_clone"},只在用户确认权利之后。一次器乐 beatra.music.generate,载荷 {"capability": "text_to_music"}。
  4. 制作卡,然后视频卡:一次 beatra.videos.animate,载荷 {"capability": "image_to_video"},从竖屏海报出发,口播作为 driving_audio,用接受它的模型。
  5. 一次 beatra.videos.compose 保留口播并把广告歌压低。用 beatra.tasks.get 轮询,交付这一套和 billing.net_charged_credits。

需要确认的决定

规划和写出来的文字不收费,也不算批准。

每次付费调用之前,出示当前的制作卡并等待:

  1. 做什么:用用户的话说出将要做出的东西,并说明这次是生成、克隆还是查询。
  2. 积分:刚刚从模型卡读到的现价。不要沿用记得的数字。
  3. 次数:每个槽位一次付费调用。制作卡可以列出海报、口播和广告歌;每个槽位有自己的 client_request_id。预告另等一张卡。
  4. 标识:每次调用一个新的不透明 client_request_id。提示词、文件、模型或控制项一变,就换一个新标识。
  5. 停在这里:已经写出的文字仍然可用。
  6. 余额不足:原样转达官方消息和其中的充值地址。用户说已经充值之前不要重试。

声音克隆是自己的一张卡。只有用户确认对这段样本有权,并且 consent_attested 为真时才提交。查询和生成是两张卡。已确认的海报和音频不批准预告。所有远程 Beatra 工具只通过随包 scripts/mcp_client.py 调用。工具名是命令参数,JSON 参数走标准输入。不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 降级。

创建响应丢失时,只用逐字节相同的载荷和同一个 client_request_id 重试。任务标识丢失时,先调用 beatra.tasks.list,再调用 beatra.tasks.get,对照冻结的请求之后才做相同重试。只有用户要求取消时才调用 beatra.tasks.cancel,然后用 beatra.tasks.get 确认该任务。

用户问还剩多少积分时,调用 beatra.wallet.get。用户问扣了什么时,调用 beatra.wallet.ledger。

按任务阅读

预告载荷和一套做成的物料,读场景工作流(references/workflow.md)。 任务卡住、响应丢失、价格看起来不对,或海报丢了时间或卖点,读出错时怎么处理(references/faq.md)。 连接还没就绪时,读安装与认证(references/installation-and-auth.md)。 首次注册,读安装注册(references/installation-registration.md)。 调用在任务出现之前失败时,读随包 MCP Client 连接诊断(references/mcp-connection.md)。 任务在排队、运行或找不到时,读任务与结果(references/tasks-and-results.md)。 扣费、退款或丢失的响应需要共用规则时,读计费、错误与恢复(references/billing-errors-and-recovery.md)。 用户要停止并移除连接时,读卸载与断开(references/uninstall-and-disconnect.md)。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。