veotools (Frontboat)

车辆

使用Google Veo编排多场景视频的Python工具包。处理场景规划、视频渲染、重叠感知拼接和进度跟踪。

特性

• 一个命令故事 –将想法转化为故事板，渲染剪辑，并提供拼接视频
• 双子座规划 –生成具有一致角色和对话的电影镜头列表
• VEO 3.1支持 –完整的SDK访问，具有最新的Veo 3.1功能，包括参考图像、视频扩展和帧插值
• 音频保留缝合 –FFmpeg管道保持完美的音频对齐
• Python优先 –清洁API，用于编程视频生成工作流

安装

pip install veotools # CLI and SDK
pip install "veotools[mcp]" # Add MCP server support
pip install -e ".[dev,mcp]" # Contribute / run tests locally

# Environment (choose your models / region access)
export GEMINI_API_KEY="your-gemini-key"

# Daydreams Router support (optional)
export VEO_PROVIDER="daydreams"
export DAYDREAMS_API_KEY="sk-router-..."
# export DAYDREAMS_BASE_URL="https://api-beta.daydreams.systems/v1" # override if needed

集 VEO_PROVIDER=daydreams 通过白日梦路由器代理提示和视频作业。省略该标志（或将其设置为 google)直接调用谷歌GenAI SDK。

快速启动（CLI）

# Plan + render + stitch in one command
veo plan-run \
  --idea "N64 Japanese retro explainer about the x402 protocol" \
  --save-plan output-plans/x402.json \
  --execute-model veo-3.1-generate-preview \
  --seed-last-frame --seed-offset -0.25

输出土地 output/:

• output-plans/x402.json –Gemini故事板（如果省略，则可选 --save-plan).
• output/videos/video_*.mp4 –个人剪辑。
• output/videos/stitched_*.mp4 –带音频的最终缝合大师。

您还可以执行现有计划：

veo plan-execute --plan output-plans/x402.json --model veo-3.1-generate-preview --seed-last-frame

…并仅生成故事板：

veo plan --idea "Retro travel vlog" --scenes 4 --save output-plans/vlog.json --json

快速入门（Python）

import veotools as veo

veo.init()  # sets up logging + validates GEMINI_API_KEY

plan = veo.generate_scene_plan(
    "N64 Japanese retro explainer about the x402 protocol",
    number_of_scenes=4,
    additional_context="Keep the tone energetic and educational",
)

result = veo.execute_scene_plan(
    plan,
    model="veo-3.1-generate-preview",
    auto_seed_last_frame=True,        # feed each clip the previous clip's final frame
    seed_frame_offset=-0.25,          # extract the seed frame 0.25s before the end
)

print("Rendered clip files:")
for clip in result.clip_results:
    print(" -", clip.path)

if result.final_result:
    print("Final stitched video:", result.final_result.path)

CLI概述

• veo plan –生成/保存Gemini故事板（结构化JSON）。
• veo plan-execute –渲染片段+缝合现有平面。
• veo plan-run –一次性计划和执行（见快速入门）。
• veo generate / veo continue –用于临时剪辑的低级Veo助手。
• veo list-models, veo preflight –环境+模型诊断。

跑 veo --help 查看完整的旗帜描述。

Python API映射

Veo 3.1功能

from veotools import extend_video, generate_with_reference_images, generate_with_interpolation
from pathlib import Path

# Extend an existing video (7-second extensions, up to 20x)
result = extend_video(
    video_path=Path("input.mp4"),
    prompt="Continue with a dramatic reveal",
    model="veo-3.1-generate-preview"
)

# Generate with reference images for character/scene consistency
result = generate_with_reference_images(
    prompt="A character walking through the forest",
    reference_images=["char_ref.jpg", "forest_ref.jpg"],
    model="veo-3.1-generate-preview"
)

# Interpolate between first and last frames
result = generate_with_interpolation(
    first_frame=Path("start.jpg"),
    last_frame=Path("end.jpg"),
    prompt="Smooth transition showing time passing",
    model="veo-3.1-generate-preview"
)

型号/安全注意事项

• Veo 3.1文本/扩展名默认为 person_generation="allow_all"；图像/插值/参考默认为 allow_adult.
• Veo 3.0文本默认为 allow_all；图像/视频种子默认为 allow_adult.
• 使用 list_models(include_remote=True) 发现您的帐户可以访问的Veo变体（稳定ID： veo-3.1-generate-001, veo-3.1-fast-generate-001, veo-3.0-generate-001等等）。

支持的型号

存储布局

• output/videos/ –所有渲染片段、缝合交付成果和中间资产。
• output/frames/ –提取的静止图像（包括启用时的自动种子帧）。
• output/ops/ –MCP作业记录、缓存的模型列表等。
• 覆盖 VEO_OUTPUT_DIR 或将自定义基路径传递给 StorageManager.

例子

• examples/plan_run.py –完整的想法→ plan → 渲染工作流程约30行。
• examples/text_to_video.py –最小文本到视频剪辑生成器。
• examples/bridge_story.py –用流利的语言构建一个三场景故事 Bridge API

贡献与测试

欢迎拉取请求！拜托：

1. 安装方法： pip install -e ".[dev,mcp]".
2. 跑 pytest （该套件依赖于mock；没有实时API调用）。
3. 当行为发生变化时，更新文档/示例。

MCP用户可以使用以下命令启动服务器 veo-mcp 或 python -m veotools.server.mcp_server.