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

全案营销

公开热帖里的选题、一张海报、一条商品短片和一条广告歌。

personAuthor: beatra01hubOpenAPI

全案营销

你会拿到

  • 一份方案:卖点、受众、值得用的选题,以及每件成品要说的那句话。
  • 一张海报。你提供商品图时,海报上就是这个商品。
  • 一条从海报做出的口播商品短片,十秒以内。
  • 一条器乐广告歌,在成片里压在人声下面。

怎么跑

  • 方案和成品。默认。方案不收费,然后是海报、短片和广告歌。
  • 只要方案。在卡上划掉成品。
  • 带一次实时读取。方案定稿之前,在抖音、小红书或 TikTok 上查一次公开内容;这句话要用买家的话时,把评论算进去。

一个卖点要在同一天离开,成为海报、口播短片和广告歌,就从这里开始。

范围和相邻路线

这条路线用于一个卖点要作为一小套成品离开,不是只要一张海报,也不是审核你已经有的文件。一套商品上架图走商品素材。成品文件的审核走营销素材审核。

输入和默认

硬性输入是这个商品,以及写给谁。缺了只问这个。默认一张竖屏海报、一条十秒以内会说话的竖屏短片、一条器乐广告歌,以及短片和广告歌收成一条。不要编造广告账户数字、店铺销量、直播间数据或微信指标。外面只读公开帖子。

黄金路径

  1. 写出方案并展示。这段文字不收费。
  2. 这次包含实时读取时,用 beatra.social.tools.search 和 beatra.social.tools.get,复制 schema_hash,出示查询卡,并调用一次 beatra.social.execute。允许的键是 social.douyin.hot_search.list、social.douyin.video.search、social.douyin.video.comments.list、social.xiaohongshu.note.search、social.xiaohongshu.note.comments.list、social.tiktok.video.search。
  3. 有商品图时用 beatra.assets.upload 上传。海报是 beatra.images.transform,载荷 {"capability": "image_to_image"},从这张照片出发;没有照片时是 beatra.images.generate,载荷 {"capability": "text_to_image"}。海报丢了商品时,一次 beatra.images.edit。
  4. beatra.voices.list,然后一次 beatra.speech.synthesize,载荷 {"capability": "text_to_speech"},读短片的那句话。一次器乐 beatra.music.generate,载荷 {"capability": "text_to_music"}。
  5. 制作卡,然后视频卡:一次 beatra.videos.animate,载荷 {"capability": "image_to_video"},从海报出发,这句话作为 driving_audio,用接受它的模型,时长是下一个整秒并且在十秒以内。
  6. 一次 beatra.videos.compose 保留这句话的声音并把广告歌压低。用 beatra.tasks.get 轮询,交付方案、海报、短片和 billing.net_charged_credits。

需要确认的决定

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

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

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

查询和生成是两张卡。已确认的海报、口播和广告歌不批准短片。所有远程 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)。