grok2api 是什么?

Grok2API 是 Go 编写的多账号 Grok 网关,内置 React 管理台,把 Grok Build、Web 和 Console 账号池映射为 OpenAI 与 Anthropic 兼容接口,并记录额度、审计和客户端计费。

⭐ 1 Stars 🍴 0 Forks Python — 作者: chenyme
来源:github.com/chenyme/grok2api;https://github.com/chenyme/grok2api/blob/… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

分别管理 Build OAuth、Web SSO 和 Console SSO 的凭据、额度、健康、冷却、并发与模型能力。暴露 Responses、Chat Completions、Anthropic Messages、图像、视频和语音等接口,实际能力取决于上游账号。

来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

核心功能

多 Provider 账号池

分别管理 Build OAuth、Web SSO 和 Console SSO 的凭据、额度、健康、冷却、并发与模型能力。

来源:github.com/chenyme/grok2api/blob/main/README.md
兼容 API

暴露 Responses、Chat Completions、Anthropic Messages、图像、视频和语音等接口,实际能力取决于上游账号。

来源:github.com/chenyme/grok2api/blob/main/README.md
路由、审计与计费

按模型、额度和并发选择账号,记录请求审计,并为客户端 key 维护用量和部分可计量费用。

来源:github.com/chenyme/grok2api/blob/main/README.md
出口管理

支持代理池、隧道订阅、回退、Clearance 与质量守护;这些能力显著扩大网络、条款和滥用风险。

来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

技术架构

客户端和管理台进入 Go 服务。Management 管理账号、模型、key 和设置;Sync 同步凭据、额度与模型;Gateway 经 Provider Registry 选择 Build/Web/Console 路由;Egress Manager 处理代理与隧道;SQLite/PostgreSQL 保存数据,内存/Redis 管理运行态,Audit 汇总用量和客户端计费。

来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 32 字节凭据加密密钥32 字节凭据加密… JWT secret 与管理员强密码JWT secret 与… 仅限本人获授权的 Grok/xAI 凭据仅限本人获授权的… 可选代理/隧道与共享媒体存储可选代理/隧道与… 多 Provider 账号池 兼容 API 路由、审计与计费 出口管理 grok2api 项目本体 核心功能 关键依赖

技术栈

语言Go 后端、React 前端框架SQLite 或 PostgreSQL、内存或 Redis、Docker Compose
32 字节凭据加密密钥JWT secret 与管理员强密码仅限本人获授权的 Grok/xAI 凭据可选代理/隧道与共享媒体存储
默认配置监听 127.0.0.1:8000;公网部署需 HTTPS、反向代理、可信代理白名单和访问控制
来源:github.com/chenyme/grok2api/blob/main/config.example.yaml;https://git…

快速上手

只在隔离主机复制 config.example.yaml,生成 jwtSecret 与 credentialEncryptionKey,设置强管理员密码并保持 127.0.0.1 监听。首次启动只检查 health、管理员登录、审计与删除流程,不导入 SSO、账号池或代理订阅。只有获得账号所有者与上游条款明确授权后,才能连接单个测试账号。
来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

使用场景

适合在明确授权的内部实验中研究协议转换、路由和计量。批量账号、自动接受条款、随机生日、NSFW 开关、代理池和账号转换可能违反上游条款或造成凭据滥用,不应作为通用部署教程。

来源:github.com/chenyme/grok2api/blob/main/README.md

优势与局限

优势

  • 兼容接口与路由能力完整
  • 配置区分 SQLite/Postgres 和 memory/Redis
  • 凭据加密、审计账本和客户端 key 有明确配置
  • v3.1.6 仍在修复账号租约与审计问题

局限

  • 严重依赖 Web/Build/Console 账号池、额度和付费层能力
  • 官方 README 含付费 API 与住宅代理赞助导流
  • SSO、代理隧道和 Clearance 扩大条款与封号风险
  • credentialEncryptionKey 轮换会使已存凭据无法解密
  • 本轮未启动服务、导入账号或发出上游请求
来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

最新版本

最新正式版 v3.1.6 发布于 2026-09-16,主要修复账号租约隔离、空响应冷却、审计记录、凭据加载失败和推理流处理。Release 内容说明它仍处于高频路由与账号状态修复阶段。

来源:github.com/chenyme/grok2api/releases/tag/v3.1.6

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、config.example.yaml、docker-compose.yml、源码目录与 v3.1.6 Release  |  limitations: 未克隆或运行服务,未导入 OAuth/SSO、未接受条款、未启用代理或 Clearance、未调用任何 Grok/xAI 接口,也未验证这些操作是否符合具体账号条款  |  observed_output: README 明确多账号池、额度同步、客户端计费、付费层模型、代理订阅和账号工具;默认配置要求 JWT secret、32 字节凭据加密密钥并建议本机监听

来源:github.com/chenyme/grok2api/blob/main/README.md;https://github.com/ch…

同类项目对比

xAI 官方 API 通过官方 API key 直接提供模型与兼容接口,账号、额度、计费和条款由 xAI 管理。Grok2API 在中间增加 Web/Build/Console 账号池、代理、路由和二次客户端计费。能使用官方 API 时优先官方入口;只有确有内部网关需求且获得书面授权时再评估 Grok2API。

来源:docs.x.ai/overview;https://github.com/chenyme/grok2api/blob/main/READ…

总结评价

Grok2API 功能完整,但它把账号池、额度、代理、计费和上游条款集中到一个高风险控制面。实际使用优先 xAI 官方 API,评估第三方网关时只连接获授权的单个测试账号并保持本机隔离。

来源:github.com/chenyme/grok2api/blob/main/README.md;https://docs.x.ai/ove…

常见问题

Grok2API v3.1.6 是 xAI 官方项目吗?

不是。它是第三方开源网关,README 也要求使用者遵守 Grok 官方条款和当地法律。官方服务入口应以 xAI 文档为准。

为什么本文不提供批量导入 Grok 账号的步骤?

项目支持 OAuth、SSO、额度同步、账号转换和代理池,这些操作涉及凭据控制、上游条款与滥用风险。只有明确授权的账号才能接入。

Grok2API 的 credentialEncryptionKey 可以随时更换吗?

不可以。官方配置说明,写入账号后更换该密钥会导致已有凭据无法解密,必须安全备份并限制访问。

Grok2API 可以直接暴露公网吗?

不应直接暴露。至少需要 HTTPS、强管理员密码、客户端 key、可信反向代理白名单、审计保留和网络访问控制,Swagger 也应保持关闭。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件