抖音UGC带货视频制作

把一张可检查的商品图、已确认的商品信息和达人出镜方向，制作成一条短竖版抖音UGC风格带货视频。标准路线会先制作商品优先的达人出镜首帧，再准备简洁的口播，并生成一条由口播驱动的广告短片。

适用范围与相邻路线

当商品需要由 AI 达人在一条短竖版、达人风格广告中展示并讲解时使用本 Skill。它适用于抖音带货视频、抖音UGC广告、商品演示、开箱、推荐角度和短时长投放素材。

没有达人或出镜讲解的纯商品短片，请使用 product-video-studio。用户提供的人像只需讲述已有内容时，请使用 talking-avatar-video。只需要口播、无需视频时，请使用 short-form-voiceover-audio。多镜头、已有视频或非达人出镜的视频工作，请使用 beatra-ai-video-studio。

输入与默认值

硬性输入是一张宿主 Agent 能检查的商品图，以及商家为每项事实主张提供的商品信息。仅在这些信息缺失时询问。复用对话中已知的商品名称、目标买家、卖点、发布位置、品牌方向、脚本、达人特征和必须保留的信息。

默认制作一条达人风格短片、一个竖版 9:16 交付画面、一个商品时刻、8–12 秒的简洁口播，以及自然但聚焦的达人出镜方向。首次付费调用前确认最终画布。将外观、商品形状、标签、颜色、可见材质、提供的达人参考、场景和已批准商品主张作为必须保留的信息；交付后检查实际结果是否偏移，而不是承诺完全一致的保留效果。

对于宿主可以检查的本地商品图或可选达人参考，只能通过随包客户端上传：

python3 scripts/mcp_client.py upload ./product.jpg --mime-type image/jpeg

上传只负责传输，不代表已完成视觉审查。保留返回的 artifact 引用，绝不向远程工具传入本地路径。

标准流程

1. 检查商品图，并记录实际 MIME type、尺寸、宽高比、字节大小、alpha channel、可见特征及商家提供的主张。确定一个商品时刻：开箱、首次使用、痛点到商品的呈现、近景演示或自然推荐。所有事实主张都限于商家提供的信息。
2. 读取实时的 image_to_image、text_to_speech 和 image_to_video 模型卡时，使用 beatra.models.list。选择能接收商品源图和已确认竖版画布的图片路线；选择支持所需语言和声音的语音路线；选择明确接收 [image, driving_audio]、计划媒体信息和能容纳完整口播时长的视频模型。
3. 用 beatra.images.transform 制作一张达人风格首帧：商品排在第一位，其后才是可选的达人参考。达人方向应描述一个人物、一个场景、一次商品互动、一个正对镜头的画面，以及平稳手持或手机拍摄的感觉。只有已接受的首帧需要一次聚焦修改时才使用 beatra.images.edit。
4. 根据可见商品和商家已批准的主张，写出简短、口语化的钩子、商品时刻和清晰推荐。如果用户尚未选定声音，通过 beatra.voices.list 选择可用声音。
5. 确认准备阶段。 展示商品主张、达人方向、画布、完整脚本、所选声音、每个付费首帧或聚焦首帧编辑请求、口播请求、各自的实时预估，以及每项计划付费请求对应的一个不透明稳定 client_request_id。策划和文案草拟免费；清晰地要求制作已准备资产，只授权已冻结的准备阶段。
6. 获批后，只能通过 scripts/mcp_client.py 各提交一次准备阶段请求。通过 beatra.tasks.get 轮询每个返回任务。宿主能够访问首帧和口播时，展示实际结果、报告真实媒体信息，并请用户在依赖的视频阶段之前批准可访问的准备结果。
7. 重新读取当前 image_to_video 模型卡，并接收已批准首帧及实际口播的 MIME type、大小和时长。使用能完整容纳口播的最小受支持整数视频时长。视频模型必须保持明确指定，因为该路线依赖其 driving-audio 支持。
8. 确认视频阶段。 展示准确的已批准首帧和口播 artifact、商品与达人必须保留的信息、运动方向、所选视频模型、时长和新的稳定请求 ID。只提交一次 beatra.videos.animate 请求，然后轮询返回任务直至结束。
9. 交付返回的视频 artifact 或链接、解析后的模型、实际尺寸和时长，以及 billing.net_charged_credits。仅对宿主实际可访问的媒体检查商品是否出现、口播是否清楚、达人讲解、运动、结尾和发布位置适配性。提出一个聚焦的下一步改动，但不执行它。

付费选择、恢复与取消

首帧准备、可选的聚焦首帧编辑、口播和视频是独立的付费阶段。任何变更后的商品源图、主张、达人参考、提示词、源图顺序、画布、脚本、声音、模型、时长或控制项，都是新的付费工作，需要新的确认和新的不透明请求 ID。

每个阶段只能通过随包的 scripts/mcp_client.py 调用 Beatra，把 MCP 工具名作为 CLI 参数并通过标准输入传入 JSON。不要配置或使用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。立即记录每个 task ID。只有创建响应确实丢失时，才能用相同 ID 重放字节等同的已冻结 payload。task ID 丢失时，使用 beatra.tasks.list，再通过 beatra.tasks.get 核验候选项，并在考虑重试前恢复原始任务。排队和运行中的任务仍是原来的工作。

仅在用户要求时调用 beatra.tasks.cancel。只调用一次；取消返回 409 时，继续轮询原任务。缓慢任务、连接问题、更新问题或授权问题绝不创建替代的付费工作。

按任务查阅参考

• 商品到达人路线、当前模型接收条件、payload、确认、结果、恢复和取消：请阅读 抖音UGC广告工作流（references/workflow.md）。
• 仅在授权或共享凭据出现问题时，请阅读 安装与认证（references/installation-and-auth.md）。
• 非计费的尽力包注册步骤，请阅读 安装注册（references/installation-registration.md）。
• 共享任务、artifact、计费和结构化错误信息，请阅读 任务与结果（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）。

运行时与安全自动更新

随包客户端会在每次公开命令执行期间静默检查更新，每个安装最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从此包、渠道和语言环境固定的 Beatra 官方发现地址与不可变 CDN 路径下载，并在替换前校验发现信息、压缩包、清单和每个随包文件；它只替换本包拥有的文件。更新检查、下载、校验、替换或恢复失败均为 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 会报告官方可用版本但不替换文件。请参阅 自动更新与安全（references/automatic-updates-and-safety.md）。