chatgpt2api README

The project's README from github.com/basketikun/chatgpt2api. As one markdown file: README.md.

ChatGPT2API

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

[!WARNING] 免责声明：

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

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

赞助商

Atlas Cloud 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 覆盖。

WARP / FlareSolverr 稳定代理部署

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

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

该 compose 会启动：

默认只让上游 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 切换存储方式：

示例：使用 PostgreSQL

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

功能

API 兼容能力

在线画图功能

号池管理功能

实验性 / 规划中

效果展示

image image edit
chery studio account pool
new api

API

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

Authorization: Bearer <auth-key>
GET /v1/models

返回当前暴露的图片模型列表。

curl http://localhost:8000/v1/models \
  -H "Authorization: Bearer <auth-key>"
说明
字段 说明
返回模型 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
接入场景 可接入 Cherry Studio、New API 等上游或客户端

POST /v1/images/generations

OpenAI 兼容图片生成接口，用于文生图。

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"
  }'
字段说明
字段 说明
model 图片模型，当前可用值以 /v1/models 返回结果为准，推荐使用 gpt-image-2
prompt 图片生成提示词
n 生成数量，当前后端限制为 1-4
response_format 当前请求模型中包含该字段，默认值为 b64_json

POST /v1/images/edits

OpenAI 兼容图片编辑接口，可上传图片文件，也可按官方 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"

也可以直接传图片 URL：

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"}
    ]
  }'
字段说明
字段 说明
model 图片模型， gpt-image-2
prompt 图片编辑提示词
n 生成数量，当前后端限制为 1-4
image 需要编辑的图片文件，使用 multipart/form-data 上传
images JSON 图片引用数组，支持 {"image_url": "https://..."}
image_url 表单模式下也可直接传图片链接，支持重复字段传多张图

POST /v1/chat/completions

面向文本、网页搜索与图片场景的 Chat Completions 兼容接口，不是完整通用聊天代理。

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
  }'
字段说明
字段 说明
model 文本、搜索或图片模型；搜索模型会触发网页搜索兼容逻辑
messages 消息数组，支持文本、搜索和图片请求内容
n 图片生成数量，按当前实现解析为图片数量
stream 文本、搜索和图片场景均支持，仍在测试
tools 文本场景支持 web_search / web_search_preview / web_search_preview_2025_03_11
web_search_options 传入时会触发网页搜索兼容逻辑

POST /v1/responses

面向文本、网页搜索和图片生成工具调用的 Responses API 兼容接口，不是完整通用 Responses API 代理。

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"
      }
    ]
  }'
字段说明
字段 说明
model 响应中会回显该模型字段，搜索和图片生成会走对应兼容逻辑
input 输入内容；搜索使用最后一条用户文本，图片生成需能解析出提示词
tools 支持 image_generation、web_search、web_search_preview、web_search_preview_2025_03_11
stream 已实现，但仍在测试

社区支持

学 AI , 上 L 站：LinuxDO

Contributors

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

Contributors

Star History

Star History Chart

chatgpt2api (basketikun/chatgpt2api)

Searching Database…

6.7K ·GitHub
Chatgpt2api
Что это такое?ChatGPT2API проводит реверс-инжиниринг веб-эндпоинтов ChatGPT и предоставляет вам собственный API, совместимый с OpenAI, для генерации изображений, редактирования изображений и текстовых дополнений, а также панель управления пулом аккаунтов ChatGPT.
Это библиотека или отдельный сервер, который я запускаю сам?Это отдельный сервер для самостоятельного развёртывания с веб-панелью администратора и HTTP-эндпоинтами в стиле OpenAI, а не библиотека, которую импортируют в код. Его разворачивают (обычно через Docker) и подключают к нему клиенты, совместимые с OpenAI.
Как это запустить?Укажите auth-key в config.json (или переопределите его через CHATGPT2APIAUTHKEY в docker-compose.yml), затем запустите сервис: поднимутся веб-панель, API-эндпоинт и каталог хранения ./data.
Нужны ли мне реальные аккаунты ChatGPT, чтобы этим пользоваться?Да, сам по себе он не работает: аккаунты ChatGPT передаются ему через локальный JSON-файл CPA, удалённый сервер CPA, сервер sub2api или напрямую как токены доступа. Он объединяет их в пул и по очереди использует для обработки запросов.
Безопасно ли использовать с этим мой основной аккаунт ChatGPT?Нет. Проект явно является неофициальной попыткой реверс-инжиниринга, поэтому подключённые к нему аккаунты могут получить ограничение частоты запросов, временную блокировку или перманентный бан. В README также запрещено коммерческое и крупномасштабное автоматизированное использование.
Где это развернуть?Сервис рассчитан на запуск в Docker (CI-процесс docker-publish собирает образы). Также есть необязательный дополнительный стек Compose с WARP, Privoxy и FlareSolverr, который помогает не дать Cloudflare блокировать конвейер генерации изображений.
Какие модели для изображений доступны через API?Эндпоинт /v1/models перечисляет gpt-image-2, codex-gpt-image-2, auto и несколько вариантов gpt-5 (gpt-5, gpt-5-1, gpt-5-2, gpt-5-3, gpt-5-3-mini, gpt-5-mini), которые можно использовать для генерации изображений по тексту, редактирования и чата.
Можно ли получить редактируемые файлы дизайна, а не только картинки?Да: помимо готовых изображений, конвейер генерации может создавать редактируемые файлы PowerPoint (PPT) и Photoshop (PSD).
Как пул аккаунтов поддерживается в рабочем состоянии со временем?Он автоматически обновляет квоты аккаунтов и окна восстановления, удаляет токены, которые не прошли проверку, по расписанию перепроверяет аккаунты с ограничением частоты запросов и может заново войти по сохранённым паролям, чтобы оживить нерабочие аккаунты.
Какие хранилища можно использовать для аккаунтов и конфигурации?Переключение выполняется через переменную окружения STORAGE_BACKEND: между локальными JSON-файлами (по умолчанию), SQLite, внешней базой данных PostgreSQL или приватным репозиторием Git.
What are similar projects?gpt4free, one-api, grok2api, LibreChat, banana-slides, gpt-load, workbuddy2api-panel, freebucks-proxy
Which topics is it in?gpt-image-2, self-hosted-ai, gpt, chatgpt, openai-compatible, image-generation, reverse-engineering, sqlite, postgresql, proxy, docker-compose, dashboard
Creator
basketikun
Size
5.2 MB
Stars
6.7K
Updated
CommitJul 29Releasev1.7.0Jul 05
Age
6mo
Commits · 90 Days