AI视频续写与延长

概述

在一条短视频已有动作的开头或结尾自然地继续。本 Skill 适用于用户已有一条源视频，并要求续写下一个动作、延长一个瞬间、延伸建立镜头、添加前奏、补全揭幕、创造自然结尾，或生成衔接源视频的下一段画面。

适用范围与相邻路由

常规路线是一条源视频、一个向前/向后方向和一条延长片段。需要将已有片段转绘成新视觉风格的请求路由到视频转绘工作流；需要修改源视频已有帧而非添加新画面的请求路由到视频编辑工作流；需要以两张固定图片作为起止的请求路由到首尾帧工作流。本路线专注于为一条源视频添加衔接画面，而非拼接多条片段。

输入与默认值

硬性输入是：

• 一条宿主 Agent 可以查看的可访问源视频；
• 续写方向——在开头或结尾添加画面；
• 新画面应达到的下一个视觉节拍。

只询问缺失的硬性输入。复用已知的场景、氛围、人物、镜头和源声音偏好。可信的源时长本身就是一个硬性规划输入，因为延长时长据此设定。

对于宿主 Agent 可访问的本地源文件，仅在查看之后使用随包上传助手：

python3 scripts/mcp_client.py upload ./source-clip.mp4 --mime-type video/mp4

上传只是传输，不是创意审阅。保留返回的素材引用，绝不向远程工具传递本地路径。

默认输出一条延长片段和 model: "auto"。从源视频的结尾或开头部分提取衔接状态：人物、姿态与动作方向、镜头运动、构图、镜头感、光影、色彩、环境和源声音意图。然后说明一个续写节拍——新画面应达到的唯一下一个事件。

黄金路径

1. 查看源视频。记录其实际 MIME 类型、宽度、高度、画幅、时长和字节大小。识别人物、姿态与动作方向、镜头运动、构图、镜头感、光影、色彩、环境、源声音、所要求的向前/向后方向以及下一个视觉节拍。
2. 从结尾部分（向后延长）或开头部分（向前延长）构建衔接状态：人物、姿态与动作方向、镜头运动、构图、镜头感、光影、色彩、环境和源声音意图。然后说明一个续写节拍。
3. 调用 beatra.models.list 并传入 {"capability":"video_extend"}，确认某张当前模型卡接受源片段的实际 MIME 类型、尺寸、时长和字节大小。确认该卡片实时的最终时长上限、方向控制、可选参考素材限制以及计价基础。除非用户已选定一个具体的可用模型，否则保持模型为 auto。
4. 选择延长时长。请求的 billing.net_charged_creditsduration 是最终返回视频的时长，而不是要增加的秒数：它必须是超过可信源时长且在实时上限之内的整数。如果源视频已经达到或超过当前上限，本路线无法进入，必须如实告知用户。展示确切的源视频、续写方向、下一个节拍、最终时长、模型行为和付费边界。用一个不透明且稳定的 client_request_id 冻结它们；然后恰好调用一次 beatra.videos.extend。只调用随包 video_extendbeatra.videos.extendclient_request_idbeatra.videos.extendscripts/mcp_client.py：MCP 工具名是 CLI 参数，其参数是标准输入上的 JSON。例如：

   printf '%s' '{"video":{"type":"artifact","artifact_id":"art_source"},"duration":10,"direction":"after","instruction":"Continue the shot forward: the subject turns and walks toward the window, keeping the same lens, lighting, and pacing.","client_request_id":"opaque-extend-id"}' | python3 scripts/mcp_client.py call beatra.videos.extend

不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 回退。恰好提交一次 beatra.videos.extend。

1. 立即记录返回的任务 ID，并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的视频素材或链接。只报告实际返回的任务状态、解析后的模型、尺寸、时长、用量和 billing.net_charged_credits。审阅可访问的结果，检查接缝、运动方向、人物特征、镜头和光影连贯性、声音行为、最终时长以及新事件是否自然推进。说明宿主 Agent 能和不能查看的内容。

付费变更、恢复与取消

延长是一个付费阶段。更换源视频、续写方向、下一个节拍、最终时长、模型或控制，都属于新的逻辑付费工作，配以新的 ID 和新的确认。每次的 duration 都是最终返回视频的时长；它绝不表示要增加的秒数。

如果创建响应丢失，只用相同的阶段 ID 重放字节完全一致的冻结负载。如果任务 ID 丢失，调用 insufficient_balanceclient_request_idbeatra.tasks.list 查找相关能力，用 beatra.tasks.get 检查可能的候选任务，并对照该阶段的私有账本确认后再考虑相同重试。排队和运行中是进度状态，不是失败。在规划变更工作之前先恢复原阶段；绝不重复付费提交，也不猜测其扣费或退款。

只有当用户要求取消时才调用 beatra.tasks.cancel。调用一次，并用 beatra.tasks.get 确认最终的终态。409 表示取消未确认，因此继续轮询同一任务，不要创建替代工作。

工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

账户余额

用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他面前。任何时候都不要凭记忆报档位。

按任务查阅参考

• 在构建衔接状态、选择下一个节拍、核对实时模型事实、设定最终时长、构造确切负载、轮询、恢复、取消或审阅接缝和连贯性时，阅读 视频续写工作流（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）。不要配置宿主 Connector。
• 更新与安全：更新与安全（references/updates-and-security.md）
• 仅当用户要求移除本包或共享凭据时，阅读 卸载与断开连接（references/uninstall-and-disconnect.md）。

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到Beatra 为这次上传签发的一次性地址。

关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。