Grok2API — GrokをOpenAI互換APIに変換する逆向プロキシ

AI/ML

概要

Grok2APIは、Grokのウェブエンドポイントを逆向きに利用して、OpenAI互換のAPIインターフェースを提供するプロジェクトです。特徴は「実際の多輪対話コンテキストを保持する」ことに重きを置いており、GrokのconversationIdとresponseIdを活用して過去メッセージを再送しない形で会話状態を維持します。また複数アカウントのSSOトークンを輪番で利用する負荷分散や、認証/レート制限時の自動クールダウン、アカウント間での会話継続機構(Share + Clone)など、実運用を考えた機能が揃っています。管理用の可視化UIや画像サポート、SSEストリーミングも備え、既存のChatGPT互換フロントエンドとの連携が容易です。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 18
  • フォーク数: 3
  • ウォッチャー数: 18
  • コミット数: 12
  • ファイル数: 10
  • メインの言語: Python

主な特徴

  • OpenAI互換のAPIエンドポイントを提供し、既存のChatGPTフロントエンドと直接接続可能
  • 富んだ会話管理:conversationId/responseIdを用いた真の多輪対話と会話継続(クロスアカウント)
  • 多アカウント運用:SSOトークンの自動ローテーションと負荷分散、認証/制限時の自動クールダウン
  • ストリーミング、画像対応、可視化管理ダッシュボードを含む実運用向け機能群

技術的なポイント

Grok2APIはウェブ版GrokのAPIを逆向きにラップしてOpenAI互換のリクエスト/レスポンスを返すプロキシです。コア設計は「セッションの状態をGrok側のネイティブ識別子で保持する」点にあり、conversationIdとresponseIdを中心に会話履歴を再送しない形でコンテキストを維持します。これにより、帯域やレートの無駄を減らし、Grok側のネイティブな会話継続機能を利用できます。複数のSSOトークンを登録しておくとリクエストはラウンドロビンで分散され、特定トークンが429や認証エラーを返した場合は自動的にクールダウンして他のトークンに切り替わります。クロスアカウントでの会話継続は「Share + Clone」メカニズムを用い、あるアカウントで始めた会話を別アカウントに引き継げるため、Super/Freeのアカウント混在運用が容易です。ストリーミングはSSEをサポートし、フロントエンドに逐次部分応答を渡せます。画像のアップロード・生成と結果キャッシュも実装され、負荷軽減と応答の高速化に寄与します。運用面では管理用UIでトークン管理や会話一覧を可視化でき、Pythonベースの実装(appディレクトリ中心)によりカスタマイズやデプロイがしやすい点も特徴です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • app: dir
  • install.bat: file

…他 5 ファイル

(主な役割)

  • app/ : 実際のアプリケーションコードとエンドポイント実装が含まれるディレクトリ。リクエスト受け取り→Grokへのプロキシ→レスポンス整形の流れを担います。
  • README.md : セットアップ手順、主要機能、使用上の注意点が記載されています。
  • install.bat : Windows向けの簡易インストール補助スクリプト(依存インストールなど)。
  • LICENSE : ライセンス情報。利用時はライセンス条項を確認してください。
  • .gitignore : 一時ファイルや環境固有ファイルの除外設定。

まとめ

Grokを既存のChatフロントエンドで活用したい運用向けの実用的な逆向プロキシ実装です。(約50字)

リポジトリ情報:

READMEの抜粋:

Grok2API

Grok 逆向代理,将 Grok 网页端 API 转换为 OpenAI 兼容格式。支持多账号轮询、真实多轮对话上下文、跨账号会话续接,附带可视化管理后台。

功能特性

  • OpenAI 兼容接口 — 直接对接 ChatGPT-Next-Web、LobeChat 等前端
  • 真实多轮对话 — 通过 Grok 原生 conversationId + responseId 维持上下文,非重发历史消息
  • 多账号轮询 — 支持多个 SSO Token 轮询调用,自动负载均衡
  • 智能冷却 — 429 限流、认证失败等自动冷却,到期自动恢复
  • 跨账号续接 — 通过 Share + Clone 机制实现不同账号无缝续接同一会话
  • 账号类型检测 — 自动识别 Free / Super 会员账号
  • 流式响应 — 支持 SSE 流式输出
  • 思考过程 — 支持 Thinking 模型的推理过程展示(<think> 标签)
  • 图片支持 — 支持图片上传和图片生成结果缓存
  • **自动…