はじめに
AIstudioProxyAPIは、Node.jsとPlaywright技術を使って、OpenAI APIをシミュレートするオープンソースプロジェクトです。 グーグルAIスタジオ ウェブベース ジェミニ モデルのダイアログ機能を標準的なAPIインターフェースに変換します。開発者はこのプロキシサービスを使うことで、OpenAI APIをサポートするクライアント(Open WebUIやNextChatなど)がGoogle APIに直接アクセスできるようになります。 AIスタジオ 機能は無制限。このプロジェクトは複雑な設定を必要とせず、Google AI Studioの機能を素早く統合したい開発者に適しています。現在のプロジェクトは個人的にメンテナンスされており、更新頻度も低く、ヘッドレスモードをサポートしていないため、Chromeのデバッグポートが利用可能であることを手動で確認する必要があります。
機能一覧
- 提供
/v1/chat/completions
歌で応える/v1/models
OpenAI APIクライアントと互換性のあるエンドポイントです。 - ストリーミング・レスポンスのサポート
stream=true
)でタイプライター効果を得る。 - ノン・ストリーミング・レスポンスのサポート
stream=false
)は、完全なJSONを一度に返す。 - ユーザーの入力プロンプトを自動的に最適化し、Google AI Studioの出力形式に適応します。
- 自動的にChromeインスタンスを起動して接続し、デバッグポートとウィンドウサイズを設定します。
- ポートの競合を処理したり、既存の Chrome インスタンスに接続するための対話型オプションを提供します。
ヘルプの使用
設置プロセス
AIstudioProxyAPIの導入は簡単ですが、環境が適切に設定されていることを確認する必要があります。以下に詳細な手順を示します:
- クローン倉庫
ターミナルで以下のコマンドを実行し、プロジェクトコードを取得する:git clone https://github.com/CJackHwang/AIstudioProxyAPI cd AIstudioProxyAPI
- 依存関係のインストール
プロジェクトの依存関係express
,cors
,playwright
歌で応える@playwright/test
.お使いのパッケージ・マネージャーに応じて、以下のコマンドのいずれかを選択してください:npm install # 或 yarn install # 或 pnpm install
インストールが完了すると、依存関係は自動的に次のように設定される。
@playwright/test
アサーション機能を提供する。 - サービス開始
以下のコマンドを実行して、エージェント・サービスを開始する:node auto_connect_aistudio.cjs
スクリプトはこうなる:
- 依存関係が完了していることを確認する。
- Chromeのデバッグポートを確認する(デフォルト)
8848
無料であろうとなかろうと)。 - クロームのウィンドウサイズを設定する(デフォルトの幅)
460px
). - 自動的にChromeを起動し、Google AI Studioのページを開きます。
ポートが占有されている場合、スクリプトは既存のChromeインスタンスに接続するか、ポートをクリアして再試行するかのオプションを求めるプロンプトを表示します。Google AI Studioのページに手動でログインして認証を完了させてください。
主要機能の使用
AIstudioProxyAPIの中核は、Google AI StudioのGeminiモデル機能を、OpenAI API準拠のインターフェースを介してクライアントが利用できるようにすることです。その仕組みは以下の通りだ:
- クライアントの設定
OpenAI API をサポートするクライアント(Open WebUI など)では、API アドレスをプロキシサービスのアドレスに設定します(デフォルト)。http://localhost:2048
).クライアントのコードを変更する必要はなく、インターフェースは完全に互換性がある。 - 対話のリクエストを送る
クライアントを使用して、OpenAI APIと同じフォーマットでダイアログリクエストを送信します。例{ "model": "gemini", "messages": [ {"role": "system", "content": "你是一个助手"}, {"role": "user", "content": "请解释量子力学"} ], "stream": true }
- セットアップ
stream=true
リアルタイムの対話に適したストリーミング応答を取得します。 - セットアップ
stream=false
1回限りの処理に適した完全なJSON応答を取得する。
- セットアップ
- プロンプトワードの最適化
プロキシサービスは、ユーザー入力を自動的にラップし、特定のタグ (<<<START_RESPONSE>>>
) を使用して、Google AI Studioの出力が期待される形式であることを確認します。開発者はキューワードを手動で調整する必要はありません。 - Chromeインスタンスの管理
起動後、Chromeウィンドウは開いたままで、Google AI Studioのページがクラッシュしないようにしてください。ページが反応しない場合は、関連するすべてのプロセス (node
歌で応えるchrome
を再実行する。node auto_connect_aistudio.cjs
.
注目の機能操作
- ストリーミング対応クライアント側の設定
stream=true
応答はタイプライター効果で逐語的に表示され、インタラクティブなアプリケーションに適している。 - ポートの競合処理スクリプトは
8848
ポートが占有されると、既存のChromeインスタンスに接続するか、ポートを消去するかを選択するプロンプトが表示されます。 - ウィンドウのサイズ変更もし
460px
幅がモニターに合わない。auto_connect_aistudio.cjs
正鵠を得る--window-size
パラメーター
トラブルシューティング
- ページの読み込み失敗ネットワーク接続を確認し、手動でアクセスしてみる。
https://aistudio.google.com/prompts/new_chat
でログインする。 - ポート占有率走る
lsof -i :2048
入居プログラムのチェック、閉鎖、変更server.cjs
正鵠を得るSERVER_PORT
. - 脚本家はまだ準備ができていない。Chromeのウィンドウが閉じられていないことを確認し、起動スクリプトを再実行してください。
アプリケーションシナリオ
- AI対話機能の迅速な統合
aIstudioProxyAPIを使用すると、開発者はGoogle AI Studioの無料枠を利用し、使い慣れたOpenAI APIインターフェイスを介して機能を迅速に実装することができます。 - 現地開発とテスト
開発チームは、ローカル環境でAI対話機能をテストする際に、AIstudioProxyAPIを通じてOpenAI APIをエミュレートすることができ、APIクォータを追加購入する必要がなくなり、コストを削減することができます。 - 教育・研究
AIstudioProxyAPIは、学術研究のためにGeminiモデルへの容易なアクセスを提供します。
品質保証
- AIstudioProxyAPIはどのクライアントをサポートしていますか?
OpenAI APIをサポートしているクライアント(Open WebUIやNextChatなど)であれば、クライアントコードを変更することなく利用できます。 - ヘッドレスモードがサポートされていないのはなぜですか?
Google AI Studioの自動検出機能は、ヘッドレスモードをインターフェースされたChromeインスタンスに限定している。 - 占拠された港にどう対処するか?
プローブ2048
もしかしたら8848
ポートの占有率、競合するプログラムの閉鎖、またはプログラムの変更server.cjs
のポート・コンフィギュレーションは - そのサービスは継続的なネットワーキングを必要としますか?
はい、プロキシサービスでは、Google AI Studioのページが正しく読み込まれるように、インターネットへのアクセスが必要です。