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

厨房讲房·厨房一镜

把房源已在用的那张厨房照,做成一条短片。

personAuthor: beatra01hubOpenAPI

厨房讲房·厨房一镜

把房源已经在用的那张厨房照,做成一条挂在房源页或短视频位的短片。一张照片做一条。不要拼成整套看房动线。

适用范围与相邻路线

经纪人或房东手上有一张厨房照,并且想让这一帧动起来时,使用本 Skill。

整套房间要做成一个包,转到 listing-room-video-pack。用房东的人像照做出镜说欢迎词,转到 airbnb-welcome-avatar。不是房源房间的普通静图,转到 image-to-motion。不要在这里重拍、修图、做虚拟软装或重新布光,也不要写房源文案或估价。不要去查公开帖子、评论或竞品房源。

输入与默认值

硬输入是:

  • 一张宿主 Agent 可以查看的厨房照;
  • 经纪人或房东自己的话,说清这张照片要动什么。

其余都是可选。复用对话里已有的房源名称、语言、市场和必须保留项。只补问缺失的硬输入。照片里的文字——家电品牌、房号、价目牌——小到或糊到抄不下来时,停下来要一张更清晰的文件,不要猜那些字。

不要编造照片没有拍到、经纪人也没有说明的家电、固定装置、尺寸或配套。照片不是未写明事实的来源。

画面运动只在下面这套词汇里选一个。动作小胜过动作大——要求的动作一大,台面边缘和柜门线条就会变形。

  • 一直可用,因为它们不会揭示照片上没有的东西:缓慢推近、光扫过台面,以及幅度足够小、不会在前景物体后面露出空缺的前后景轻移。
  • 只有经纪人提供了里面是什么——那个柜子、抽屉或家电的内部照片——才可用:开柜门、拉抽屉、开冰箱。没有这些,模型只会把里面的东西编出来,而租客或买家会把收纳和家电当成事实来读。要么问经纪人要那张内部照片,要么改做推近。

默认一次 beatra.videos.animatemodel: "auto",这张照片作严格首帧,不带 driving_audio,也不带 aspect_ratio——省略它并不是请求照片的比例,而是把比例交给档位卡:可能是模型声明的默认值、由源推导的比例,或者模型固定的行为。读所选模型的当场档位卡。除非这张卡承诺比例由源推导,否则把卡的输出比例和照片的比例比一比;两者不同时,在出制作卡之前就告诉经纪人取景会变。和经纪人选定 2–15s 范围内的整数时长;对方不选时用 5s,而不是 15s 上限。

标准路径

  1. 查看照片。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。把画面里每一处看得清的文字——家电品牌、房号、价目牌——逐字抄下来。本地文件检查后,只通过随包客户端上传。绝不要把本地路径传给远程工具。

  2. 写一份免费的分镜计划,让经纪人在产生任何费用之前就能核对:

    • 0.0s 的开镜状态,点名此刻还不存在的元素,好让揭示有出处;
    • 上面词汇里的那一个运镜,写明方向和速度;
    • 结尾静帧;
    • 每一处抄下来的文字,加引号,标注保持不变;
    • 提示词会带上的否定项:不要胶片颗粒、不要暗角、不要镜头光晕、不要水印、不要多余文字,也不要照片里本来没有的任何元素。

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

  3. beatra.models.list{"capability":"image_to_video"}。按当前档位卡准入这张照片,卡要接受首帧图片且不需要驱动音频。把 MIME、尺寸、字节和选定时长与卡上写明的限制逐条比对。任何必需的媒体事实拿不到或不兼容时,在出视频之前停下。

  4. 出一张当前制作卡并等待,然后才允许出现视频的 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。

    经纪人确认已充值或余额足够之前不要提交。

  5. 每张已批准的照片只提交一次 beatra.videos.animate,且只通过随包 scripts/mcp_client.py。不要配置宿主 Beatra Connector。也不要使用 REST/OpenAPI 作为降级。用 beatra.tasks.get 把这条视频任务轮询到终态。

  6. 交付这条短片,带上实际尺寸、时长、用量和 billing.net_charged_credits。对着计划审片:指名的那个运镜出来了吗,房间还是照片上那个样子吗,每一处引号里的文字放到原尺寸还认得出吗。漂移就如实说是漂移。绝不要发明拼接、concat 或剪辑工具。

需要确认的决定

分镜规划和当场报价不扣费。它们不是批准。视频动画需要上面的六字段卡。经纪人想换个效果而重出同一张照片,是新的付费工作,要换新卡、换新标识。拿到文件不等于同意把这张照片用到这条短片之外。

恢复

这张付费照片有一份冻结载荷和一个标识。丢失创建响应时,只许用完全相同的载荷恢复。丢失任务标识时,通过 beatra.tasks.listbeatra.tasks.get 找回。只有经纪人要求取消时才调用 beatra.tasks.cancel;遇到 409 继续轮询。遇到 insufficient_balance 时保持充值链接原样,经纪人说已充值后才用同一冻结标识重试。创建返回没有 task_id 时不要轮询;对账后再决定是否签发新标识。照片、提示词、时长或模型变了就是新工作,要换新卡。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面,并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_to_video"}

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

按任务查阅的参考

  • 分镜计划、载荷、确认、轮询、恢复和审片,读 厨房讲房工作流(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)。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新,最多每 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