mcpField
V
veo3-1

veo3-1

github.com/delneg创意与媒体043 次安装35 周前更新
代码仓库

关于 veo3-1

veo3-1 是一项通过 Veo 3.1 模型按提示词生成视频的命令行技能。它支持选择时长和画面比例，也可仅输出视频 URL 而不下载文件。

主要功能

  1. 01按提示词生成视频
  2. 02六种可选模型版本
  3. 03支持 4、6 或 8 秒时长
  4. 04横屏与竖屏比例
  5. 05仅输出 URL

适用场景

  1. 01迭代提示词并制作短片草稿
  2. 02将最终视频保存到本地
  3. 03把生成的视频 URL 传给其他工具

安装

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

$npx skills add https://github.com/delneg/nano-banana-pro-skill-grsai-com --skill veo3-1

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

附带文件scripts/generate_video.py

详细介绍

Veo 3.1 视频生成

用法

在用户当前工作目录中运行（不要切换到技能目录）：

uv run scripts/generate_video.py --prompt "description" --filename "output.mp4" [--model MODEL] [--duration 4|6|8] [--aspect-ratio 16:9|9:16] [--api-key KEY]

使用 --url-only 跳过下载，仅输出视频 URL — 便于与其他工具串联：

uv run scripts/generate_video.py --prompt "description" --url-only [--model MODEL] [--duration 4|6|8]

工作流（草稿 → 最终版）

  1. 草稿 — --model veo3.1-fast --duration 4（成本最低，用于迭代提示词）
  2. 最终版 — --model veo3.1-pro-4k --duration 8（仅在提示词确定后使用）

模型选项

模型质量分辨率成本
veo3.1-fast（默认）快速720p最低
veo3.1-fast-1080p快速1080p低
veo3.1-fast-4k快速4K中
veo3.1-proPro720p中
veo3.1-pro-1080pPro1080p高
veo3.1-pro-4kPro4K最高

根据用户请求选择：

  • 未提及 / “草稿” / “快速” → veo3.1-fast
  • “1080p” / “HD” → veo3.1-fast-1080p
  • “4K” / “超高清” → veo3.1-fast-4k
  • “高质量” / “专业” → veo3.1-pro
  • “最佳质量” / “专业 4K” → veo3.1-pro-4k

时长与宽高比

  • 时长：4（草稿）、6、8（默认/最终版）秒
  • 宽高比：16:9（默认，横向）、9:16（纵向/移动端）

API 密钥

通过 --api-key 参数提供，或设置 GRSAI_API_KEY 环境变量。

故障排除

症状解决方法
Error: No API key provided.设置 GRSAI_API_KEY 环境变量，或传入 --api-key
HTTP 401API 密钥错误或已过期
Generation failed:内容审核未通过或输入无效；请改写提示词
超时使用更快的模型（veo3.1-fast）或缩短时长（--duration 4）
uv: command not found安装：curl -LsSf https://astral.sh/uv/install.sh | sh，然后重启终端

对于暂时性错误（HTTP 429、网络超时），请在 30 秒后重试一次。重试次数不要超过两次 — 请将问题告知用户。

文件名约定

格式：yyyy-mm-dd-hh-mm-ss-descriptive-name.mp4

  • 2025-11-23-14-23-05-sunset-mountains.mp4
  • 2025-11-23-15-30-12-dancing-robot-neon.mp4

输出

生成后始终会单独一行输出 VIDEO_URL: <full_url> — 使用此信息提取 URL 以便串联。

不使用 --url-only：将文件保存到磁盘并输出 Video saved: <path>。请向用户报告保存路径。不要打开或读取生成的视频。

使用 --url-only：仅输出生成信息和 VIDEO_URL: 行 — 不下载，也不需要 --filename。

与 qwen-3-5-plus-video-feedback 串联

从标准输出中提取 URL，并将其直接传递给反馈技能：

VIDEO_URL=$(uv run veo3-1/scripts/generate_video.py --prompt "..." --url-only | grep '^VIDEO_URL:' | cut -d' ' -f2)
uv run qwen-3-5-plus-openrouter/scripts/analyze_video.py --video-url "$VIDEO_URL" --prompt "Does this video match the prompt? Rate quality 1-10."

示例

uv run scripts/generate_video.py --prompt "A golden sunset over mountain peaks with birds flying" --filename "2025-11-23-14-23-05-sunset-draft.mp4" --model veo3.1-fast --duration 4

uv run scripts/generate_video.py --prompt "Close-up of waves crashing on rocky shore, slow motion, cinematic" --filename "2025-11-23-15-30-12-ocean-waves.mp4" --model veo3.1-pro-4k --duration 8 --aspect-ratio 16:9

评论

支持 Markdown