chenyme / grok2api

面向 Grok Build、Grok Web 与 Grok Console 的多账号 API 网关

[! 팁] 个人新项目 추천 개인신사업 DEEIX-AI:DEEIX-Chat 轻량화 AI 플랫폼:기업级模型路由、대화, 文件、工具、计费、身份和运维的一体化 AI 平台,全面且极致的低占用,空载运行时仅占用 34 MB。

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

Grok2API 是一个纯 Go 实现的 Grok API 网关。 项目将 Grok Build OAuth、Grok Web SSO 与 Grok Console SSO 组织为独立账号池,对外提供 OpenAI 风格接口、Anthropic Messages 兼容接口,以及账号、模型、密钥、用量和代理管理后台。

功能概览

• 三 Provider:'grok_build', 'grok_web' 与 'grok_console' 독립路由、额度和故障状态
• 표준 接口:응답, 채팅 완료, 이미지, 异步 동영상, 인간적 메시지
• 多账号调度：优先级、并发限制、额度门控、会话粘滞、冷却与故障切换
• 账号接入:D evice OAuth、OAuth JSON、SSO JSON、逐行 SSO Token
• 媒体능력:图片 생성, 图片 편집, 영상 생성, 图片 本地归档与 URL/Base64 返回
• 基础设施:SQLite/PostgreSQL, Memory/Redis, HTTP 与 SOCKS 代理池
• 안전边界:AES-256-GCM 凭据加密、客户端密钥哈希、日志脱敏、SSRF 与传输上限
• 관리后台:D ashboard, 账号、模型、客户端密钥、请求审计、接口文档与热加载设置

架构

快速部署

도커 컴포즈

1. 准备配置：

2. 生成并填写安全密钥：

3. 启动：

访问 `

공식 镜像已经包含前端构建产物,管理端与 API 由同一个 Go 服务提供。 Compose 默认将 'config.yaml' 只读挂载到容器,并使用 'grok2api-data' 命名卷保存 SQLite 数据库和本地媒体.

常用命令：

源码运行

后端：

前端开发服务器：

앞端默认运行于 'API request代理到 '

首次使用

1. 사용 'bootstrapAdmin' 配置的管理员登录.
2. 在"上游账号"中接入 Grok Build、Grok Web 或 Grok Console 账号.
3. 等待本次额度和模型能力同步完成。
4. 在“模型管理”中确认对外模型名称与启用状态。
5. 在"客户端密钥"中创建 'g2a_' API Key.
6. 사용该密钥调用 '/v1/*'.

首次管理员创建后,建议修改管理员密码并从 'config.yaml' 删除 'bootstrapAdmin' 段. 'credentialEncryptionKey' 必须长期保留,更换后已有凭据将无法解密。

账号来源

제공자	认证方式	主要能力
그록 빌드	Device OAuth, OAuth JSON

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.