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

Instagram详情视频·Reel转一镜

按已经读过的对标Reel构图，给每张商品图做成一条详情一镜。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

Instagram详情视频·Reel转一镜

把卖家已经拍好的商品静帧，做成每张静帧一条商品详情短片。 卖家给出链接或账号时，先读对标 Instagram Reel 的构图。每条短片各自成文件。

适用范围与相邻路线

卖家要按每张商品静帧做一条短商品详情片，并且先读对标 Reel， 或按已经写好的构图说明来做时，使用本 Skill。

只要静帧详情套图时，转到 instagram-reel-to-pdp-set。酒店设施静帧转到 hotel-amenity-clip。组装步骤转到 assembly-one-step-clip。不是商品详情短片的通用静帧转到 image-to-motion。

本包只读公开 Instagram Reels，并做无配音商品短片。它不代发 Instagram。

收集商品静帧

硬输入是：

  • 至少一张宿主 Agent 能打开、可检查的商品静帧；
  • 每张静帧的 SKU 或商品名；
  • 公开 Instagram Reel 链接、对标用户名，或已经写好的构图说明；
  • 2–15 秒范围内的时长，或允许使用 5 秒。

复用已知语言、画幅和必须保留项。只补问缺失的硬输入。

不要编造卖家没给的运镜、文案、播放数或 SKU。拿到文件不等于同意把静帧用到这组商品之外。

静帧在而商品名为空时，停下来收集商品名。已经写好的构图说明可以跳过查找。

先做免费分镜表

任何付费查找或动画前，先写带标签的商品短片清单。一张静帧一条。每条记下卖家给出的商品名、检查过的静帧事实、已确认的 Reel 构图或书面说明，以及选定时长。

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

安全默认：

  • 每张静帧一次 beatra.videos.animate；
  • model: "auto"；
  • 该静帧作为首帧；
  • 不要加 driving_audio；
  • 按原图推导画幅；
  • 卖家没有另报 2–15 之间的整数时，时长 5 秒。

检查每张静帧。记下 MIME type、宽、高、画幅、字节大小，以及有没有透明通道。本地文件检查后，只通过随包客户端上传 （scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给 beatra.videos.animate。

查找 Reel 单独一张卡

用户名或 Reel 链接并不等于批准查找。卖家要当前连接去读一条公开 Instagram Reel 或账号时，按 查询 Reel（references/reel-lookup.md） 先搜索、再检视，然后出示六字段查找卡并等待：

  1. 做什么 — 读一份公开 Instagram Reel 或账号页 （beatra.social.execute，使用刚检视到的 operation_key）。
  2. 积分 — beatra.social.tools.get 刚刚返回的实时价格。 引用这个实时数字，不要用记住的数。
  3. 几笔 — 一次预付查找。下一页 Reels 是另一笔费用。
  4. 身份 — 每一次执行一个新的不透明 client_request_id。
  5. 若停在这里 — 带标签的分镜表仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 （https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

不要向卖家展示 schema_hash。已确认的查找并不批准出片。查找结束后，报告载荷、任务编号、终态和 billing.net_charged_credits。查找没有模型、尺寸或时长可报。

确认动画

视频前，调用 beatra.models.list，能力为 image_to_video：

{"capability": "image_to_video"}

每张静帧对照当前卡片：接受首帧图、不要配驱动音频。把每项图像事实和选定时长与公示限制比对。缺必要媒体事实或不相容时，停在视频前。

出示一张当前制作卡，并在任何视频 client_request_id 或 beatra.videos.animate 之前等待：

  1. 做什么 — 每个点名静帧一条商品详情短片 （beatra.videos.animate）。
  2. 积分 — 刚读到的 image_to_video 价格。不要复用记忆中的数字。
  3. 几笔 — 每张静帧一次付费调用。
  4. 身份 — 每张静帧一个新的不透明 client_request_id。
  5. 若停在这里 — 带标签的分镜表仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 （https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

每张静帧只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。读取实际视频 MIME、时长和大小，以及 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": "image_to_video"}

printf '%s' '{"image":{"type":"artifact","artifact_id":"<the uploaded product still>"},"prompt":"<the written product name and confirmed Reel composition for this still>","duration":5,"client_request_id":"opaque-pdp-01"}' | python3 scripts/mcp_client.py call beatra.videos.animate

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

按任务查阅的参考

  • 分镜表、载荷和恢复，读 商品详情短片工作流（references/workflow.md）。
  • Instagram Reel 查找，读 查询 Reel（references/reel-lookup.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