shield_lock
JinDaGe
← Back to skills
extension
Category: Marketing & GrowthNo API key required

房源视频·讲房套装

用房源照片做成按房间标注的短视频套装，每个房间一段。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

房源视频·讲房套装

把房源照片做成按房间标注的短片套装。每张房间照片各自做成一段短动态。可选经纪人旁白文件放在这些成片旁边。可选口播开场或收尾是另一条产品，只有用户带来获权经纪人人像和文稿时才做。

适用范围与相邻路线

经纪人或房源团队要用房源照片做成一套带标注的房间短片时，使用本 Skill。

一张商品照片要卖成一条成片时转到 product-video-studio。不是房源房间的普通静帧转到 image-to-motion。每周创始人思想领导力转到 founder-ip-avatar-studio。

主交付是每个房间一段带标注成片。不要发明拼接、串联或剪辑工具。

输入与默认值

硬输入是至少一张宿主 Agent 可以查看的房源照片。只补问缺失的硬输入。

复用已知地址、房间名称、语言和投放去处。默认每个房间一次 beatra.videos.animate，model: "auto"，照片作严格首帧，画幅由源图决定。和用户一起选定 2–15 秒规格内的受支持整数视频时长。用户已经为每张照片命名时，跳过房间标注。

可选第二产品：用 beatra.speech.synthesize 另做经纪人旁白文件。绝不要把这些文件混进房间成片。

可选第三条路线：只有用户带来获权经纪人人像和文稿时，才做讲房开场或收尾口播。形象、声音、音频复核和视频入场规则与 founder-ip-avatar-studio 相同。除非用户已有已确认语音，否则用目录声音。

标准路径

  1. 查看每张房源照片。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地照片检查后，只通过随包客户端上传。绝不要把本地路径传给远程工具。
  2. 房间名称缺失时，调用 beatra.models.list 并传入 {"capability":"image_to_text"}。出示理解估价（目前每张准入图片 5 积分，每次一到八张，每张不超过 10 MiB）以及一个 client_request_id，再调用 beatra.images.understand。每批只提交一次，用 beatra.tasks.get 轮询到终态，按返回文本给每张照片标名。名称已有时跳过这一步。
  3. 调用 beatra.models.list 并传入 {"capability":"image_to_video"}。按当前接受首帧图片、不要驱动音频的信息卡，给每张照片做准入。把每项图片事实与公布约束比较。和用户一起确认时长为受支持的 2–15 秒规格。必要媒体事实缺失或不兼容时，在视频前停止。
  4. 每个房间在任何视频 client_request_id 或 beatra.videos.animate 调用前出示视频入场卡：路线 image_to_video，工具 beatra.videos.animate，已准入照片、提示词、选定时长、若设置则含分辨率、输出数量、暂定实时估价、600 积分注册礼金通常开不起这次视频、准确 URL https://console.beatra.ai/topup，以及入门 ¥29 / 11,000 积分。 不要推荐 ¥198。用户确认已充值或余额足够之前不要提交。每个房间只做一次动态。这条主路线不要附带 driving_audio。
  5. 每张已准入房间照片只提交一次 beatra.videos.animate。不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 作为回退。用 beatra.tasks.get 轮询每个视频任务到终态。
  6. 用户还要经纪人旁白文件时，调用 beatra.models.list 并传入 {"capability":"text_to_speech"}，仍需选目录声音时再调用 beatra.voices.list。绝不要把显示名放进 voice。出示旁白参数和付费边界。冻结文稿、声音、格式，以及每个文件一个语音 client_request_id。每个文件只提交一次 beatra.speech.synthesize。轮询到终态，读取真实的 task.output.audio.mime_type、duration_seconds 和 size_bytes。这些音频文件与房间成片并排放交付。不要把它们当作房间照片动态调用上的 driving_audio。没有混音工具。
  7. 用户还带来获权经纪人人像和文稿、要做讲房开场或收尾时，按第 1 步同样查看人像。确认形象和声音权利。拿到文件不等于同意。按口播准入路径：在实时信息卡上确认 [image, driving_audio]，合成或准入语音，把旁白轮询到终态并读取真实音频 MIME、时长和大小，再在任何口播 client_request_id 前出示单独的视频入场卡。实时驱动音频图生视频（wan2.7-i2v）规格为 2–15 秒。长于一段可容纳成片的文稿拆成连续分段。每一段是自己的付费语音调用和付费视频调用。不要靠删词来压低费用。不要静默改音频格式。选用不短于真实语音长度的最小受支持整数视频时长。已确认旁白并不授权视频调用。
  8. 交付带标注的房间成片、任何单独旁白文件，以及任何开场或收尾成片，附上真实尺寸、时长、用量和 billing.net_charged_credits。复核房间身份、动态和必须保留项的偏移。绝不要发明拼接、串联或剪辑工具。

需要确认的决策

照片动态入场、可选理解批次、可选旁白、口播形象和声音权利，以及口播视频入场卡各自单独确认。

故障恢复

每个付费阶段有自己的冻结载荷和 ID。创建响应丢失时，只重放该阶段同一载荷。任务 ID 丢失时，通过 beatra.tasks.list 和 beatra.tasks.get 找回。只有用户要求取消该阶段时才调用 beatra.tasks.cancel；遇到 409 就继续轮询。遇到 insufficient_balance 时，充值链接保持原样，用户说已充值后才用同一冻结 ID 重试。创建返回没有 task_id 时不要轮询；先对账，再考虑新 ID。

按任务查阅参考

  • 标注、照片动态入场、可选旁白、口播开场或收尾、载荷和复核，读房源房间视频工作流（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）。
  • 更新开关读自动更新与安全（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