ChatGPT2API Go 是一个自托管的 ChatGPT Web API 转发服务。它通过 ChatGPT 网页端账号调用上游能力，并向外提供 OpenAI 兼容接口、Anthropic 兼容接口、在线画图工作台、账号池管理、图片管理、日志审计和 Web 管理面板。

ChatGPT2API Go 的目标是把 ChatGPT 网页端能力封装成可自托管的 API 服务，适合下列场景：

• 需要把 ChatGPT 网页端文本能力接入 OpenAI 兼容客户端。
• 需要通过 API 调用 ChatGPT 网页端图片生成和图片编辑能力。
• 需要集中管理多个 ChatGPT 账号、额度、限流状态和失败状态。
• 需要一个带权限控制的在线画图工作台。
• 需要在服务器端缓存、管理、下载和清理生成图片。
• 需要查看每次请求的完整处理链路和上游请求过程。

本项目是 Go 后端实现，后端入口为 cmd/server/main.go，前端静态产物由 Go 服务直接托管。

• GET /v1/models
• POST /v1/chat/completions
• POST /v1/responses
• POST /v1/images/generations
• POST /v1/images/edits

• POST /v1/messages

• 文本对话 SSE 流式转发。
• ChatGPT 网页端图片生成。
• ChatGPT 网页端图片编辑。
• 普通 1K 图片生成路线。
• Codex 高清图片生成路线，支持 2K 和 4K 规格。
• 参考图上传到 ChatGPT 文件系统后再发起图生图请求。
• 对话触发图片工具后解析并下载最终图片。
• Sentinel proof token、Turnstile token、SO token、Conduit token 和 trace id 请求头处理。
• 账号指纹复用，包括 user-agent、oai-device-id、oai-session-id、sec-ch-ua 等字段。
• 403 HTML 拦截识别和未输出前换号重试。
• 无输出错误时自动换号重试，避免拼接半截响应。

• /v1/chat/completions 支持 OpenAI tools 格式，并返回标准 tool_calls / finish_reason=tool_calls。

• /v1/messages 支持将工具调用转换为 Anthropic tool_use 内容块。

• /v1/responses 支持输出 function_call item；流式模式会发送 response.function_call_arguments.* 生命周期事件。

• 推荐上游模型使用 canonical XML 工具块，长文本、代码和路径建议放入 CDATA：

  <tool_calls>
    <invoke name="read_file">
      <parameter name="path"><![CDATA[README.md]]></parameter>
    </invoke>
  </tool_calls>

• 兼容旧版 JSON {"tool_calls":[...]} 和旧 XML 工具标记。

• 会剥离上游工具 XML / JSON 标记，避免把 <tool_calls> 等内部标记直接显示给客户端。

• 会忽略 Markdown 代码块和 inline code span 中的工具调用示例，减少误触发。

• 支持 tool_choice=none、required 和强制函数名；不满足 required / forced 约束时返回协议级错误。

• 支持 OpenAI 风格图片输入。
• 支持 ChatGPT 文件上传链路中的图片上传、确认上传、图片指针引用。
• 支持 input_file / file 内容块的本地文本提取。
• 支持 TXT、Markdown 和轻量 PDF 文本提取。
• 含图片的 PDF 不做 OCR，会返回友好错误。

• 内置 Web 管理面板和在线画图页面。
• 支持文生图。
• 支持图生图。
• 支持多图参考编辑。
• 支持 gpt-image-2 和 codex-gpt-image-2。
• 支持 1:1、16:9、9:16、4:3、3:4 画幅。
• 支持 1K、2K、4K 清晰度。
• 支持图片任务、历史记录、图片归属和下载。

• 支持直接导入 ChatGPT access_token。
• 支持导入带账号元数据的 JSON 记录。
• 支持账号类型、状态、额度、恢复时间和失败次数管理。
• 支持账号轮询选择。
• 支持图片账号并发控制。
• 支持普通账号和 Plus / Team / Pro 账号分层使用。
• 支持 Token 失效识别。
• 支持限流识别和恢复时间记录。
• 支持失败账号标记。
• 支持按账号类型筛选文本请求。

• 支持全局 auth-key。
• 支持用户级密钥。
• 支持 admin / user 权限区分。
• 支持普通用户和高级用户等级。
• 支持图片日额度、月额度、总额度。
• 支持聊天日额度、月额度、总额度。
• 普通用户可限制为 1K 图片和 free 账号池。
• 高级用户可使用 Plus / Team / Pro 账号池和高清图片能力。

终端会打印同一个 trace id 下的完整处理链路，便于排查请求失败原因。

可看到的步骤包括：

• 客户端请求进入。
• 选择文本账号或图片账号。
• bootstrap ChatGPT 首页。
• 获取 Sentinel chat requirements。
• 计算 legacy proof input。
• 是否携带 proof、turnstile、SO token。
• 上传图片 metadata 请求。
• object storage PUT 上传。
• 标记文件 uploaded。
• 转换消息格式。
• 请求 /backend-api/conversation。
• SSE 开始、事件数量和结束。
• 图片任务 prepare。
• 图片任务 start。
• 轮询图片 tool records。
• 解析下载 URL。
• 下载生成图片。
• 失败后换号重试。
• 最终成功或失败。

敏感信息会脱敏，包括：

• Authorization
• access token
• refresh token
• id token
• cookie
• password
• secret
• OAI-Device-Id
• OAI-Session-Id
• 上传 URL query

关闭终端链路追踪：

CHATGPT2API_TRACE=0 ./start.sh --port 3000

也可以使用：

CHATGPT2API_NETWORK_TRACE=0 ./start.sh --port 3000

• 服务端缓存生成图片。
• 支持图片浏览和下载。
• 支持图片归属记录。
• 支持提示词记录。
• 支持标签管理。
• 支持按日期清理旧图片。
• 支持保护画廊图片和用户图片，避免被自动清理。
• 支持公共画廊发布、撤回、查看和批量查询发布状态。

当前后端使用本地 JSON 文件存储。

主要数据文件：

• data/accounts.json
• data/auth_keys.json
• data/gallery.json
• data/image_tasks.json
• data/logs.json
• data/image_owners.json
• data/image_prompts.json
• data/image_tags.json
• data/chat_conversations.json
• data/cpa_pools.json
• data/sub2api_servers.json

文本接口的 model 字段会尽量透传给 ChatGPT 上游。实际可用模型取决于账号权限和上游当前开放状态。

图片接口推荐使用以下模型名：

图片参数：

resolution=2k 或 resolution=4k 会优先走 Codex 高清路线，需要可用的 Plus / Team / Pro 账号。

无需下载整个仓库，直接运行 GitHub 托管的安装脚本。脚本会从 GitHub Release 下载最新版本并安装到 ./chatgpt2api-go-install：

curl -fsSL https://raw.githubusercontent.com/jwbb903/CHATGPT2API-GO/main/scripts/install_latest.sh | bash

指定安装目录：

curl -fsSL https://raw.githubusercontent.com/jwbb903/CHATGPT2API-GO/main/scripts/install_latest.sh | bash -s -- --dir /opt/chatgpt2api-go

如果没有可用 Release 包，也可以从最新源码构建安装：

curl -fsSL https://raw.githubusercontent.com/jwbb903/CHATGPT2API-GO/main/scripts/install_latest.sh | bash -s -- --from-source --web

已下载仓库源码时，也可以直接运行本地脚本：

bash scripts/install_latest.sh

脚本会尽量保留已安装目录中的 config.json 和 data/。安装后按提示运行：

cd ./chatgpt2api-go-install
./start.sh --port 3000

tar -xzf chatgpt2api-go-linux-amd64.tar.gz
cd chatgpt2api-go-linux-amd64
cp config.example.json config.json
./start.sh --port 3000

启动前请编辑 config.json，设置 auth-key。

访问地址：

• Web 面板：http://localhost:3000
• API 地址：http://localhost:3000/v1

docker build -t chatgpt2api-go .
docker run --rm \
  -p 3000:80 \
  -v "$PWD/data:/app/data" \
  -e CHATGPT2API_AUTH_KEY=chatgpt2api \
  chatgpt2api-go

要求 Go 版本与 go.mod 一致。

go test ./...
make run

构建前端静态产物：

make web
make run

scripts/package_release.sh

或：

make package

如需重新构建前端后再打包：

make package-web

手动打包支持以下目标：

每个发布包都会包含：

• 对应目标的 chatgpt2api-go 主程序二进制。
• 已构建的前端静态文件 web_dist/。
• 对应目标可用的 curl-impersonate 二进制目录 data/bin/curl-impersonate/。

发布包会生成到：

release/chatgpt2api-go-linux-amd64.tar.gz

配置文件路径：

config.json

常用字段：

{
  "auth-key": "change-me",
  "proxy": "",
  "base_url": "",
  "refresh_account_interval_minute": 60,
  "image_retention_days": 15,
  "image_poll_timeout_secs": 120,
  "image_poll_interval_secs": 4,
  "image_poll_initial_wait_secs": 0,
  "image_account_concurrency": 3,
  "auto_remove_rate_limited_accounts": false,
  "auto_remove_invalid_accounts": false,
  "cleanup_protect_gallery": true,
  "cleanup_protect_user_images": true,
  "global_system_prompt": ""
}

图片相关超时说明：

• image_poll_timeout_secs：图片 SSE 等待和最终图片记录轮询的总超时，设置为 600 即最多等待 10 分钟。
• image_poll_interval_secs：查询最终图片记录的间隔。
• image_poll_initial_wait_secs：SSE 结束后首次查询前的等待时间，网络慢或容易 429 时可设为 5 到 10。

默认使用 Go 内置 tls-client 模式。

也可以使用外部 curl-impersonate：

CHATGPT2API_UPSTREAM_TRANSPORT=curl-impersonate \
CHATGPT2API_CURL_IMPERSONATE_BIN=/path/to/curl_edge101 \
./start.sh --port 3000

发布包会包含对应目标的 curl-impersonate 二进制目录：

data/bin/curl-impersonate/

如果目标包内没有 curl_edge101，请使用 data/bin/curl-impersonate/ 中存在的 curl_* 启动脚本或 curl-impersonate 可执行文件。

所有 AI 接口都需要鉴权：

Authorization: Bearer <auth-key>

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

非流式文本请求：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "user", "content": "写一段简短的项目介绍"}
    ]
  }'

流式文本请求：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用三点说明这个项目"}
    ]
  }'

带工具请求：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "user", "content": "查询天气并返回摘要"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "查询城市天气",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {"type": "string"}
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

curl http://localhost:3000/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "input": "用一句话介绍 ChatGPT2API Go"
  }'

curl http://localhost:3000/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "gpt-5",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "解释这个项目的作用"}
    ]
  }'

curl http://localhost:3000/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只漂浮在太空里的猫，电影感，细节丰富",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "response_format": "b64_json"
  }'

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

/v1/chat/completions 支持 OpenAI 风格图片输入：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "描述这张图片"},
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,<base64>"
            }
          }
        ]
      }
    ]
  }'

Web 面板包含以下页面和能力：

• 登录和用户鉴权。
• 账号池管理。
• 用户密钥管理。
• 在线画图。
• 图片任务。
• 图片管理。
• 图片标签。
• 公共画廊。
• 日志查询。
• 系统设置。
• 代理测试。
• 存储信息。

项目可配合安卓客户端 Draw 使用。安卓客户端通过本项目后端完成文生图、图生图、画廊、作品管理等操作。

安卓客户端为独立 APK 发布，本仓库不包含其源码。后端 API 完全开放，可参考 docs/android-integration.md 自行实现客户端。

兼容性：

号池管理：

在线画图：

日志管理：

图片管理：

当前 Go 后端不包含以下能力：

• 注册机真实逻辑。
• Cloudflare R2 自动备份真实逻辑。
• SQLite、PostgreSQL、Git 存储后端。
• CPA 远程导入真实同步。
• sub2api 远程导入真实同步。
• 非图片文件上传到 ChatGPT 网页端的真实文件协议。
• PDF 图片 OCR。
• Arkose token 自动求解。

相关接口会尽量返回 disabled 状态或保留兼容结构，避免前端页面崩溃。

说明账号 access token 可能已失效。请刷新或重新导入账号。

说明上游账号触发限流或额度不足。系统会标记账号状态，并在恢复时间后重新尝试。

说明请求可能触发上游风控。系统会识别该类错误，并在没有输出内容前尝试换号重试。仍然失败时，请检查账号质量、代理质量和账号指纹配置。

说明上游要求 Arkose 校验。本项目当前不内置 Arkose token 求解。

新版已修复普通聊天图片消息格式。multimodal_text.parts 中的文字部分会作为字符串发送，图片部分作为 image_asset_pointer 对象发送。

• 不要暴露未加鉴权的服务到公网。
• 生产环境建议使用 HTTPS 反向代理。
• 不要使用重要账号。
• 不要在日志、Issue、截图中公开 token、cookie、账号邮箱和代理地址。
• 建议为不同用户创建不同用户密钥，并配置额度。

go test ./...
gofmt -w internal/app cmd/server
make run
make web
make package
make package-web

cmd/server/main.go                 服务入口
internal/app/server.go             HTTP 服务和路由
internal/app/v1.go                 OpenAI / Anthropic 兼容接口
internal/app/upstream.go           ChatGPT Web 上游协议
internal/app/codex.go              Codex 图片路线
internal/app/text_stream_retry.go  文本流换号重试
internal/app/image_pool.go         图片账号池和重试
internal/app/turnstile.go          Turnstile token 本地求解
internal/app/trace_log.go          终端链路追踪日志
internal/app/accounts.go           账号导入和刷新
internal/app/account_pool.go       账号选择和并发控制
internal/app/store.go              JSON 文件存储
web/                               前端源码
web_dist/                          前端构建产物
scripts/package_release.sh         发布打包脚本
data/                              运行数据目录

本项目向以下项目和维护者致谢：

• RemotePinee/ChatGPT2API：本项目的主要致敬项目，也是前端实现的重要来源。
• basketikun/chatgpt2api：ChatGPT2API 项目的上上游来源。

本项目使用 GNU Affero General Public License v3.0，完整文本见 LICENSE。

本项目包含或改写了上游 MIT 许可项目的代码、前端实现或设计思路。MIT 许可证允许在 AGPL v3 项目中再分发，但必须保留上游版权声明和许可声明。相关声明见 THIRD_PARTY_NOTICES.md。

• LINUX DO - 新的理想型社区