ChatGPT2API

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

[!WARNING] 免责声明：

本项目涉及对 ChatGPT 官网文本生成、图片生成与图片编辑等相关接口的逆向研究，仅供个人学习、技术研究与非商业性技术交流使用。

• 严禁将本项目用于任何商业用途、盈利性使用、批量操作、自动化滥用或规模化调用。
• 严禁将本项目用于破坏市场秩序、恶意竞争、套利倒卖、二次售卖相关服务，以及任何违反 OpenAI 服务条款或当地法律法规的行为。
• 严禁将本项目用于生成、传播或协助生成违法、暴力、色情、未成年人相关内容，或用于诈骗、欺诈、骚扰等非法或不当用途。
• 使用者应自行承担全部风险，包括但不限于账号被限制、临时封禁或永久封禁以及因违规使用等所导致的法律责任。
• 使用本项目即视为你已充分理解并同意本免责声明全部内容；如因滥用、违规或违法使用造成任何后果，均由使用者自行承担。
• 本项目基于对 ChatGPT 官网相关能力的逆向研究实现，存在账号受限、临时封禁或永久封禁的风险。请勿使用你自己的重要账号、常用账号或高价值账号进行测试。

赞助商

	坤肉AI 是一站式 AI 视觉创作平台，集 AI 生图、视频生成、多人协作画布及 Agent/MCP 连接于一体，适合个人创作与团队协作，同时面向企业提供源码出售及私有化部署服务，欢迎企业咨询合作！另有 API 开放平台，提供丰富的 AI 模型 API 接口，支持快速接入与集成，欢迎开发者及企业对接合作！
	IPWO 住宅代理提供动态、静态及不限量住宅代理，覆盖 195+ 个国家和地区，支持 HTTP(S) 与 SOCKS5 协议。 对于使用 ChatGPT2API 进行 AI 图片生成、图片编辑和 API 集成的开发者，IPWO 支持免费测试，支持地区选择与网络连接配置，满足多种开发和测试需求。优惠折扣码：0200。
	Atlas Cloud is a full-modal AI inference platform that gives developers a single AI API to access video generation, image generation, and LLM APIs. Instead of managing multiple vendor integrations, you connect once and get unified access to 300+ curated models across all modalities. Check out Atlas Cloud's new coding plan promotion for more budget-friendly API access.

快速开始

Docker 运行

git clone [email protected]: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

WARP / FlareSolverr 稳定代理部署

如果图片链路经常遇到 Cloudflare 拦截，可以启用附带的 WARP + Privoxy + FlareSolverr 方案：

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

该 compose 会启动：

• warp-proxy：提供 WARP SOCKS5 出口。
• privoxy：把 WARP SOCKS5 转成 HTTP 代理。
• flaresolverr：刷新 Cloudflare clearance。
• init-config：幂等写入 proxy_runtime 默认配置。
• app：启动 ChatGPT2API 主服务。

默认只让上游 OpenAI / ChatGPT 请求走稳定代理，账号邮箱、CPA 等辅助链路不会被强制接管。账号自身配置的代理优先级最高，其次是稳定代理运行时，再其次是显式代理和旧版全局代理。

可在 .env 中调整端口和代理运行时参数，也可在后台设置页的「稳定代理运行时」面板手动保存、测试代理和测试 clearance。

本地开发

启动后端：

git clone [email protected]: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

功能

API 兼容能力

• 兼容 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 代理
• 支持 WARP / FlareSolverr 稳定代理运行时
• 支持搜索、筛选、批量刷新、导出、手动编辑和清理账号
• 支持四种导入方式：本地 CPA JSON 文件导入、远程 CPA 服务器导入、sub2api 服务器导入、access_token 导入
• 支持在设置页配置 sub2api 服务器，筛选并批量导入其中的 OpenAI OAuth 账号

实验性 / 规划中

• 详细状态说明见：功能清单

效果展示

API

所有 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

Contributors

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

Star History