shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

AI视频续写与延长

给一条短视频在开头或结尾补上衔接画面——向后续写、向前补长、延长镜头、补全结尾，让画面自然延续。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

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. 选择延长时长。请求的 duration 是最终返回视频的时长，而不是要增加的秒数：它必须是超过可信源时长且在实时上限之内的整数。如果源视频已经达到或超过当前上限，本路线无法进入，必须如实告知用户。展示确切的源视频、续写方向、下一个节拍、最终时长、模型行为和付费边界。用一个不透明且稳定的 client_request_id 冻结它们；然后恰好调用一次 beatra.videos.extend。只调用随包 scripts/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。

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

付费变更、恢复与取消

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

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

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

按任务查阅参考

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

运行时与安全自动更新

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。在每个安装中静默地每 24 小时最多检查一次更高版本。更高版本可用时，不另行确认而自动安装。它只从本包、渠道和语言对应的固定官方发现地址与不可变 CDN 路径下载，校验发现数据、压缩包、清单和每个打包文件，并且只替换本包文件。

更新检查、下载、校验、替换、回滚和恢复失败时，现有安装仍可使用，原本请求的命令继续执行。更新失败不会授权另一项付费请求。设置会在此安装中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

--auto off 禁用静默检查，--auto on 恢复静默检查，--check 报告官方可用版本而不替换文件。