Gemini-CLI-2-API：Gemini CLIをOpenAI互換のネイティブAPIサービスに変換する

Gemini-CLI-2-APIはオープンソースのプロジェクトで、中核となる機能はGoogleの ジェミニ CLIツールは、OpenAI APIと互換性のあるネイティブAPIサービスとしてカプセル化されている。これは、Gemini 2.5 Proモデルに基づいており、開発者が既存のツールチェーンを変更することなく、標準のOpenAIインターフェースを通じてGeminiのAI機能を呼び出すことをサポートする。このプロジェクトは、1日あたり1000の無料リクエストを提供し、ストリーミングレスポンス、複数の認証方法、詳細なロギングをサポートする。コードはオープンソースで、GNU General Public License v3の下でライセンスされており、ローカルAIサービスや高頻度の呼び出しを必要とする開発者のために容易に拡張可能である。

機能一覧

• そうしれいかん ジェミニCLI をサポートするOpenAI API互換インターフェースでラップされている。 /v1/models 歌で応える /v1/chat/completions エンドポイント
• OpenAI形式のリクエストとレスポンスを自動的にGemini形式に変換する。
• Gemini 2.5 Proモデルをサポートし、1日1000件の無料リクエストを提供。
• ストリーミングが提供され、応答はタイプライター効果でリアルタイムに出力される。
• リクエストのプロンプトワード、タイムスタンプ、トークンの有効期限を記録するロギングシステムを含む。
• ベアラートークン、URLクエリパラメータ、および以下のようなさまざまな認証方法がサポートされている。 x-goog-api-key.
• リスニング・アドレス、ポート、APIキー、ロギング・モードはコマンドラインから設定できる。
• OAuthトークンの自動更新に対応し、認証プロセスを簡素化。
• キャッシュやフィルタリング機能の追加など、二次開発をサポートするモジュール式のコード構造。

ヘルプの使用

設置プロセス

Gemini-CLI-2-APIはNode.js環境で動作する必要があります。以下は、詳細なインストールと設定の手順です：

1. Node.jsのインストール
   Node.jsがシステムにインストールされていることを確認する（最新のLTSバージョンを推奨）。Node.jsの公式ウェブサイトからNode.jsをダウンロードしてインストールします。インストールを確認します：

node -v
npm -v

2. プロジェクト・ウェアハウスのクローン
   Gitを使ってプロジェクトをローカルにクローンする：

git clone https://github.com/justlovemaki/Gemini-CLI-2-API.git
cd Gemini-CLI-2-API

3. 依存関係のインストール
   プロジェクトのルート・ディレクトリで以下のコマンドを実行する：

npm install

4. APIキーの設定
   プロジェクト・サポート Google ジェミニAPI キーまたは OAuth 認証を使用します：

• OAuth認証このプログラムを初めて実行すると、ブラウザが開き、Googleアカウントにサインインするよう指示され、OAuthトークンが生成され、自動的に保存されます。トークンの有効期限が切れると、自動的に更新されます。
• APIキーGoogle Cloud または グーグルAIスタジオ キーを取得し、環境変数を設定する：

  export GOOGLE_API_KEY="YOUR_API_KEY"
  export GOOGLE_GENAI_USE_VERTEXAI=true
  

  相互互換性 YOUR_API_KEY が実際のキーである。

5. サービス開始
   以下のコマンドを実行して、ローカルAPIサービスを開始する。このサービスはデフォルトでポート8000でリッスンする：

node openai-api-server.js --port 8000 --api-key sk-your-key

可 --port 歌で応える --api-key カスタム・ポートとカスタム・キー例

node openai-api-server.js --port 8080 --api-key sk-your-key

使用方法

サービスが開始されると、OpenAI互換のAPIエンドポイントを介してGemini-CLI-2-APIと対話することができます。以下はそのための詳細な手順です：

1. チャットリクエストを送信
   プロジェクト・サポート /v1/chat/completions エンドポイント、OpenAIのリクエストフォーマットと互換性があります。エンドポイントは curl または他のHTTPクライアントからリクエストを送信する：

curl http://localhost:8000/v1/chat/completions 
-H "Content-Type: application/json" 
-H "Authorization: Bearer sk-your-key" 
-d '{
"model": "gemini-2.5-pro",
"messages": [
{"role": "system", "content": "你是一个代码助手。"},
{"role": "user", "content": "帮我写一个 Python 函数"}
]
}'

レスポンスはJSON形式で、コンテンツはGemini 2.5 Proモデルによって生成される。

2. ストリーミングの使用
   ストリーミング応答を有効にする "stream": true結果はリアルタイムで逐語的に表示される：

curl http://localhost:8000/v1/chat/completions 
-H "Content-Type: application/json" 
-H "Authorization: Bearer sk-your-key" 
-d '{
"model": "gemini-2.5-pro",
"stream": true,
"messages": [
{"role": "user", "content": "讲一个关于 AI 的故事"}
]
}'

3. 利用可能なモデルを問い合わせる
   利用する /v1/models 対応モデルを見るためのエンドポイント：

curl http://localhost:8000/v1/models 
-H "Authorization: Bearer sk-your-key"

現在サポートされているモデルのリストを返す。 gemini-2.5-pro.

4. ログを見る
   ロギングシステムは、簡単にデバッグできるように、すべてのリクエストのプロンプト語とタイムスタンプを記録します。ファイルへのログ出力を有効にする：

node openai-api-server.js --port 8000 --api-key sk-your-key --log file

ログファイルはプロジェクトディレクトリに保存され、リクエストの詳細とトークンのステータスが含まれます。

5. 既存ツールへの統合
   APIはOpenAIのフォーマットと互換性があるので、サービスのアドレス（例えば http://localhost:8000/v1) を OpenAI API をサポートするツール (LobeChat など) に設定します。ツールのAPIアドレスをGemini-CLI-2-APIのものに設定するだけで、リクエストの形式は変わりません。
6. 拡張開発
   モジュラー設計のため、拡張が容易。例

• キャッシュの追加修正 gemini-core.jsAPIコールの回数を減らしたい場合は、Redisやファイル・キャッシュを追加してAPIコールの回数を減らすことができる。
• コンテンツ・フィルタリングで openai-api-server.js キーワードフィルタリングロジックを追加して、リクエストまたはレスポンスのコンテンツをレビューする。

ほら

• ネットワーク接続が安定していること、OAuth認証でGoogleサーバーへのアクセスが必要であることを確認してください。
• マルチモーダル入力（画像など）は現時点ではサポートされておらず、将来的にアップデートされる可能性がある。
• Googleの利用規約に基づき、1日1000リクエストまで無料。
• 認証に失敗した場合は GOOGLE_API_KEY またはOAuthプロセスを再実行する。

アプリケーションシナリオ

1. 既存ツールのシームレスな統合
   開発者は、Gemini-CLI-2-APIをOpenAI APIベースのツール（例えば、LangChain、AutoGPT）にプラグインし、コードを修正することなく、Gemini 2.5 ProのAI機能を直接呼び出すことができます。
2. ローカルAIサービスの展開
   企業は、コード生成やドキュメントの要約など、私有化されたAIタスクのためのローカルAPIサービスを展開し、クラウドサービスへの依存を減らすことができる。
3. デバッグと最適化のヒント
   ロギング・システムは、開発者がキュー・ワードを記録・分析したり、インタラクション・デザインを最適化したり、カスタム・データセットを構築したりするのに役立つ。
4. 学習と実験
   学生や研究者は、API統合について学んだり、Geminiモデルのパフォーマンスを実験したり、オープンソースコードを通じて新機能を開発したりすることができる。

品質保証

1. なぜOpenAI APIに対応する必要があるのですか？
   OpenAI APIは、多くのAIツールの標準インターフェースであり、Gemini-CLI-2-APIは、このフォーマットと互換性があるため、開発者は既存のコードを変更することなくGeminiモデルを使用することができる。
2. 料金はかかりますか？
   このプロジェクトは無料で、Gemini CLIからの1日あたり1000の無料リクエストに依存している。より多くのリクエストは、Google AIスタジオ 購入する。
3. APIキーに失敗した場合の対処方法を教えてください。
   OAuth認証をトリガするために、環境変数を確認するか、アプリケーションを再実行する。GoogleアカウントがGemini APIにアクセスする権限を持っていることを確認します。
4. 対応機種は？
   Gemini 2.5 Proは現在サポートされており、将来的には他のGeminiモデルにも拡張される可能性がある。