Veo

Google Veo 视频生成技能评估

核心用法

本技能通过命令行脚本封装 Google Gemini API 的 Veo 视频生成能力，支持 Veo 2.0、Veo 3.0 及 Veo 3.1 等多个模型版本。用户通过自然语言描述视频内容，即可生成 8 秒（默认）至更长时长的 MP4 视频片段。

基础调用格式为：

uv run scripts/generate_video.py --prompt "描述" --filename "输出.mp4"

可选参数涵盖时长（--duration）、画幅比例（--aspect-ratio，支持 16:9、9:16、1:1）及模型选择（--model）。官方推荐 veo-3.1-generate-preview 以获得最佳画质，若追求速度可选用 veo-3.0-fast-generate-001。

显著优点

• 官方模型背书：Google 原生 Veo 系列模型，视频质量业界领先，Veo 3.1 在画质、连贯性与物理模拟方面表现突出
• 多版本灵活切换：提供质量优先与速度优先两种策略，适应不同场景需求
• 画幅适配完善：原生支持横屏、竖屏、方形三种主流比例，便于社交媒体分发
• Clawdbot 原生集成：脚本输出 MEDIA: 标记行，支持聊天客户端自动附件渲染，无需手动下载回传
• 轻量依赖：仅需 uv 运行时与单一 API Key，无复杂本地环境配置

潜在局限与风险

• 成本门槛：Google Veo API 为付费服务，高频或长时长生成将产生显著费用
• 预览版稳定性：推荐模型 veo-3.1-generate-preview 尚处预览阶段，API 行为或定价可能调整
• 内容审核：生成内容受 Google 安全策略约束，敏感主题可能触发过滤或拒绝
• 时长上限：即使 Veo 3.1 也存在最大时长限制（文档未明确具体秒数），难以一次性生成长视频
• 依赖外部密钥：必须配置有效 GEMINI_API_KEY，密钥泄露将导致直接经济损失

适合人群

• 内容创作者：快速生成短视频素材、概念验证或社交媒体内容
• 设计师与产品经理：制作原型视频、动态演示，降低沟通成本
• 开发者：将视频生成集成至自动化工作流或批处理管道

常规风险

建议启用 API Key 配额监控与速率限制，避免意外超支；预览版模型不宜用于关键生产环境。

核心用法

Veo Skill 是 Google Veo 视频生成 API 的封装工具，通过命令行快速生成 AI 视频。基础用法仅需提供文本提示词：

uv run scripts/generate_video.py --prompt "夕阳下的海边漫步" --filename "sunset.mp4"

关键参数：

• --duration / -d：视频时长（默认 8 秒，Veo 3.1 支持更长）
• --aspect-ratio / -a：画面比例（16:9、9:16、1:1）
• --model：模型版本选择，推荐 veo-3.1-generate-preview 获得最佳画质

API 配置：通过 GEMINI_API_KEY 环境变量或 ~/.clawdbot/clawdbot.json 配置文件设置密钥。

特色功能：输出自动打印 MEDIA: 标记，Clawdbot 支持平台可直接内嵌预览生成的 MP4 视频。

---

显著优点

1. 官方 SDK 保障：基于 Google 官方 google-genai SDK，API 调用规范，TLS 1.3 加密传输
2. 模型版本灵活：支持 Veo 2.0、3.0、3.1 多版本切换，3.1 预览版画质与时长显著提升
3. 零依赖负担：单脚本架构（约 180 行），仅依赖官方 SDK，无冗余第三方库
4. 跨平台兼容：通过 uv 运行器管理 Python 环境，避免本地依赖冲突
5. 输出格式通用：标准 MP4 格式，兼容主流剪辑软件和社交平台

---

潜在局限

• 成本敏感：Google Veo API 按视频时长计费，高频使用成本较高
• 内容审核：生成内容受 Google AUP（可接受使用政策）约束，敏感主题可能被拦截
• 无本地推理：完全依赖云端 API，需稳定网络，无法离线使用
• 精细控制有限：不支持逐帧关键帧控制或复杂镜头运动参数微调
• 来源追溯缺失：当前无公开 GitHub 仓库，代码审查透明度受限

---

适合人群

| 用户类型 | 使用场景 |

|---------|---------|

| 内容创作者 | 快速生成视频素材、社交媒体内容原型 |

| 营销团队 | 广告创意预览、A/B 测试视频批量生成 |

| 设计师 | 概念可视化、动态 mood board 制作 |

| 开发者 | 集成到自动化工作流，如 CI/CD 生成演示视频 |

---

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| API 密钥泄露 | 环境变量方式存在终端历史记录泄露可能 | 使用密钥管理服务（如 1Password CLI、AWS Secrets Manager） |

| 输出版权问题 | AI 生成内容的版权归属因地区/用途而异 | 商用前确认 Google 服务条款及当地法规 |

| 生成内容违规 | 违反 Google AUP 可能导致账号封禁 | 避免生成暴力、欺诈、深度伪造等敏感内容 |

| 成本失控 | 长时长、高分辨率视频费用累积快 | 设置预算警报，先用 3.0-fast 模型测试 |

| 模型预览稳定性 | `veo-3.1-generate-preview` 为预览版 API | 生产环境建议监控可用性，准备降级方案 |