内容
# ⚡ Flow 代理
适用于 Google Flow 图片/视频生成的 CLI、OpenAI 兼容 API、Chrome 扩展和 MCP 服务器。
[](https://github.com/kodelyx/flow-agent/releases)
[](https://github.com/kodelyx/flow-agent/actions/workflows/build.yml)
## 功能
- 文本到图片和基于参考的图片生成
- 文本到视频、图片到视频、参考到视频和视频编辑
- 4/6/8/10 秒视频生成
- OpenAI 兼容的 HTTP API
- 用于完全控制的 CLI
- 带有状态、积分、模型、历史、生成、上传、URL 下载和视频编辑的 MCP v2
- 使用您登录的 Google Flow 会话的 Chrome 扩展桥接
- 默认图片模型为 `gem_pix_2` （专业版）
## 从源代码安装
要求：Python 3.10+、Chrome、Google Flow 访问权限和 `uv` 包管理器。
```bash
git clone https://github.com/kodelyx/flow-agent.git
cd flow-agent/flow-agent
uv tool install --force .
```
启动后端：
```bash
flow serve
```
## Chrome 扩展
1. 打开 `chrome://extensions`。
2. 启用 **开发者模式**。
3. 点击 **加载解压**。
4. 选择 [`flow-extension`](flow-extension) 文件夹。
5. 打开 <https://labs.google/fx/tools/flow>，登录并保持页面打开。
6. 使用 `flow status` 验证。
扩展特定说明：[flow-extension/README.md](flow-extension/README.md)。
## CLI
```bash
flow status
flow credits
flow image "一个带有霓虹灯的电影城市" --model gem_pix_2 --aspect landscape
flow image "重新设计这个角色" --ref character.png --count 2
flow video "一条龙在山脉上空飞行" --aspect landscape --duration 8
flow video "角色开始行走" --start character.png
flow video "场景之间切换" --start first.png --end last.png
flow upload clip.mp4
flow edit "转换为黑暗动漫风格" --media-id MEDIA_ID --video-file clip.mp4
```
运行 `flow <command> --help` 获取每个选项。
## MCP v2
```json
{
"mcpServers": {
"flow": {
"command": "flow-mcp",
"args": []
}
}
}
```
可用工具：
- `get_flow_status`
- `get_flow_credits`
- `list_flow_models`
- `get_flow_history`
- `generate_flow_image`
- `generate_flow_video`
- `upload_flow_media`
- `download_media_from_url`
- `edit_flow_video`
`download_media_from_url` 接受直接或签名的图片/视频链接，将它们保存在本地，并可选择上传到 Flow。
更多客户端配置：[MCP.md](MCP.md)。
## HTTP API
默认基准 URL：`http://127.0.0.1:8001`
| 端点 | 目的 |
|---|---|
| `GET /health` | 后端和扩展健康状态 |
| `GET /v1/models` | 可用模型 |
| `GET /v1/credits` | 连接账户积分 |
| `GET /v1/history` | 生成媒体历史 |
| `POST /v1/images/generations` | 生成图片 |
| `POST /v1/videos/generations` | 生成视频 |
| `POST /v1/upload` | 上传图片/视频参考 |
## 默认模型
```env
IMAGE_MODEL=gem_pix_2
```
可用别名：
- `harbor_seal` / `lite`
- `narwhal` / `standard`
- `gem_pix_2` / `pro`
## 项目布局
```text
flow-agent/
├── flow-agent/ # CLI、API、MCP 和 Flow 生成后端
│ ├── specs/ # PyInstaller 构建规范
│ ├── scripts/ # 设置和卸载脚本
│ ├── requirements/ # 依赖项列表
│ └── .env # 用户可更改的设置
├── flow-extension/ # Chrome 扩展桥接
├── .github/workflows/ # 跨平台发布构建
├── MCP.md # MCP 客户端设置
└── README.md
```
## 安全
- 永远不要提交浏览器 cookie、GitHub 令牌、隧道凭证或生成的私有媒体。
- 仓库忽略旧版 `config.env`、`github-token`、`cloudflared/`、输出、日志和构建工件。
- 在将 API 公开到 localhost 以外之前，请设置 `SERVER_API_KEY`。
## 许可证
按照 Google 的适用条款使用 Google Flow 和生成的媒体。
