Grok Web 能力的 OpenAI 兼容网关

多账号池、智能选号、自动维护

将 grok.com 与 console.x.ai 的聊天、图像、视频能力，
以 OpenAI / Anthropic 兼容 API 统一对外提供。

核心特性 · 部署指南 · 模型列表 · 账号配置 · API 端点 · 常见问题

[!NOTE] 本项目仅供学习与研究交流。请务必遵守 Grok 的使用条款及当地法律法规，不得用于非法用途。

本仓库基于上游 chenyme/grok2api 二次开发，新增多账号池管理、Console 免费模型、配额轮换、防封部署等能力。欢迎 PR 和 Fork，二开请保留原作者与前端标识。

核心特性

部署指南

本项目提供两种部署方式：

[!TIP] 当前版本已内置 403 兼容修复，标准版可直接验证。仍遇 403 时再切防封版。

标准版部署

Docker Compose（推荐）：

git clone https://github.com/jiujiu532/grok2api
cd grok2api/grok2api-main/grok2api-main
cp .env.example .env
docker compose up -d

查看日志：

docker compose logs -f grok2api

Docker 单容器：

docker run -d --name grok2api \
  -p 8000:8000 \
  -e TZ=Asia/Shanghai \
  -e LOG_LEVEL=INFO \
  -e ACCOUNT_STORAGE=local \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  --restart unless-stopped \
  ghcr.io/jiujiu532/grok2api:latest

Windows PowerShell：

docker run -d `
  --name grok2api `
  -p 8000:8000 `
  -e TZ=Asia/Shanghai `
  -e LOG_LEVEL=INFO `
  -e ACCOUNT_STORAGE=local `
  -v ${PWD}/data:/app/data `
  -v ${PWD}/logs:/app/logs `
  --restart unless-stopped `
  ghcr.io/jiujiu532/grok2api:latest

防封版部署

前置要求：服务器需支持 NET_ADMIN + SYS_MODULE 权限（KVM/XEN 虚拟化均支持，OpenVZ/LXC 不支持）。

git clone https://github.com/jiujiu532/grok2api
cd grok2api/grok2api-main/grok2api-main
docker compose -f docker-compose.warp.yml up -d

防封版自动启动以下服务：

启动后代理配置已自动完成，进入 Admin 后台添加账号即可使用。

docker pull ghcr.io/jiujiu532/grok2api:latest
docker compose up -d --no-deps grok2api

docker pull ghcr.io/jiujiu532/grok2api:latest
docker compose -f docker-compose.warp.yml up -d --no-deps grok2api

# 查看可用版本：https://github.com/jiujiu532/grok2api/pkgs/container/grok2api
docker pull ghcr.io/jiujiu532/grok2api:<tag>

# 标准版回滚
docker compose up -d --no-deps grok2api

# 防封版回滚
docker compose -f docker-compose.warp.yml up -d --no-deps grok2api

cd grok2api/grok2api-main/grok2api-main
docker compose down
# 如需删除数据（不可恢复）：
rm -rf ./data ./logs

cd grok2api/grok2api-main/grok2api-main
docker compose -f docker-compose.warp.yml down
# 如需删除数据（不可恢复）：
rm -rf ./data ./logs

# 停止标准版
docker compose down

# 用防封版启动（自动检测已有配置，不覆盖）
docker compose -f docker-compose.warp.yml up -d

本地源码部署

前置：Python 3.13+、uv

git clone https://github.com/jiujiu532/grok2api
cd grok2api/grok2api-main/grok2api-main
cp .env.example .env && uv sync
uv run granian --interface asgi --host 0.0.0.0 --port 8000 --workers 1 app.main:app

首次启动

访问 http://localhost:8000/admin/login，默认密码 grok2api，进入后设置：

1. app.app_key — Admin 密码
2. app.api_key — API 鉴权密钥（留空不鉴权）
3. app.app_url — 公网地址（图片/视频链接需要）

配置保存即时生效，无需重启。

模型列表

Chat（ grok.com）

basic表示free账号，spuer和heavy 为付费

Chat（ console.x.ai）

通过 SSO Token 免费访问，不消耗付费额度。所有免费模型使用 basic 等级账号。

Console 配额：30 次 / 15 分钟窗口，采用延迟恢复轮换策略（消耗至剩余 15 次时启动计时器，评分机制自动轮换到其他账号）。后台每 30 秒巡检并自动重置过期配额。

Image / Video（ grok.com）

账号配置

免费账号获取方式：

1. 浏览器 F12 打开开发者工具
2. 访问 https://console.x.ai/
3. Network 面板找任意请求，Cookie 中复制 sso 值
4. Admin 后台 → 账号管理 → 添加账号，粘贴 token

SSO Token 属于敏感凭证，请勿写入代码或提交到版本库。

API 端点

环境变量

运行时配置支持 GROK_ 前缀覆盖，如 GROK_APP_API_KEY 覆盖 app.api_key。

调用示例

# 付费账号对话
curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.20-auto","stream":true,"messages":[{"role":"user","content":"你好"}]}'

# 免费账号对话
curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.3-console","stream":true,"messages":[{"role":"user","content":"你好"}]}'

常见问题

更新日志

v0.1.7

新功能

• 🔌 Console 原生工具调用支持（PR#24，感谢 @daoguademeng）
  • Console 模型支持 OpenAI 兼容的 tools / tool_choice 参数
  • 客户端 function tools（如 bash、read）可稳定产出 tool_calls
  • Grok 内置工具（web_search、x_search 等 19 个）保持内部语义，不泄露为客户端 tool_calls
  • 支持多轮 tool-call 上下文（assistant tool_calls + tool result 正确转换）
  • 新增 738 行回归测试覆盖核心逻辑

优化

• 🔧 Console 配额参数调整：恢复周期从 15 分钟改为 30 分钟，轮换阈值从 15 改为 20，降低单号负载
• 💓 SSE 心跳保活：所有流式接口在数据开始前发送心跳注释，防止思考期间连接超时
• ⚡ TXT 导入异步化：大批量导入不再阻塞，接口立即返回，刷新在后台进行
• 🔒 依赖安全升级：cryptography 48.0.1+、starlette 1.1.0+、python-multipart 0.0.31+

修复

• 🐛 修复 NSFW 初始化时生日已锁定的 429 报错（PR#25，感谢 @Xaihi-nun）
• 🐛 修复批量刷新结果未区分异常与临时失败的问题

v0.1.5 (2025-06-13)

优化

• 🔧 批量刷新结果优化：刷新账户时区分"凭证失效（异常）"和"临时失败（网络波动）"两种状态

  • 前端提示更清晰：刷新完成：成功 906，异常 40，临时失败 54
  • 后端性能优化：批量查询失败账户状态（从 N 次数据库查询降为 1 次）
  • 异常账户自动进入"异常"筛选组，临时失败不影响账户状态

• 🎯 导入账户交互改进（基于 PR#13）

  • 新增/导入弹窗中加入"导入后自动开启 NSFW"复选框（默认不勾选）
  • 工具栏按钮互斥显示：勾选账号时显示批量操作按钮，未勾选显示全局按钮
  • 去除全局配置 account.auto_nsfw_on_import，改为每次导入时手动选择

• ⚙️ 并发数限制调整

  • 批量操作硬限制从 50 调整为 80
  • 配置页并发数输入框添加 min: 1, max: 80 强制限制
  • 防止用户输入超出范围的并发值导致后端压力过大

修复

• 🐛 修复配置页数字输入框 min/max 属性未生效的问题
• 🐛 补充 tokens.py 缺失的 Query 导入（导致服务启动失败）
• 🐛 补充翻译文件中缺失的 autoNsfwOnImport 和 autoNsfwHint 键

致谢

• 上游：chenyme/grok2api
• DeepWiki：chenyme/grok2api
• 项目文档：blog.cheny.me
• 社区：Linux.do

Star History