AQBot
GitHub915
日本語
ダウンロード

API ゲートウェイ

API ゲートウェイとは？

AQBot にはビルトインのローカル API サーバーが含まれており、設定されたプロバイダーを OpenAI 互換、Claude ネイティブ、Gemini ネイティブエンドポイントとして公開します。これらのプロトコルのいずれかを使用するツールやクライアントは、AQBot をバックエンドとして使用できます — 別の API キーやリレーサービスは不要です。

ユースケース：

  • Claude Code CLI、OpenAI Codex CLI、Gemini CLI、OpenCode を AQBot 経由で実行。
  • IDE 拡張機能を単一のローカル管理エンドポイントに接続。
  • 1 セットのプロバイダーキーをキーごとのレート制限で多くのツールで共有。

はじめに

  1. 設定 → API ゲートウェイを開きます（または Cmd/Ctrl+Shift+G を押します）。
  2. 起動をクリックしてゲートウェイサーバーを起動します。
  3. デフォルトでは、サーバーは 127.0.0.1:8080（HTTP）でリッスンします。設定タブでリッスンアドレスとポートを変更できます。

API キー管理

ゲートウェイは、プロバイダーキーとは別に独自の API キーで受信リクエストを認証します。

  1. API キータブに移動します。
  2. 新しいキーを生成をクリックします。
  3. 各キーを識別するためにオプションで説明を追加します（例：Claude Code、VS Code）。
  4. キーをコピーします — 一度しか表示されません。

各キーにはプレフィックス、作成日、最終使用タイムスタンプが表示されます。キーはいつでも有効化/無効化または削除できます。

SSL/TLS

ゲートウェイは HTTP の他に HTTPS を提供できます。

自動生成証明書

  1. 設定タブを開きます。
  2. SSL/TLS を有効にして生成モードを選択します。
  3. AQBot が自己署名証明書と秘密鍵を以下に作成します：
text
~/.aqbot/ssl/cert.pem
~/.aqbot/ssl/key.pem
  1. HTTPS ポートを設定します（デフォルト 8443）。
  2. オプションでSSL 強制を有効にして、すべての HTTP リクエストを HTTPS にリダイレクトします。

カスタム証明書

アップロードモードを選択して、独自の証明書と秘密鍵ファイルのパスを提供します。

使用状況分析

メトリクスタブにはゲートウェイアクティビティを監視するためのダッシュボードが表示されます：

ビュー 説明
API キー別 各ゲートウェイキーによるリクエスト量とトークン使用量
プロバイダー別 各アップストリーム AI プロバイダーへのリクエストとトークン
日別 時間経過による日次使用トレンド

これらのダッシュボードを使用してコストを追跡し、異常を発見し、プロバイダー間で負荷を分散します。

リクエストログ

概要タブには以下の詳細を含む最近のリクエストログが表示されます：

  • タイムスタンプ、HTTP メソッド、パス
  • ステータスコードとレスポンスタイム
  • 使用されたプロバイダーとモデル
  • トークン数（プロンプト + 補完）

任意のログエントリをクリックして完全なリクエストとレスポンスを確認します。ログをクリアボタンでログ履歴をリセットします。

設定テンプレート

AQBot には人気の CLI ツール用の既製設定スニペットが付属しています。テンプレートタブに移動し、ツールを選択してコピーをクリックして必要な設定を取得します。

Claude Code CLI

bash
claude config set --global apiUrl http://127.0.0.1:8080
claude config set --global apiKey aqbot-xxxx

OpenAI Codex CLI

bash
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
export OPENAI_API_KEY=aqbot-xxxx
codex

OpenCode

OpenCode 設定に追加します：

json
{
  "provider": "openai",
  "baseURL": "http://127.0.0.1:8080/v1",
  "apiKey": "aqbot-xxxx"
}

Gemini CLI

bash
export GEMINI_API_BASE=http://127.0.0.1:8080
export GEMINI_API_KEY=aqbot-xxxx
gemini

カスタムクライアント

OpenAI 互換のベース URL を受け入れるツールはゲートウェイに接続できます：

text
Base URL:  http://127.0.0.1:8080/v1
API Key:   aqbot-xxxx

aqbot-xxxx を API キータブで生成したキーに置き換えます。SSL が有効な場合は https:// とポート 8443（または設定した HTTPS ポート）を使用します。

外部ツールの接続

以下は OpenAI 互換クライアントを接続するための一般的なパターンです：

  1. AQBot でゲートウェイ API キーを生成します。
  2. ツールの設定でベース URL を http://127.0.0.1:8080/v1（または HTTPS の同等）に設定します。
  3. API キーを生成したゲートウェイキーに設定します。
  4. AQBot プロバイダーのいずれかに設定したモデルを選択します。
  5. ツールを使用し始めます — すべてのリクエストは AQBot を経由してアップストリームプロバイダーにルーティングされます。

次のステップ