webchat2api
webchat2api 是一个将 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力封装为标准 API 接口的代理服务项目,提供 FastAPI 后端、Next.js Web 管理端、OpenAI 风格 API、Gemini native API、GPT/Grok/Gemini 账号池管理、文生文/文生图试验页以及 Docker 自托管部署能力。
[!WARNING]
免责声明:本项目涉及对 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力的逆向研究与封装,仅供个人学习、技术研究与非商业性技术交流使用。严禁用于商业倒卖、批量滥用、违反服务条款或违法违规场景。使用者需自行承担账号受限、封禁及其他法律与合规风险。
[!IMPORTANT]
默认登录密钥为 admin,仅适合本地测试。公网或生产环境部署后必须通过 LOGIN_SECRET 或 WEBCHAT2API_AUTH_KEY 修改为强随机密钥。
功能概览
- OpenAI 风格 API:将 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力包装为
/v1/models、/v1/chat/completions、/v1/completions、/v1/complete、/v1/images/generations、/v1/images/edits、/v1/responses、/v1/messages 等接口;兼容上游前缀 /openai/v1/models、/openai/v1/chat/completions 和 /claude/v1/messages
- 公共接口:提供
/health、/version、/auth/login,AI 接口统一使用 Bearer Token 鉴权
- GPT/Grok/Gemini 文本模型:
/v1/models 优先通过 provider=gpt 账号动态拉取 GPT 模型,并合并静态 Grok 与 Gemini 模型;/v1/chat/completions 按 model 自动分发到 GPT、Grok 或 Gemini 服务商账号
- Grok app-chat:支持通过 grok.com app-chat 路径访问带
mode_id 的 Grok 模型,并可走 Browser Bridge 用真实 Chromium 代理请求
- Grok 图片生成与编辑:
grok-imagine-image-lite、grok-imagine-image、grok-imagine-image-pro 通过 app-chat 图片能力生成图片;grok-imagine-image-edit 支持 app-chat 图片编辑;grok-imagine-video 已列出但暂未实现,Grok files 和 voice 仍未接入
- Gemini native API:提供
/gemini/v1beta/models、generateContent、streamGenerateContent、deepresearch、deepresearch/stream、interactions 和 interactions/{id};支持 Gemini native contents/parts/tools/toolConfig/generationConfig 与 functionCall/functionResponse 转换
- tier 感知账号选择:Grok app-chat 会按模型所需
basic、super、heavy tier 和账号 capabilities 优先选择匹配账号,未匹配时再回退到普通 Grok 轮换
- Web 管理后台:账号池、用户 API Key、代理、日志、图片任务、图片文件、备份、图片存储和系统配置管理
- 管理接口:提供
/api/settings、/api/auth/users、/api/accounts、/api/cpa/*、/api/sub2api/*、/api/remote-account/*、/api/image-tasks/*、/api/images*、/api/logs、`/ap