ChatGPT2API 主要是对 ChatGPT 官网相关能力进行逆向整理与封装,提供面向 ChatGPT 图片生成、图片编辑、多图组图编辑场景的 OpenAI 兼容图片 API / 代理,并集成在线画图、号池管理、多种账号导入方式与 Docker 自托管部署能力。

已发布镜像支持 linux/amd64 与 linux/arm64,在 x86 服务器和 Apple Silicon / ARM Linux 设备上都会自动拉取匹配架构的版本。

git clone git@github.com:basketikun/chatgpt2api.git
cd chatgpt2api
docker compose up -d

启动前请先在 config.json 中设置 auth-key,也可以在 docker-compose.yml 中通过 CHATGPT2API_AUTH_KEY 覆盖。

• Web 面板:http://localhost:3000
• API 地址:http://localhost:3000/v1
• 数据目录:./data

启动后端:

git clone git@github.com:basketikun/chatgpt2api.git
cd chatgpt2api
uv sync
uv run main.py

启动前端:

cd chatgpt2api/web
bun install
bun run dev

后续更新新版本:

docker pull ghcr.io/basketikun/chatgpt2api:latest
docker-compose down
docker-compose up -d

支持通过环境变量 STORAGE_BACKEND 切换存储方式:

• json - 本地 JSON 文件(默认)
• sqlite - 本地 SQLite 数据库
• postgres - 外部 PostgreSQL(需配置 DATABASE_URL)
• git - Git 私有仓库(需配置 GIT_REPO_URL 和 GIT_TOKEN)

示例:使用 PostgreSQL

environment:
 - STORAGE_BACKEND=postgres
 - DATABASE_URL=postgresql://user:password@host:5432/dbname

• 兼容 POST /v1/images/generations 图片生成接口
• 兼容 POST /v1/images/edits 图片编辑接口
• 兼容面向图片场景的 POST /v1/chat/completions
• 兼容面向图片场景的 POST /v1/responses
• GET /v1/models 返回 gpt-image-2、codex-gpt-image-2、auto、gpt-5、gpt-5-1、gpt-5-2、gpt-5-3、gpt-5-3-mini、 gpt-5-mini
• 支持通过 n 返回多张生成结果
• 支持生成可编辑 PPT 文件
• 支持生成可编辑 PSD 文件
• 支持 Codex 中的画图接口逆向,仅 Plus / Team / Pro 订阅可用,模型别名为 codex-gpt-image-2,如有需要可自行在其他场景映射回 gpt-image-2,用于和官网画图区分;也就意味着同一账号会同时有官网和 Codex 两份生图额度

• 内置在线画图工作台,支持生成、图片编辑与多图组图编辑
• 支持 gpt-image-2、codex-gpt-image-2、auto、gpt-5、gpt-5-1、gpt-5-2、gpt-5-3、gpt-5-3-mini、gpt-5-mini 模型选择
• 编辑模式支持参考图上传
• 前端支持多图生成交互
• 本地保存图片会话历史,支持回看、删除和清空
• 支持服务端缓存图片URL
• 图片生成进度追踪,超时后可继续等待
• 图片懒加载与滚动位置记忆,优化大量图片场景性能

• 自动刷新账号邮箱、类型、额度和恢复时间(异步进度追踪)
• 轮询可用账号执行图片生成与图片编辑
• 遇到 Token 失效类错误时自动剔除无效 Token
• 定时检查限流账号并自动刷新
• 支持密码重新登录恢复异常账号,刷新后可自动重登
• 支持网页端配置全局 HTTP / HTTPS / SOCKS5 / SOCKS5H 代理
• 支持搜索、筛选、批量刷新、导出、手动编辑和清理账号
• 支持四种导入方式:本地 CPA JSON 文件导入、远程 CPA 服务器导入、sub2api 服务器导入、access_token 导入
• 支持在设置页配置 sub2api 服务器,筛选并批量导入其中的 OpenAI OAuth 账号

• /v1/complete 文本补全与流式输出已实现,但仍在测试,目前会出现对话重复的问题,请谨慎测试使用
• /v1/chat/completions 文本链路支持短 TTL 缓存、重复请求合并与相邻重复消息清理,可通过 chat_completion_cache 配置调整
• 详细状态说明见:功能清单

所有 AI 接口都需要请求头:

Authorization: Bearer <auth-key>

curl http://localhost:8000/v1/models \
 -H "Authorization: Bearer <auth-key>"

curl http://localhost:8000/v1/images/generations \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <auth-key>" \
 -d '{
 "model": "gpt-image-2",
 "prompt": "一只漂浮在太空里的猫",
 "n": 1,
 "response_format": "b64_json"
 }'

curl http://localhost:8000/v1/images/edits \
 -H "Authorization: Bearer <auth-key>" \
 -F "model=gpt-image-2" \
 -F "prompt=把这张图改成赛博朋克夜景风格" \
 -F "n=1" \
 -F "image=@./input.png"

curl http://localhost:8000/v1/images/edits \
 -H "Authorization: Bearer <auth-key>" \
 -H "Content-Type: application/json" \
 -d '{
 "model": "gpt-image-2",
 "prompt": "把这张图改成赛博朋克夜景风格",
 "images": [
 {"image_url": "https://example.com/input.png"}
 ]
 }'

curl http://localhost:8000/v1/chat/completions \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <auth-key>" \
 -d '{
 "model": "gpt-image-2",
 "messages": [
 {
 "role": "user",
 "content": "生成一张雨夜东京街头的赛博朋克猫"
 }
 ],
 "n": 1
 }'

curl http://localhost:8000/v1/responses \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <auth-key>" \
 -d '{
 "model": "gpt-5",
 "input": "生成一张未来感城市天际线图片",
 "tools": [
 {
 "type": "image_generation"
 }
 ]
 }'

学 AI , 上 L 站:LinuxDO

感谢所有为本项目做出贡献的开发者:

Star History Chart