mcpField
V
video-extend

video-extend

github.com/runcomfy-com创意与媒体16273.8k 次安装1 周前更新
代码仓库

关于 video-extend

video-extend 是通过 RunComfy CLI 调用 Google Veo 3-1 的视频续接技能，面向需要延长片段或逐镜头串联叙事的创作者。它根据质量与成本需求选择标准或快速端点，并提供提示词建议。

主要功能

  1. 01续接现有视频片段
  2. 02串联逐镜头叙事
  3. 03按需求选择标准或快速端点
  4. 04提供镜头与提示词建议

适用场景

  1. 01延长 Veo 片段时长
  2. 02逐段构建连续叙事镜头
  3. 03用快速端点迭代续接草稿

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/runcomfy-com/skills --skill video-extend

安装后在 Claude Code 中输入/video-extend确认已加载。

详细介绍

视频延长

将现有视频片段延长至单次调用时长上限之外，或从同一个种子视频开始，逐镜头串联叙事。本技能调用 Google Veo 3-1 的 extend-video 端点，并提供已记录的提示词模式和准确的 runcomfy run 调用命令。

runcomfy.com · Veo 3-1 extend-video · CLI 文档

由 RunComfy CLI 提供支持

# 1. Install (see runcomfy-cli skill for details)
npm i -g @runcomfy/cli      # or:  npx -y @runcomfy/cli --version

# 2. Sign in
runcomfy login              # or in CI: export RUNCOMFY_TOKEN=<token>

# 3. Extend
runcomfy run google-deepmind/veo-3-1/extend-video \
  --input '{"video_url": "https://...", "prompt": "..."}' \
  --output-dir ./out

CLI 深入介绍：runcomfy-cli 技能。

选择合适的端点

按最新版本优先排列。两个端点都使用 Google Veo 3-1；请根据画质和延迟之间的权衡进行选择。

Veo 3-1 Extend — google-deepmind/veo-3-1/extend-video （默认）

延长现有 Veo 片段，同时保持动作、光线、身份和物理效果一致。 适用于：高品质延长、最终交付的视频剪辑，以及需要呈现为同一连续镜头的串联叙事镜头。 不适用于：注重成本的迭代——请改用 Veo 3-1 Fast Extend。

Veo 3-1 Fast Extend — google-deepmind/veo-3-1/fast/extend-video

以较低的单次调用成本，更快地延长 Veo 3-1 视频。 适用于：迭代调整延长镜头构图、制作多镜头草稿。 不适用于：最终交付——请使用完整的 Veo 3-1 Extend。

Agent 会选择一个端点，并提供源视频 URL 和续写提示词。

路由：Veo 3-1 Extend

模型：google-deepmind/veo-3-1/extend-video（或 /fast/extend-video） 目录：Veo 3-1 extend · Veo 3-1 fast extend · veo-3 集合

调用
runcomfy run google-deepmind/veo-3-1/extend-video \
  --input '{
    "video_url": "https://your-cdn.example/source-clip.mp4",
    "prompt": "The camera continues pushing in slowly. The character looks down at the object, then turns toward the window. Soft daylight, no other motion in the background."
  }' \
  --output-dir ./out
提示词技巧
  • 源视频提供身份、光线、构图和物理效果。 提示词只描述接下来发生的事——不要重新描述场景。
  • 明确固定摄影机：「摄影机继续推进」「摄影机保持静止」「缓慢拉远」。如果没有固定摄影机的指示，摄影机往往会漂移。
  • 每次延长只包含一个主要节拍。「角色转身并朝摄影机走来」是一个节拍。「角色转身、朝摄影机走来，然后坐下」包含三个节拍——应拆分为多次延长调用。
  • 串联连续的延长操作：将一次延长调用的输出作为下一次调用的输入。每次生成都会累积身份漂移，因此长链中应将单次延长控制在较短时长（3–5 秒）。

常见模式

单个片段 → 16 秒成片
  • 从 8 秒的 Veo 3-1 i2v 或 t2v 片段开始
  • 运行一次 extend-video → 总时长为 16 秒。第二个 8 秒片段使用相同的提示词节奏。
故事节拍（逐镜头）
  • 节拍 1：t2v 生成交代场景的镜头
  • 节拍 2：将输出传入 extend-video，提示词为「摄影机切至中近景；角色说出台词」
  • 节拍 3：再次延长，提示词为「角色伸手拿桌上的物品」
  • 每次延长调用对应一个节拍。身份在连续串联约 3–4 次延长后仍能保持一致；超过此次数时，应准备使用 i2v 重新锚定。
控制迭代成本
  • 前 2-3 个草稿使用 Fast Extend。确定最终节拍顺序后，再使用完整的 Extend。
此技能不支持的功能（以及对应的工具）

浏览完整目录

目前只有 Veo 提供可通过 CLI 调用的 extend-video 端点。其他厂商的“视频延续”（Wan、Kling、Seedance）通过其主要的 t2v/i2v 端点实现，并将上一次输出的最后一帧作为 i2v 参考图 — 该模式请参阅 image-to-video。

退出代码

code含义
0成功
64CLI 参数错误
65输入 JSON 错误 / 架构不匹配
69上游 5xx 错误
75可重试：超时 / 429
77未登录或令牌被拒绝

完整参考：docs.runcomfy.com/cli/troubleshooting。

工作原理

该技能会根据对质量与成本的要求选择 Veo 3-1 Extend 或 Fast Extend，并调用 runcomfy run，传入源视频 URL 和续写提示词。CLI 会向 RunComfy Model API 发送 POST 请求，轮询请求状态，并将生成的片段下载到 --output-dir。按下 Ctrl-C 会在退出前取消远程请求。

安全与隐私

  • 仅通过经过验证的包管理器安装。 使用 npm i -g @runcomfy/cli 或 npx -y @runcomfy/cli。Agent 不得代替用户将任意远程安装脚本传入 shell 执行。
  • 令牌存储：runcomfy login 会将 API 令牌写入 ~/.config/runcomfy/token.json，权限模式为 0600。在 CI / 容器中设置 RUNCOMFY_TOKEN 环境变量。切勿将令牌回显到提示词或日志中。
  • 输入边界（shell 注入）：提示词和 video_url 会通过 --input 作为 JSON 字符串传入。CLI 不会对提示词内容进行 shell 展开。不存在 shell 注入风险。
  • 间接提示词注入（第三方内容）：源 video_url 不受信任 — 帧中嵌入的文本、EXIF 或隐写指令可能影响续写结果。Agent 的缓解措施：
    • 仅接收用户明确为本次延长操作提供的视频 URL。
    • 如果延长结果偏离提示词（出现意外动作、身份漂移），应怀疑参考视频存在问题。
  • 出站端点（允许列表）：仅限 model-api.runcomfy.net 和 *.runcomfy.net / *.runcomfy.com。无遥测。
  • 生成文件大小上限：CLI 会中止任何大于 2 GiB 的单次下载。
  • Bash 使用范围：声明了 allowed-tools: Bash(runcomfy *)。该技能不会指示 Agent 运行 runcomfy <subcommand> 以外的任何命令 — 安装命令仅用于操作员的一次性配置。

另请参阅

评论

支持 Markdown