ChatGpt Image Studio 是一个单服务交付的图片工作流项目：

• backend/：Go 后端，负责图片接口、账号池、配置管理和静态资源托管
• web/：Vite + React 前端，构建后输出到 web/dist
• scripts/：本地开发、检查、构建脚本

项目当前交付方式是“一个二进制 + 一份静态前端 + 本地配置目录”：

• 前端不需要单独部署
• 后端运行时直接托管 static/
• 首次启动时自动生成 data/config.toml
• 首次生成配置后即可本地运行

• 基于 gpt-image-2 的文本生图
• 参考图生成与连续编辑
• 选区涂抹式局部重绘
• 图片工作台支持会话历史、新建会话、失败重试、提示词复制与结果图下载
• 支持按比例选择分辨率与质量档位，并区分 Free / Paid 可用输出档
• 兼容图片场景的 /v1/chat/completions 与 /v1/responses
• 本地认证文件导入与账号池管理
• Studio 模式支持直接导入 access_token，并将 Token 账号与认证文件账号分开管理
• 支持单账号刷新、一键批量刷新额度与刷新进度展示
• 支持 CPA / NewAPI / Sub2API 多来源账号同步与推送
• 请求记录页可区分官方与 CPA 链路，并记录 size / quality / promptLength
• 配置管理页，可直接修改 data/config.toml

• 支持 生成 / 编辑 / 选区编辑 三种主流程
• 支持移动端单页工作流：会话历史与工作台可分别进入，历史记录支持回到指定会话
• 结果图支持：
  • 下载
  • 作为后续编辑源图继续改图
  • 打开选区编辑器进行局部重绘
• 用户消息支持一键复制，失败任务支持原位重试
• 历史记录支持浏览器本地存储或服务端持久化

当前项目支持把不同类型的数据拆分存储：

• 账号池存储：current / sqlite / redis
• 配置文件存储：file / redis
• 图片会话记录：browser / server
• 图片数据：browser / server

说明：

• current 表示沿用当前本地文件目录方案
• server 表示由后端统一保存并对外提供图片 / 会话读取
• 设置页支持迁移账号池、配置文件与图片会话历史
• 无盘容器场景可配合 redis 保存配置与账号池

• 支持导入本地认证文件
• 支持在 Studio 模式下直接导入 access_token
• Token 账号不会参与 CPA / NewAPI / Sub2API 的同步和推送
• 支持单账号额度刷新与一键批量刷新全部额度
• 批量刷新会限制并发，并在页面显示实时进度
• 支持：
  • 从 CPA / NewAPI / Sub2API 同步账号到本地
  • 推送本地账号到 CPA / NewAPI / Sub2API

预览 1	预览 2

.
├── backend/                  Go 后端
│   ├── api/                  HTTP 路由与处理器
│   ├── internal/             配置、账号、同步、中间件、版本信息
│   ├── data/                 默认模板与本地运行数据目录
│   ├── static/               本地开发时同步的前端静态资源（构建产物，不入库）
│   └── main.go
├── web/                      Vite 前端
│   ├── src/                  React 页面与组件
│   └── dist/                 构建产物（不入库）
├── scripts/                  build / dev / check 脚本
└── README.md

• Go 1.25+
• Node.js 24+
• npm 10+

git clone https://github.com/peiyizhi0724/ChatGpt-Image-Studio.git
cd ChatGpt-Image-Studio

Windows：

./scripts/dev.ps1

macOS / Linux：

chmod +x ./scripts/*.sh
./scripts/dev.sh

开发脚本会自动完成：

1. 安装前端依赖
2. 构建 web/dist
3. 同步前端资源到 backend/static
4. 启动 Go 后端

默认地址：

• http://127.0.0.1:7000

健康检查：

• GET /health

当前仓库支持通过 GitHub Container Registry 直接拉取镜像部署。

镜像发布规则：

• 推送到 main 分支后，GitHub Actions 会自动更新 ghcr.io/peiyizhi0724/chatgpt-image-studio:latest
• 推送版本标签 v1.2.x 后，会额外发布同名版本镜像标签
• Docker 镜像同时提供 linux/amd64 与 linux/arm64

docker compose pull
docker compose up -d

默认会：

• 使用 ghcr.io/peiyizhi0724/chatgpt-image-studio:latest，也就是 main 分支当前最新镜像
• 将宿主机的 ./backend/data 挂载到容器内 /app/data
• 对外暴露 7000 端口
• 额外注入 host.docker.internal，方便容器访问宿主机服务（如本机代理）

如需固定到某个版本，可先设置：

export IMAGE_TAG=v1.2.10
docker compose pull
docker compose up -d

Windows PowerShell：

$env:IMAGE_TAG = "v1.2.10"
docker compose pull
docker compose up -d

如果你的云平台是无状态容器，重启后不会保留本地磁盘，可以把：

• 账号池存到 Redis
• 配置存到 Redis
• 图片会话记录保留在浏览器
• 图片数据保留在浏览器

推荐启动方式：

docker run -d \
  --name chatgpt-image-studio \
  -p 7000:7000 \
  -e SERVER_HOST=0.0.0.0 \
  -e SERVER_PORT=7000 \
  -e STORAGE_BACKEND=redis \
  -e STORAGE_CONFIG_BACKEND=redis \
  -e REDIS_ADDR=your-redis-host:6379 \
  -e REDIS_PASSWORD=your-redis-password \
  -e REDIS_DB=0 \
  -e REDIS_PREFIX=chatgpt2api:studio \
  -e STORAGE_IMAGE_CONVERSATION_STORAGE=browser \
  -e STORAGE_IMAGE_DATA_STORAGE=browser \
  -e TZ=Asia/Shanghai \
  ghcr.io/peiyizhi0724/chatgpt-image-studio:latest

说明：

• 这组环境变量的作用是让程序每次启动时都能先从 Redis 读取配置引导。
• 启动成功后，其他配置仍可在页面“配置管理”中继续修改，并持久化到 Redis。
• 如果没有持久化磁盘，不建议把 image_conversation_storage 或 image_data_storage 设为 server，否则服务端图片历史和图片文件在容器重建后仍会丢失。

Windows：

./scripts/docker-update.ps1

macOS / Linux：

chmod +x ./scripts/docker-update.sh
./scripts/docker-update.sh

更新脚本会自动执行：

1. 检查 Docker / Docker Compose
2. 如果当前目录是 Git 仓库，则先 git pull --ff-only origin main
3. 从 GitHub Container Registry 拉取 latest 镜像
4. 重新创建并启动容器

程序启动时会确保以下文件存在：

• data/config.example.toml
• data/config.toml

在仓库开发模式下，上述路径实际对应：

• backend/data/config.example.toml
• backend/data/config.toml

如果 config.toml 不存在，程序会自动按内置模板生成，无需手动复制。

最小配置示例：

[app]
auth_key = "chatgpt2api"

默认进入后台页面时使用的登录密码也是：

• chatgpt2api

如果你没有修改 [app].auth_key，首次进入时直接输入上面的默认密码即可。

如果需要接入 CPA 同步：

[sync]
enabled = true
base_url = "http://127.0.0.1:8317"
management_key = "your-cliproxy-management-key"
provider_type = "codex"

如果需要通过固定代理访问 ChatGPT，可追加：

[proxy]
enabled = true
url = "socks5h://127.0.0.1:10808"
mode = "fixed"
sync_enabled = false

如果你是 Docker Compose 部署，并且代理程序跑在宿主机上，需要注意：

• 容器里的 127.0.0.1 指向容器自己，不是宿主机
• 更推荐把代理写成 socks5h://host.docker.internal:7890 或可被容器访问到的实际地址
• 如果报 connect: connection refused，通常不是项目不支持 SOCKS5，而是你的代理程序只监听了宿主机回环地址
• 对 Clash / mihomo / sing-box / v2rayN 这类本机代理，通常需要开启 Allow LAN，或者把监听地址改为 0.0.0.0
• 如果代理本身也在 Docker 里，优先直接填写代理容器的服务名和端口，而不是宿主机 IP

补充说明：

• CPA 模式很多请求是发往你配置的 CPA base_url，不等于官方 Studio 直连链路已经验证过宿主机 SOCKS 代理可达
• Studio 官方链路会真实从容器内访问 chatgpt.com，所以宿主机代理是否对容器开放，会直接影响 /backend-api/me 和图片请求

如果需要调整 Free / Plus / Pro / Team 账号的图片链路，可在 [chatgpt] 下补充：

[chatgpt]
free_image_route = "legacy"
free_image_model = "auto"
paid_image_route = "responses"
paid_image_model = "gpt-5.4-mini"

说明：

• free_image_route 控制 Free 账号图片请求走哪条链路。
• free_image_model 控制 Free 账号真正发给上游的模型名。
• paid_image_route 控制 Plus / Pro / Team 账号图片请求走哪条链路。
• paid_image_model 控制 Plus / Pro / Team 账号真正发给上游的模型名。

如果需要把账号池与图片历史迁移到数据库或服务端模式，可在 [storage] 下补充：

[storage]
backend = "sqlite"
config_backend = "file"
image_conversation_storage = "server"
image_data_storage = "server"
sqlite_path = "data/chatgpt-image-studio.db"

如果需要改用 Redis 保存账号池与配置，可继续补充：

[storage]
backend = "redis"
config_backend = "redis"
redis_addr = "127.0.0.1:6379"
redis_password = ""
redis_db = 0
redis_prefix = "chatgpt2api:studio"

对于无状态云容器，通常建议同时配合：

[storage]
image_conversation_storage = "browser"
image_data_storage = "browser"

Windows：

./scripts/build.ps1

macOS / Linux：

./scripts/build.sh

构建脚本会执行：

1. 构建前端 web/dist
2. 同步前端资源到 backend/static
3. 构建后端二进制
4. 生成本地发布目录 dist/package

构建输出目录结构：

dist/package/
├── chatgpt-image-studio.exe / chatgpt-image-studio
├── data/
│   └── config.example.toml
├── static/
│   ├── index.html
│   └── assets/...
└── README.txt

Windows：

./scripts/check.ps1

macOS / Linux：

./scripts/check.sh

当前检查项：

• go test ./...
• npx tsc --noEmit
• npm run lint
• npm run build

如需额外验证 Studio / CPA 以及旧版 mix -> studio 兼容迁移的图片路由，可打开可选黑盒测试：

macOS / Linux：

RUN_IMAGE_MODE_COMPAT_TESTS=1 ./scripts/check.sh

Windows PowerShell：

$env:RUN_IMAGE_MODE_COMPAT_TESTS = "1"
./scripts/check.ps1

这组测试默认不会在普通检查里执行，只在显式设置环境变量后追加运行：

• go test ./api -run TestImageModeCompatibilityBlackBox -count=1

如果启动失败，程序会：

• 在命令行输出中文错误信息
• 将详细信息写入 data/last-startup-error.txt

当前重点处理的失败场景：

• 端口占用
• 配置文件损坏
• 静态资源缺失
• 首次生成配置文件失败

• POST /auth/login
• GET /version
• GET /health

• GET /api/accounts
• POST /api/accounts
• POST /api/accounts/import
• DELETE /api/accounts
• POST /api/accounts/refresh
• POST /api/accounts/refresh-all
• GET /api/accounts/refresh-progress
• POST /api/accounts/update
• GET /api/accounts/{id}/quota

• GET /api/config
• GET /api/config/defaults
• PUT /api/config
• GET /api/requests
• POST /api/proxy/test
• POST /api/integration/test
• POST /api/integration/newapi/token
• POST /api/integration/sub2api/groups

• GET /api/sync/status
• POST /api/sync/run

• GET /api/image/conversations
• DELETE /api/image/conversations
• POST /api/image/conversations/import
• GET /api/image/conversations/{id}
• PUT /api/image/conversations/{id}
• DELETE /api/image/conversations/{id}

• POST /v1/images/generations
• POST /v1/images/edits
• POST /v1/chat/completions
• POST /v1/responses
• GET /v1/models
• GET /v1/files/image/{filename}

以下内容默认不会提交到 Git：

• backend/data/config.toml
• backend/data/config.example.toml
• backend/data/accounts_state.json
• backend/data/auths/*.json
• backend/data/sync_state/*.json
• backend/data/tmp/
• backend/data/last-startup-error.txt
• backend/static/
• web/dist/
• 发布产物、日志、临时文件、本地二进制

不要提交认证文件、管理密钥、运行状态或日志中的敏感内容。

• Linux.do 社区：https://linux.do/

本仓库使用 MIT 许可证，详见 LICENSE。