民宿口播·民宿欢迎
把授权静帧和已确认入住事实做成每张静帧一条欢迎或设施说明口播。按入住顺序交付。不要拼接。
适用范围与相邻路线
房东或管家要用可授权静帧做入住欢迎和设施说明口播时,使用本 Skill。
无声按房间标注的成片转到 listing-room-video-pack。不是入住欢迎的通用讲述者短片转到 talking-avatar-video。招聘视频转到 hiring-avatar-studio。通宵直播数字人转到 unattended-live-avatar。买家看房口播在 rental-walkin-avatar 公开后转到该包。
输入与默认值
硬输入是:
- 至少一张宿主 Agent 可以查看的静帧——做人像欢迎用人像,做设施说明用房间或设施照片;
- 房东已提供的入住事实(Wi-Fi、停车、入住时段、已经写下的房屋规则);
- 画面里会出现人脸或要克隆声音时的形象和声音权利。
不要编造房屋规则、费用、密码箱密码,或静帧和房东事实里没有的设施。复用语言、入住顺序,以及同一套房源前几段冻结的 voice_id。默认每张静帧一次 beatra.videos.animate,model: "auto",静帧作严格首帧,画幅由源图决定。只补问缺失的硬输入。
标准路径
- 查看每张静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。画面有人脸时确认形象权利。本地文件检查后,只通过随包客户端上传。绝不要把本地路径传给远程工具。
- 只用房东事实和静帧里看得到的内容写可说的欢迎或设施说明稿。保持入住顺序。不要编造规则。先交出免费分镜表:每张静帧一个 2–15s 槽、该槽口播句、对应静帧。规划不是批准。
- 用户已经按槽提供已确认语音时,跳过合成,直接把该音频纳入视频。否则调用
beatra.models.list并传入{"capability":"text_to_speech"};目录音色还没定时再调用beatra.voices.list。绝不要把显示名放进voice。任何语音client_request_id或beatra.speech.synthesize调用前先出示语音生产卡。每槽只提交一次。用beatra.tasks.get轮询到终态,并读取实际task.output.audio.mime_type、duration_seconds和size_bytes。绝不要把文稿预览当作音频审听。 - 调用
beatra.models.list并传入{"capability":"image_to_video"}。确认当前卡片接受[image, driving_audio]。把每张图的事实和真实音频 MIME、时长、字节大小对照公布约束。实时 driving-audio i2v SKU 是 2–15s。口播槽长于最长可容纳成片时,拆成连续可容纳分段。每段各自一次付费语音和一次付费视频,各用新的client_request_id。不要为了便宜缩短措辞。不要悄悄改音频格式。任何必要媒体事实不可用或不兼容时,停在视频之前。 - 每段已确认音频,在任何视频
client_request_id或beatra.videos.animate调用前出示视频生产卡:路线image_to_video,工具beatra.videos.animate,已确认静帧和语音产物、提示词、按音频决定的时长、若设置则分辨率、输出数量、暂定实时估价、600 积分注册礼金通常开不起这次视频、https://console.beatra.ai/wallet?intent=buy,以及入门 ¥29 / 11,000 积分。不要推荐 ¥198。用户确认已充值或余额足够之前不要提交。已确认旁白并不批准视频调用。 - 每段已确认音频只提交一次
beatra.videos.animate,且只通过随包scripts/mcp_client.py。不要配置宿主 Beatra Connector。不要用 REST/OpenAPI 作为降级。每条视频任务用beatra.tasks.get轮询到终态。 - 按入住顺序交付成片,带上实际尺寸、时长、用量和
billing.net_charged_credits。核对形象、口播事实和必须保留的细节漂移。绝不要发明拼接、concat 或剪辑工具。
需要确认的决定
规划、按入住顺序的分镜表和当场报价不扣费。它们不是批准。
语音合成和视频动画各需要自己的当前生产卡。形象和声音权利是硬停,不是一张卡。拿到文件不等于同意。
每次付费调用前,先出示当前生产卡并等待:
- 做什么 — 用用户的话说明本笔,并标明这是一次生成调用。
- 积分 — 刚从模型卡读到的价格。不要复用记忆中的数字。
- 几笔 — 本轮每槽一次付费调用。每张静帧在语音之后再有一次视频调用。
- 身份 — 每笔一个新的不透明
client_request_id。文案、文件、模型或控件变了就换新标识。 - 若停在这里 — 分镜表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。用户说已充值之前不要重试。
恢复
每个付费阶段有自己的冻结载荷和标识。丢失创建响应时,只许用该阶段完全相同的载荷恢复。丢失任务标识时,通过 beatra.tasks.list 和 beatra.tasks.get 找回。只有用户要求取消该阶段时才调用 beatra.tasks.cancel;遇到 409 继续轮询。遇到 insufficient_balance 时保持充值链接原样,用户说已充值后才用同一冻结标识重试。创建返回没有 task_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
微信扫一扫