GPT2Image-Pro

面向生图业务的 SaaS 平台
套餐能力矩阵、Web + Codex 智能路由、4K Agent 生图和 OpenAI 兼容 API。

QQ 交流群：375682052 · 生产部署 · 部署方式 · 常用命令

GPT2Image-Pro 主应用位于 apps/web，共享能力位于 packages/*。README 保留项目入口和部署骨架；接口字段、后端调度、计费、Agent、队列、Sub2API、管理员权限等细节以站内系统文档为准：

• 公开系统文档：/docs/system
• 登录后台文档：/dashboard/backend-help
• QQ 交流群：375682052

项目定位

GPT2Image-Pro 的目标不是做一个单机版生图 Demo，而是把 ChatGPT Web、Codex/Responses、OpenAI 兼容外接 API 等账号能力统一接入账号池，转换成可运营、可计费、可分套餐交付的页面服务和 API 服务。它既适合个人把自己的账号整理成稳定的自用生图入口，也适合团队把账号池能力包装成面向用户的 SaaS 平台。

项目围绕三个问题设计：

• 账号如何转成服务：把 Web AT、Codex/Responses 账号、Sub2API 来源账号、外接 API 和 Adobe Firefly 后端纳入统一后端池，提供页面生图、Chat/Agent 和 OpenAI 兼容 API。
• 服务如何可控交付：通过套餐能力矩阵、API Key 额度、分组倍率、并发队列、审核策略、积分流水和 SLA 监控控制不同用户能用什么、能用多少、按什么价格用。
• 生图如何更像产品能力：同时支持普通生图、图生图、批量、瀑布流、Chat 上下文生图和 Codex 风格 Agent 迭代，而不是只暴露单个裸接口。

核心特性

1. 套餐能力细化，方便客户分层

传统生图面板通常只区分“能不能用”和“还有多少额度”。GPT2Image-Pro 把套餐拆成可配置的能力矩阵，管理员可以按套餐控制：

• 页面功能：文生图、图生图、逐行批量、瀑布流、Chat、Agent。
• API 权限：/v1/images/generations、/v1/images/edits、/v1/chat/completions、/v1/responses、Agent API、额度查询等。
• 资源限制：上传图片大小、单次上传数量、批量生成数量、用户并发、API Key 独立额度。
• 计费规则：月赠积分、Chat 每轮基础价、Agent 每轮基础价、按量积分包价格、分组倍率、尺寸价格曲线。
• 风控策略：文本审核、图片审核、审核失败扣费规则、关闭提示词优化权限、审核拦截策略。

这样可以把普通用户、高级用户、API 用户、内部测试用户拆成不同产品层级。高级套餐可以包含低级套餐能力，同时再放开更高并发、更大上传、更低倍率或 Agent/API 能力。

2. Web + Codex + 外接 API 统一账号池，智能路由

平台支持把不同来源的生图能力放进统一调度层：

• ChatGPT Web 账号：适合 Web 能力、低成本或 Web-first 场景。Web 生图原生分辨率不可严格控制，但可由「分辨率超分」自动补足到目标尺寸（含接近 4K，见特性 5）。
• Codex/Responses 账号：适合 Responses 语义、图片工具、Chat/Agent、多轮上下文和更高分辨率输出。
• OpenAI 兼容外接 API：适合接入第三方网关或用户自己的上游服务，平台尽量按 OpenAI 风格透传。
• Mixed 分组：可把 Web、Codex 和外接 API 放进同一业务分组，按尺寸、请求类型、force web 范围、优先级、权重、冷却和错误状态自动选择后端。

调度层内置账号状态管理：成功/失败统计、限流、冷却、过载、无效凭据、并发占用、分组倍率和错误记录。对外 API 和页面请求都可以复用这套调度能力，使账号不只是“登录态”，而是可被产品化管理的服务资源。

3. Codex 风格 Agent 生图，并可 API 接出

页面 Agent 不是简单把提示词丢给图片接口，而是尽量模拟 Codex 式工作流：

• 支持联网搜索、工具调用、任务卡展示、自动多轮迭代和最终图片生成。
• 可按轮收取 Agent 基础积分，最终图片再按尺寸、数量、审核和分组倍率计费。
• 可结合 Codex/Responses 后端生成高分辨率图片，包括 4K 场景。
• 可通过旗舰版能力把 Agent 生图作为 API 暴露给第三方产品。

Chat 模式和 Agent 模式分开：Chat 更适合用户主动对话和上下文创作；Agent 更适合自动查资料、生成、判断、继续迭代的任务型流程。

4. Adobe Firefly 图像/视频直连后端

平台内置 Adobe Firefly 直连后端，把 Adobe 侧的图像和视频能力也产品化进同一调度层：

• 直连出图：直连 Adobe Firefly 出图，支持图像族（gpt-image-2/1.5 与 nano-banana 系列）与视频族（sora2/veo31/kling 等 7 族）；经 Go TLS 旁路过风控，自管 Adobe 账号/token 池，不依赖外部进程。
• 挂入分组兜底：作为“特殊 firefly account 成员”挂入现有分组，按优先级参与调度；配低优先级即作兜底层，在 Web/Codex 限流或耗尽时顶上。
• 强制路由与兼容转换：force_firefly 标志或 firefly-* 模型名可强制走 Adobe；收到后把站内标准请求兼容转换成 Firefly 格式（尺寸→比例/分辨率、质量→detailLevel、默认族 gpt-image-2、图生图 referenceBlobs），不支持的参数静默忽略。
• 计费与监控：视频 30 积分/秒 × 时长 × 模型族倍率；图像/视频每模型族倍率均可配；全局状态监控含 Adobe 健康块与独立视频统计。
• 账号导入与换号重试：直连模式自管 Adobe cookie 账号池，后台支持单条与批量导入（粘贴多份 cookie，逐条刷新验证、按 Adobe 身份去重）；同一后端（伪账号）内出图遇 429/配额/鉴权会自动轮换账号重试，本后端账号轮完才交外层切其它 Adobe 后端。导出 cookie 用仓库附带的 tools/adobe-cookie-exporter/（Chrome/Edge MV3 浏览器扩展，思路参照原 adobe2api 项目）：登录 firefly.adobe.com 后一键导出 Adobe/Firefly 登录 cookie（含 HttpOnly 会话 cookie），导出的 JSON 与后台导入框直接兼容。

路由与兜底细节见 docs/adobe-firefly-routing.md，兼容转换细节见 docs/adobe-firefly-compat.md。

5. 出图分辨率超分与高清修复

平台在最终图落库前做两道相互独立的服务端后处理，解决「上游返回图分辨率不达标、画质偏软」——尤其 Web、Codex 等后端不严格遵循请求尺寸：

• 分辨率超分（自动）：当最终图较长边低于请求目标的 2/3 时，用 Real-ESRGAN（general-x4v3）放大 4 倍，再按比例缩到目标边长（fit: inside，不裁剪、不改宽高比）；若上游图极小、放大 4 倍后仍不足目标，则以放大结果为准、不做模糊拉伸（此时输出可能仍略小于目标）。因此 Web / Codex 出图也能自动补足到接近 4K 的目标分辨率。CPU 推理，单张 512→2048 约 1-2 秒，按 tile 分块限制内存峰值、并发执行；仅对最终图触发，由系统设置 IMAGE_SUPER_RESOLUTION_ENABLED 控制（默认关）。
• 高清修复（手动）：与超分独立的可选增强。用户在创作页勾选「高清修复」或 API 传 hd_repair=true 时，用 SCUNet 对最终图做盲复原（去噪、去压缩块、增强质感，不改分辨率）。CPU 推理较重（512 约 11 秒、1024 约 35 秒），服务端全局串行排队（同时最多一个修复推理）以防并发打满机器，较长边超过 2048 的超大图跳过；由系统设置 IMAGE_RESTORATION_ENABLED 控制（默认关），需用户手动勾选。
• 组合与容错：两者可叠加，顺序为「先修复（原分辨率、省算力）再超分（放大到目标）」；均不裁剪、不改宽高比，任一步失败自动回退原图、不阻断出图。

能力概览

• 页面创作：文生图、图生图、逐行批量、瀑布流、Chat 生图、Agent 自动迭代、图库、历史记录、参考图引用和发送到其他创作入口。
• OpenAI 兼容 API：/v1/chat/completions、/v1/images/generations、/v1/images/edits、/v1/images/{task_id}、/v1/responses、/v1/agents/images、/v1/models、/v1/credits。
• 异步图片任务：图片生成和编辑接口支持同步返回，也支持 async、callback_url 和任务查询。
• 账号池与调度：Web 账号、Codex/Responses 账号、外接 API、Adobe Firefly 后端、mixed 分组、优先级、权重、并发、排队、冷却、错误标记、分组倍率和 Sub2API 同步任务。
• Adobe Firefly 后端：图像（gpt-image-2/1.5、nano-banana 系列）和视频（sora2/veo31/kling 等 7 族）直连出图，挂入分组按优先级兜底，支持 force_firefly 强制路由、站内请求兼容转换、按模型族倍率计费和独立视频统计。
• 分辨率超分与高清修复：最终图自动超分校准到目标分辨率（Real-ESRGAN，Web/Codex 也可补足到接近 4K），并可选 SCUNet 高清修复（盲复原、手动开、服务端串行）。
• 计费与套餐：能力矩阵、套餐订阅、按量积分包、API Key 独立额度、尺寸价格曲线、Chat/Agent 轮次价格、积分流水和用户侧计费明细。
• 运营后台：三级管理员、用户管理、公告、工单红点、状态监控、SLA、历史错误、照片销毁、内置定时任务和系统设置。
• 注册机辅助工具：仓库附带 注册机/，可按示例配置批量生成本项目可导入的 ChatGPT Web AT；在合适的代理和邮箱服务配置下，可支撑数百并发生成 Web AT。该工具是账号准备辅助，不是 Web 应用运行必需组件。

界面预览

套餐能力矩阵	积分计价曲线
系统设置	用户管理
Adobe 账号管理（Admin · Adobe 后端）

配置来源

• 运行时优先读取数据库 system_setting，未配置时回退环境变量。
• 首次启动会初始化缺失的非密钥默认配置，包括套餐能力矩阵、套餐价格、按量积分包、审核和后端冷却默认值；已有数据库配置不会被覆盖。
• 默认启用自用模式：公开注册关闭；如果没有超管，启动时会创建本地超管并随机生成密码。初始密码写入启动日志和 .gpt2image/super-admin-credentials.txt，可用 GPT2IMAGE_BOOTSTRAP_CREDENTIALS_PATH 覆盖路径。

本地开发

git clone <repo-url>
cd GPT2Image-Pro
pnpm install
cp .env.example .env.local
mkdir -p apps/web
cp .env.local apps/web/.env.local
pnpm db:push
pnpm dev:web

本地最少需要配置：

DATABASE_URL=postgresql://user:password@host:5432/gpt2image
BETTER_AUTH_SECRET=<random-secret>
BETTER_AUTH_URL=http://localhost:3000
NEXT_PUBLIC_APP_URL=http://localhost:3000

开发地址默认是 http://localhost:3000。

生产部署

生产部署按模块拆开：Web 应用负责页面、API 和默认内置定时任务，Go sidecar 负责 ChatGPT Web 账号。Sub2API、支付和对象存储按业务需要启用。

两种部署方式（二选一）

	方式一：Docker Compose（推荐）	方式二：源码部署
适合谁	单机生产、想一条命令拉起全部	已有自己的 PostgreSQL / Nginx / 对象存储 / 发布流程
怎么起	docker compose up -d	pnpm build:web + 自己守护进程
数据库 + 迁移	Compose 自带 PostgreSQL，自动跑迁移	用你自己的 PostgreSQL，手动 pnpm db:push
进程守护	Compose 托管 Web / 迁移 / Go sidecar	自己用 PM2 / systemd 守护 Web 与 Go sidecar
环境变量文件	cp .env.docker.example .env（仅读 .env）	cp .env.example .env.local（读 .env.local）

新部署优先用方式一；只有已有成熟基建（自己的库/反代/发布流程）才选方式二。下面分别给出两种方式的完整步骤。

环境变量文件对照（别拿错模板）：

部署方式	复制哪个模板	实际读取
Docker Compose	cp .env.docker.example .env	仅 .env（精简、约 30 行）
源码 / 本地开发	cp .env.example .env.local	.env.local（完整模板，含全部可选功能）

仓库只有这两个模板。.env.example（大的）不是给 Docker 的；Docker Compose 不读 .env.local。DATABASE_URL 在 Docker 下由 POSTGRES_USER/PASSWORD 自动拼好并覆盖，不用手写。

方式一：Docker Compose（推荐）

Release 镜像发布在 GHCR（GitHub Container Registry）。GHCR 是 GitHub 自带的 Docker 镜像仓库，不需要单独使用 DockerHub。

cp .env.docker.example .env
docker compose pull
docker compose up -d

默认 compose 会启动 PostgreSQL、Web 应用、数据库迁移任务和 ChatGPT Web sidecar。首次启动默认自用模式，超管密码会写入 app-bootstrap volume 内的 super-admin-credentials.txt，也可通过日志查看。

GPT2IMAGE_IMAGE_TAG 同时控制 Web、数据库迁移和 sidecar 镜像版本。升级时不要只改其中一个镜像；让三者使用同一个 tag，避免 Web 新版本启动但迁移任务仍停留在旧版本，导致运行时缺表或字段。

启动后查看状态：

docker compose ps
docker compose logs -f web

升级到新版本：

docker compose pull
docker compose up -d

如果只修改 .env 里的运行时配置，不需要重新构建镜像，执行 docker compose up -d 让容器重新创建即可。

如果遇到容器内 .next/cache 权限错误，先拉取包含权限修复的新镜像并重建容器：

docker compose pull
docker compose up -d --force-recreate

如果需要从源码本地构建镜像：

cp .env.docker.example .env
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

方式二：源码部署

适合已有自己的 PostgreSQL、Nginx、对象存储和发布流程的环境。需要你自行准备数据库、守护 Web 进程与 Go sidecar。下分三个模块。

1. Web 应用

git clone https://github.com/MeowFree/GPT2Image-Pro.git
cd GPT2Image-Pro
cp .env.example .env.local
mkdir -p apps/web
cp .env.local apps/web/.env.local
pnpm install --frozen-lockfile
pnpm db:push
pnpm build:web
pnpm --filter @repo/web start

生产环境建议明确配置：

DATABASE_URL=postgresql://...
BETTER_AUTH_SECRET=...
BETTER_AUTH_URL=https://your-domain.example
NEXT_PUBLIC_APP_URL=https://your-domain.example

普通 next start / standalone 部署不需要配置 NEXT_PUBLIC_ASSET_PREFIX，也不需要手工处理静态资源；Next 会从应用自身目录提供 _next/static。

源码部署更新：

git pull
pnpm install --frozen-lockfile
pnpm db:push
pnpm build:web
pm2 restart gpt2image-web

如果不用 PM2，请把最后一行替换成自己的 systemd、Docker 或进程管理命令。

2. Go Sidecar

Web 账号池依赖 services/chatgpt-web-proxy，生产环境应单独常驻运行；如果完全不使用 Web 后端，可以不启用这一模块。

cd services/chatgpt-web-proxy
go build -o chatgpt-web-proxy .
CHATGPT_WEB_PROXY_BIND=:3021 \
CHATGPT_WEB_PROXY_SECRET=<proxy-secret> \
./chatgpt-web-proxy

Web 应用侧配置：

CHATGPT_WEB_PROXY_URL=http://127.0.0.1:3021
CHATGPT_WEB_PROXY_SECRET=<proxy-secret>

3. 定时任务

Web 应用默认启用内置定时任务，会自动执行 pending 超时退款、照片销毁清理、积分过期、Web 账号刷新和 Sub2API 自动同步检查。多实例部署时会使用 PostgreSQL advisory lock，避免多个 Web 进程重复执行同一个任务。

普通部署不需要配置 crontab。后台可在系统设置里调整 INTERNAL_JOB_SCHEDULER_ENABLED 和各任务间隔。

其中 /api/jobs/images/expire-pending 同时负责 pending 超时退款和“照片销毁”清理。后台「系统设置 > 存储 > 照片销毁时间（小时）」默认为 0，表示生成图永久保存；填入小时数后，超过保留时长的图片文件会被清理，生成记录和计费流水仍保留。

推荐模块

• Sub2API 后端同步：推荐但可选。启动后在后台创建同步任务，任务规则会存入数据库，后续调整不需要重启 Docker。只有把 SUB2API_POSTGRES_URL 写进 .env 作为环境变量兜底时，改动后才需要执行 docker compose up -d 重新创建 Web 容器；不需要 --build，也不需要重新构建镜像。
• 支付模块：公开运营建议配置 Creem 或 Epay。至少设置 PAYMENT_PROVIDER、对应支付密钥、回调密钥和前端价格 ID。
• 对象存储：未配置时可使用本地 storage/；生产公开访问建议配置 S3/R2/MinIO 兼容存储。
• Upstash 限流：可选。配置 UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN 后启用；各类每分钟请求阈值可在后台系统设置中调整。

除上述密钥和域名外，尽量复用系统初始化写入的默认配置；启动后通过后台系统设置调整。

发布

仓库发布地址为 MeowFree/GPT2Image-Pro。打版本 tag 会触发 GitHub Actions：

• 构建并推送 ghcr.io/meowfree/gpt2image-pro-web
• 构建并推送 ghcr.io/meowfree/gpt2image-pro-migrate
• 构建并推送 ghcr.io/meowfree/gpt2image-pro-chatgpt-web-proxy
• 创建 GitHub Release 草稿，并附带 compose 部署包

git tag -a v0.1.0 -m "v0.1.0"
git push origin v0.1.0

常用命令

pnpm dev:web
pnpm build:web
pnpm typecheck
pnpm test
pnpm --filter @repo/shared test:matrix
pnpm --filter @repo/web test -- responses-native-state
pnpm db:generate
pnpm db:push
pnpm db:studio

TODO

• Sub2API 非数据库接口：当前同步优先面向已有数据库接入方式，后续适配 Sub2API 管理员 API，减少部署时对 Sub2API 数据库直连的依赖。
• Codex 登录接口：补充 Codex/Responses 账号登录、凭据刷新和导入接口，降低手工维护账号池的成本。
• Agent 分支能力：补充类似 playground 的多轮分支/回退/重选路径，用于保留不同图片迭代方向，并处理历史图引用重映射。
• Agent 批量图片工具：评估 generate_image_batch 类工具接入，同时解决粘性会话、计费、任务卡展示和多图引用的一致性。
• PSD 生成接口：预留 PSD 生成/导出接口适配，方便后续对接分层设计图、海报编辑和素材交付场景。

特别致谢

• LINUX DO

License

AGPL-3.0-only