前言¶

房源页常见做法是堆静态照片：客厅、卧室、厨房各一张，买家要自己脑补空间关系，带看前也很难快速扫一遍「每个房间动起来是什么样」。自己拍房间短视频成本高，通用图生视频 Skill 又未必按「一房一段、带房间名」来交付。

下面介绍 SkillHub 上的 房源视频·讲房套装（包名 listing-room-video-pack）：在 Agent 里把每张房源照片做成一段 2–15 秒的独立房间短片，并按房间标注；需要时可另做经纪人旁白音频，或在提供授权肖像与短稿时做讲房开场/收尾口播。成片适合房源讲解、楼盘展示和带看前的房间预览。

这是什么¶

房源视频·讲房套装 是 Beatra AI 在 SkillHub 生态发布的 Agent Skill，归类为 design-media。它面向经纪人或房源团队：输入可访问的房源照片，主交付物是 每个房间一段、带标签的短视频，而不是一条长片或自动拼接的完整讲房视频。

Skill 通过内置 Python 客户端 scripts/mcp_client.py 调用 Beatra 官方 HTTPS 服务；付费阶段（识图标注、图生视频、旁白、口播等）需在 admission 卡片上由用户确认后再提交。Skill 本身 不提供 拼接、混音或剪辑工具，也不会虚构这类能力。

在 SkillHub 侧，该 Skill 评分 99538，下载约 627 次（数据来自 SkillHub 列表页线索，以平台实时展示为准）。

核心功能¶

按房间生成标注短片¶

• 每张房源照片对应 一次 beatra.videos.animate 调用，照片作为严格首帧，默认 model: "auto"，画幅随源图比例。
• 单段时长为支持的 2–15 秒 整数 SKU，需与使用者共同选定。
• 主路线 不 在房间短片上挂载 driving_audio；房间动态与旁白/口播分产品交付。

自动或沿用房间标签¶

若照片文件名或上下文中已有房间名，可跳过识图标注。若缺少标签，Skill 会走 beatra.images.understand（需先展示积分预估与 client_request_id）：当前资料写明单张 admitted 图片约 5 credits，每批 1–8 张、单张不超过 10 MiB，再从返回文本为每张照片命名（如客厅、卧室、厨房）。

可选：经纪人旁白文件¶

通过 beatra.speech.synthesize 生成 独立的 旁白音频文件，与房间短片并列交付；不会 把旁白混进房间视频，也没有混音工具。

可选：口播片头/片尾¶

仅在用户提供 已授权的经纪人肖像 与脚本时，可走 talking-head 路线（规则与 founder-ip-avatar-studio 同类）：先处理 likeness/语音权限，再按 admission 流程合成语音并生成口播视频。这是与「房间短片包」分开的第三类产品。

与相邻 Skill 的分工¶

官方文档建议：单张商品图卖一条短片用 product-video-studio；非房源房间的通用静图用 image-to-motion；创始人 IP 口播用 founder-ip-avatar-studio。本 Skill 只处理 房源房间照片 → 标注房间短片集。

安装与启用¶

在支持 secure-skills 的 Agent 环境（如 Cursor、Codex CLI、Claude Code 等，以你使用的工具是否支持 npx secure-skills-cli 为准）中，执行：

npx secure-skills-cli add listing-room-video-pack

也可将下面话术发给 Agent，由其检索并安装：

执行命令安装此 skill： npx secure-skills-cli add listing-room-video-pack

Beatra 侧还提供安装说明入口（首次使用常涉及登录与注册）：

https://beatra.ai/skills/listing-room-video-pack/install.md

安装后，所有 Beatra 操作应通过 Skill 自带的 scripts/mcp_client.py 完成；不要把本地文件路径直接传给远程工具，本地照片须在检查后通过捆绑客户端上传。

SkillHub 官方条目地址：

https://api.skillhub.cn/beatra-ai/listing-room-video-pack

（若 API 页无法直接浏览，可在 SkillHub / 360 安全技能中心搜索 listing-room-video-pack 查看同款说明。）

典型用法¶

下面是与官方 Golden path 一致的可复现流程摘要，实际执行时 Agent 会按 SKILL 逐步确认付费边界。

1. 检查照片
   对每张房源图记录 MIME、宽高、比例、大小、是否带 alpha。本地图仅经客户端上传。

2. 补房间标签（可选）
   无标签时：beatra.models.list（capability: image_to_text）→ 展示 understand 预估 → beatra.images.understand → beatra.tasks.get 轮询至结束 → 写入房间名。

3. 图生视频 admission
   beatra.models.list（capability: image_to_video）核对每张图是否满足首帧图生视频约束；与用户确认 2–15s 时长后，逐房间展示 video admission 卡片（含积分预估、余额不足时的充值说明），用户确认后再提交。

4. 生成房间短片
   每房间一次 beatra.videos.animate，再 beatra.tasks.get 轮询至终端状态。

5. 旁白（可选）
   需要经纪人讲解稿时：beatra.speech.synthesize 各生成一个音频文件，与短片分文件交付。

6. 口播头尾（可选）
   有授权肖像与脚本时，按 talking-head 流程单独 admission、分段付费，不与房间短片混剪。

7. 交付与复盘
   返回带房间标签的短片、旁白/口播（如有）、实际分辨率、时长及 billing.net_charged_credits；检查房间身份、运镜与画面是否偏离原图。

账户相关只读查询：beatra.wallet.get（余额）、beatra.wallet.ledger（扣费记录）。余额不足时按错误中的 top-up 指引处理，用户确认充值后再用同一 frozen client_request_id 重试。

适用场景与注意¶

适合谁

• 要在 listing 页、IM 跟进包或带看前，让买家 按房间点开 预览动态画面。
• 已有房源实拍，希望快速得到「一图一段」的标注短片集，而不是从零写分镜拍视频。
• 需要旁白或经纪人口播，但接受 分文件交付（短片 + 音频/口播），自行在业务侧编排发布。

限制与坑

• 依赖 Beatra 外部服务与积分；图生视频等步骤为付费操作，600 credits 注册礼通常不足以直接开第一条视频，需在 admission 前确认余额。
• 不提供 stitch/concat/编辑器：不要指望 Skill 自动合成一条完整讲房长视频。
• 旁白不能作为房间短片的 driving audio 挂在同一次 animate 上。
• 口播需肖像与脚本授权， likeness 与语音权限须单独确认；长脚本可能拆成多段，每段独立计费。
• 最近更新时间为 2026-10-21（360 技能中心页展示），行为以你安装的 Skill 版本内 SKILL.md 为准。

结尾¶

房源视频·讲房套装 把「一堆房间照片」变成「按房间标注、可逐段打开的 2–15 秒短片」，并可选旁白或口播头尾，适合房源讲解与带看前预览。安装从 npx secure-skills-cli add listing-room-video-pack 开始；条目与说明见 SkillHub 官方地址 与 360 技能中心 listing-room-video-pack。