flow2api

Flow2API

❤️赞助商

✨ 核心特性

• 文生图 / 图生图
• 文生视频 / 图生视频
• ️ 首尾帧视频
• AT/ST自动刷新 - AT 过期自动刷新，ST 过期时自动通过浏览器更新（personal 模式）
• 余额显示 - 实时查询和显示 VideoFX Credits
• 负载均衡 - 多 Token 轮询和并发控制
• 代理支持 - 支持 HTTP/SOCKS5 代理
• Web 管理界面 - 直观的 Token 和配置管理
• 图片生成连续对话
• Gemini 官方请求体兼容 - 支持 generateContent / streamGenerateContent、systemInstruction、contents.parts.text/inlineData/fileData
• ✅ Gemini 官方格式已实测出图 - 已使用真实 Token 验证 /models/{model}:generateContent 可正常返回官方 candidates[].content.parts[].inlineData

快速开始

前置要求

• Docker 和 Docker Compose（推荐）

• 或 Python 3.8+

• 由于Flow增加了额外的验证码，你可以自行选择使用浏览器打码或第三发打码： 注册YesCaptcha并获取api key，将其填入系统配置页面YesCaptcha API密钥区域

• YesCaptcha 支持在管理页切换 type：RecaptchaV3TaskProxyless、RecaptchaV3TaskProxylessM1、RecaptchaV3TaskProxylessM1S7、RecaptchaV3TaskProxylessM1S9；当前默认推荐 M1S9，S7/S9 会强制提交 minScore 0.7/0.9。

• 默认 docker-compose.yml 建议搭配第三方打码（yescaptcha/capmonster/ezcaptcha/capsolver）。 如需 Docker 内有头打码（browser/personal），请使用下方 docker-compose.headed.yml。

• 自动更新st浏览器拓展：Flow2API-Token-Updater

方式一：Docker 部署（推荐）

标准模式（不使用代理）

# 克隆项目
git clone https://github.com/TheSmallHanCat/flow2api.git
cd flow2api

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

说明：Compose 已默认挂载 ./tmp:/app/tmp。如果把缓存超时设为 0，语义是“不自动过期删除”；若希望容器重建后仍保留缓存文件，也需要保留这个 tmp 挂载。

WARP 模式（使用代理）

# 使用 WARP 代理启动
docker-compose -f docker-compose.proxy.yml up -d

# 查看日志
docker-compose -f docker-compose.proxy.yml logs -f

Docker 有头打码模式（browser / personal）

适用于你有虚拟化桌面需求、希望在容器里启用有头浏览器打码的场景。
该模式默认启动 Xvfb + Fluxbox 实现容器内部可视化，并设置 ALLOW_DOCKER_HEADED_CAPTCHA=true。
仅开放应用端口，不提供任何远程桌面连接端口。 personal 内置浏览器现在默认按有头模式启动；如需临时切回无头，可额外设置环境变量 PERSONAL_BROWSER_HEADLESS=true。

# 启动有头模式（首次建议带 --build）
docker compose -f docker-compose.headed.yml up -d --build

# 查看日志
docker compose -f docker-compose.headed.yml logs -f

• API 端口：8000
• 进入管理后台后，将验证码方式设为 browser 或 personal

方式二：本地部署

# 克隆项目
git clone https://github.com/TheSmallHanCat/flow2api.git
cd flow2api

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动服务
python main.py

首次访问

服务启动后,访问管理后台: http://localhost:8000,首次登录后请立即修改密码!

• 用户名: admin
• 密码: admin

监控接口

• GET /health：公开健康检查，返回服务是否存活、活跃 Token 数、即将过期 Token 数、已过期 Token 数、429 禁用数等摘要
• GET /metrics：Prometheus 指标接口
• GET /api/tokens：管理接口，返回 at_expires、at_expired、at_expiring_within_1h、ban_reason、consecutive_error_count 等 Token 状态

Prometheus 可直接抓 /metrics。如果部署到 Kubernetes，建议只在集群内抓取，并在 Ingress/Gateway 层单独限制 /metrics 的外部访问。

模型测试页面

访问 http://localhost:8000/test 可打开内置的模型测试页面，支持：

• 按分类浏览所有可用模型（图片生成、文/图生视频、多图视频、视频放大等）
• 输入提示词一键测试，流式显示生成进度
• 图生图 / 图生视频场景支持上传图片
• 生成完成后直接预览图片或视频

支持的模型

图片生成

视频生成

文生视频 (T2V - Text to Video)

⚠️ 不支持上传图片

首尾帧模型 (I2V - Image to Video)

支持1-2张图片：1张作为首帧，2张作为首尾帧

自动适配：系统会根据图片数量自动选择对应的 model_key

• 单帧模式（1张图）：使用首帧生成视频
• 双帧模式（2张图）：使用首帧+尾帧生成过渡视频
• veo_3_1_i2v_lite_* 仅支持 1 张 首帧图片
• veo_3_1_interpolation_lite_* 仅支持 2 张 首尾帧图片

多图生成 (R2V - Reference Images to Video)

️ 支持多张图片

2026-03-06 更新

• 已同步上游新版 R2V 视频请求体
• textInput 已切换为 structuredPrompt.parts
• 顶层新增 mediaGenerationContext.batchId
• 顶层新增 useV2ModelConfig: true
• 横屏 / 竖屏 R2V 模型共用同一套新版请求体
• 横屏 R2V 的上游 videoModelKey 已切换为 *_landscape 形式
• 根据当前上游协议，referenceImages 当前最多传 3 张

视频放大模型 (Upsample)

这些模型不是直接调用上游 upsampler key，而是先用对应的 Veo 3.1 普通模型生成视频，再提交 1080P/4K 放大请求。

API 使用示例（需要使用流式）

除了下方 OpenAI-compatible 示例，服务也支持 Gemini