gflow-cli – Google Flow（Veo 和 Imagen）的命令行驱动程序

它是什么

• 一个基于 Python 的 CLI（以及可选的 MCP 服务器），让你从终端控制 Google 的 Flow 服务——即驱动 Veo 视频生成和 Imagen 文本转图像的用户界面。
• 它通过 Playwright 启动真实的 Chrome/Chromium 实例，登录你的 Google 账户，并自动化 Flow 界面。所有生成都在 Google 服务器上完成，并计入你自己的 Flow 积分余额。

主要功能

功能	使用方法
批量生成	在 shell 循环中使用 gflow image t2i "提示词" 或 gflow video t2v "提示词"；CLI 在发送前会本地记录每个项目，因此崩溃不会浪费积分。
可复用角色	gflow character create … 存储面部+身体参考，使同一个“人物”出现在多次生成中。
提示词工具	--tool creative-director 将简短提示词重写为 Google 推荐的 5 组件格式；你可以通过 docs/TOOLS.md 添加自定义工具。
管道与存储	输出默认到 $GFLOW_CLI_OUTPUT_DIR；你可以通过 GFLOW_CLI_STORAGE_URI 将其指向 S3、MinIO 或 GCS。
代理集成	四个入口点（gflow mcp run、gflow serve 等）向 AI 代理（如 Claude Code、Codex 或其他 LLM 驱动的工具）暴露相同的命令。
认证与会话处理	gflow auth login --browser chrome 打开真实的 Chrome 窗口进行首次登录；gflow auth renew 无需用户交互即可刷新持久化的 Playwright 配置文件。

为什么重要

• 为开发者和内容管道提供对 Web 界面提供的相同高质量 Veo/Imagen 模型的编程访问，而无需私有 Google SDK（官方 SDK 仍在等待中）。
• 保持成本透明：只有视频生成消耗积分；图像相关操作免费。
• 设计用于可重现性——每个批量项目在提交前都会本地保存，不同的退出代码表示界面漂移或其他故障。

安装快速入门

uv tool install gflow-cli                     # 推荐的安装方式
uv tool run --from gflow-cli playwright install chromium   # 一次性浏览器下载
gflow auth login --browser chrome            # 打开 Chrome，登录
gflow image t2i "a hot air balloon over Tokyo" # 首次生成

（你也可以使用 pip install gflow-cli。）

限制

• 依赖 带界面的 Chrome 会话；由于 Google 的反机器人检查阻止无头调用，目前还没有用于视频生成的纯 HTTP API。
• 项目处于 alpha 阶段——Google 端的界面变化可能破坏自动化，尽管作者提供快速补丁。
• 没有代理或指纹伪装——该工具旨在保持“不起眼”以避免账户标记，但不保证。

文档与社区

• 完整的用户指南、配置和故障排除文档位于 docs/ 下（例如 docs/USER_GUIDE.md）。
• 仓库包含路线图、变更日志和支持单人维护者的赞助页面。
• 鼓励提交问题，特别是那些可以用直接 REST 传输替代 Chrome 自动化层的贡献。

结论 gflow-cli 是一个真正的、面向生产的工具，用于从命令行自动化 Google Flow 的图像转视频和文本转图像功能，面向需要批量处理、可重现管道或与 AI 代理集成的开发者。