GPTGrok2API
GPTGrok2API 是一个自托管的 GPT/Grok 统一网关，将已授权的模型账号转换为 OpenAI 兼容 API，并提供账号池、代理、注册任务、日志和 Web 管理界面。
仅用于你拥有或明确获授权的账号、服务和测试环境。请遵守 OpenAI、xAI、Apple、代理服务商及当地法律的条款，不要绕过访问控制或批量创建未经授权的账号。
功能概览
OpenAI Chat Completions、Responses、Images 和 Anthropic Messages 兼容接口
GPT/Grok 账号池、配额刷新、健康检查、分组和代理绑定
OAuth 凭据导入、注册任务和可选的本地 Captcha Solver
FastAPI 后端与 Vue Web 控制台
JSON、SQLite、PostgreSQL 和 Git 存储后端
环境要求
Python 3.14+
Node.js 20+（仅在需要重新构建前端时）
Windows、Linux 或 macOS
运行时所需的第三方账号、API Key、代理和 Captcha 服务由使用者自行准备
安装
git clone https://github.com/AuuCoder/gptGrok2api.git
cd gptGrok2api
# 推荐使用 uv
uv sync
# 或使用标准 venv
python -m venv .venv
# Windows: .venv\\Scripts\\activate
# Linux/macOS: source .venv/bin/activate
pip install -e .
如需构建 Web 控制台：
cd web-vue
npm ci
npm run build
cd ..
配置
copy .env.example .env # Windows
# cp .env.example .env # Linux/macOS
至少设置一个随机的管理密钥：
CHATGPT2API_AUTH_KEY=请替换为长度至少32位的随机字符串
STORAGE_BACKEND=json
不要把 .env、账号文件、Cookie、OAuth Token、数据库、日志或代理密码提交到 Git。生产环境建议使用 SQLite/PostgreSQL，并限制管理端口只允许内网访问。
启动
uv run python main.py
默认监听 127.0.0.1:8000。也可以直接使用 Uvicorn：
uv run uvicorn api.app:app --host 127.0.0.1 --port 8000
控制台地址：http://127.0.0.1:8000/。API 文档：http://127.0.0.1:8000/docs。
API 示例
curl http://127.0.0.1:8000/v1/chat/completions ^
-H "Authorization: Bearer YOUR_AUTH_KEY" ^
-H "Content-Type: application/json" ^
-d "{\"model\":\"grok-3\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"
Linux/macOS 将命令中的 ^ 换成 \\。模型名称和可用能力以控制台的模型列表为准。
数据与隐私
运行数据默认写入 data/，日志写入 logs/；这些目录已被 Git 忽略。发布前请检查：
git status --short
git grep -n -I -E "(sk-|ghp_|Bearer |client_secret|password=|Cookie:)" -- .
如果凭据曾经提交过，必须在对应服务商处撤销并轮换，再使用 GitHub 的历史清理工具移除旧提交。
测试
uv run pytest
许可证
详见仓库中的 LICENSE 与 GROK2API_LICENSE。第三方依赖及上游服务分别遵循其各自许可证和服务条款。
