概要
ピュア Go で実装された Grok API ゲートウェイ。Grok Build、Web、Console のマルチアカウントプールを管理する。OpenAI および Anthropic 互換のインターフェースを提供し、ルーティング、レート制限、認証情報の暗号化をサポートする。
README プレビュー
\n \n\n\n\n 面向 Grok Build、Grok Web 与 Grok Console 的多账号 API 网关\n\n\n\n \n \n \n\n\n> [!TIP]\n> **个人新项目**\n> 推荐个人新项目 [DEEIX-AI：DEEIX-Chat 轻量化 AI 平台](https://github.com/DEEIX-AI/DEEIX-Chat)：企业级模型路由、对话、文件、工具、计费、身份和运维的一体化 AI 平台，全面且极致的低占用，空载运行时仅占用 34 MB。\n\n> [!NOTE]\n> 本项目仅供学习与研究交流。请务必遵循 Grok 的使用条款及当地法律法规，不得用于非法用途！\n\nGrok2API 是一个纯 Go 实现的 Grok API 网关。项目将 Grok Build OAuth、Grok Web SSO 与 Grok Console SSO 组织为独立账号池，对外提供 OpenAI 风格接口、Anthropic Messages 兼容接口，以及账号、模型、密钥、用量和代理管理后台。\n\n## 功能概览\n\n- **三 Provider**：`grok_build`、`grok_web` 与 `grok_console` 独立路由、额度和故障状态\n- **标准接口**：Responses、Chat Completions、Images、异步 Videos、Anthropic Messages\n- **多账号调度**：优先级、并发限制、额度门控、会话粘滞、冷却与故障切换\n- **账号接入**：Device OAuth、OAuth JSON、SSO JSON、逐行 SSO Token\n- **媒体能力**：图片生成、图片编辑、视频生成、图片本地归档与 URL/Base64 返回\n- **基础设施**：SQLite/PostgreSQL、Memory/Redis、HTTP 与 SOCKS 代理池\n- **安全边界**：AES-256-GCM 凭据加密、客户端密钥哈希、日志脱敏、SSRF 与传输上限\n- **管理后台**：Dashboard、账号、模型、客户端密钥、请求审计、接口文档与热加载设置\n\n## 架构\n\n```mermaid\nflowchart LR\n Client["API Client"] --> Gateway["Go Gateway"]\n Admin["React Admin"] --> Gateway\n\n Gateway --> Router["Model Router"]\n Router --> Build["Grok Build"]\n Router --> Web["Grok Web"]\n Router --> Console["Grok Console"]\n\n Build --> BuildPool["OAuth Account Pool"]\n Web --> WebPool["SSO Account Pool"]\n Console --> ConsolePool["SSO Account Pool"]\n Build --> Egress["Egress Pool"]\n Web --> Egress\n Console --> Egress\n\n Gateway --> Database["SQLite / PostgreSQL"]\n Gateway --> Runtime["Memory / Redis"]\n Gateway --> Media["Media Storage"]\n```\n\n## 快速部署\n\n### Docker Compose\n\n1. 准备配置：\n\n```bash\ngit clone https://github.com/chenyme/grok2api.git\ncd grok2api\ncp config.example.yaml config.yaml\n```\n\n2. 生成并填写安全密钥：\n\n```bash\nopenssl rand -hex 32\nopenssl rand -base64 32\n```\n\n```yaml\nsecrets:\n jwtSecret: "替换为 hex 随机值"\n credentialEncryptionKey: "替换为 Base64 随机密钥"\n\nbootstrapAdmin:\n username: "admin"\n password: "替换为强密码"\n```\n\n3. 启动：\n\n
FAQ (2)
トラブル対応xAI Console API の 400 エラー「A tool_choice was set on the request but no tools were specified」を修正する方法
この問題は、正規化されたリクエストが tools が空または存在しない状態で tool_choice（例えば "auto" や "none"）を保持している場合に発生します。xAI Console は、空でない tools 配列が存在する場合にのみ tool_choice を受け付けます。
backend/internal/infra/provider/console/normalize.go でリクエストをシリアライズする前に、ペアガードチェックを追加してください：
func ensureConsoleToolChoicePair(payload map[string]any) {
choice, hasChoice := payload["tool_choice"]
if !hasChoice || choice == nil {
return
}
tools, ok := payload["tools"].([]any)
if !ok || len(tools) == 0 {
delete(payload, "tools")
delete(payload, "tool_choice")
}
}リクエストボディがシリアライズされて xAI の /responses エンドポイントに送信される前に、normalizeRequestWithMetadata から ensureConsoleToolChoicePair(payload) を呼び出してください。
即座に適用できるクライアント側の回避策：リクエストから tool_choice を削除するか、tools に少なくとも1つの有効なツールが含まれている場合にのみ送信してください。これにより、tools: [] とともに tool_choice: "none" を送信する可能性のある AxonHub、NextChat、LibreChat などのクライアントからの HTTP 400 invalid-argument レスポンスを防ぐことができます。
トラブル対応なぜ grok2api の grok_web 動画生成は、タスクが HTTP 200 で completed になっているにもかかわらず、異なるプロンプトに対して同じ lighthouse デモ動画を返すのですか？
これは、劣化した/無料のGrok Webアカウントが、プロンプトを無視するアップストリームのストックまたはデコイクリップ（灯台、高山の湖、トラ猫、ファーマーズマーケットなど）を返すことが原因で発生します。クリップは、メタデータ/パッケージングが異なるため、異なる assetId、URL、ファイル全体のSHA256を持つ場合がありますが、デコードされたH.264コンテンツは同じストックビデオです。403: This page is out of date のログも、アカウント/セッションが劣化していることを示しています。
修正方法: grok2apiをv3.1.5から、PR feat(video): detect stock decoy clips by mdat fingerprint and retry を含むリリース/ビルドにアップグレードしてください。この修正では、URLやファイルのSHA256に依存する代わりにMP4の mdat/デコードされたストリームをフィンガープリント化し、既知のデコイクリップを識別して、生成を失敗として扱い、別のアカウントで再試行します。以下で再デプロイします:
docker pull ghcr.io/chenyme/grok2api:latest
docker compose up -d使用しているリリースにPRが含まれていない場合は、マージされたコミットのビルドを使用してください。即時の回避策としては、403を返すアカウントを再認証または削除するか、正常な/劣化していない、または有料のGrokアカウントにローテーションするか、プロバイダーを切り替えてください。デコイチェックに合格するまでは、HTTP 200/completed を成功として扱わないでください。実際にデコードされたフレームを確認してください。プロンプトやプロキシを変更するだけでは、この問題は解決しません。