API 認証情報庫

「サイトアカウントがなく、Base URL + API Key のみを持つ」シナリオに適しています。よく使う API キーをまとめて保存し、コピー、API 検証、モデル確認、残高/使用量確認に使えます。完全なサイトアカウントを先に作成する必要はありません。

どのようなシナリオに適していますか

• サードパーティプラットフォームから提供された Base URL と API Key は持っているが、対応するサイトの管理コンソールアカウントを持っていない場合。
• 一般的なインターフェース設定を一元保存し、複数のクライアントや CLI ツール間でコピー＆ペーストする手間を省きたい場合。
• キーが有効かどうか、CLI と互換性があるかどうかを最初に検証してから、下流ツールにインポートするかどうかを決定したい場合。
• 同じインターフェース設定を、モデル表示、インターフェース検証、またはエクスポートの流れで直接使いたい場合。

機能概要

• 認証情報庫管理：サイトアカウントに依存せず、名前、Base URL、API Key、タグ、メモを保存します。
• 検索とフィルタリング：名前、Base URL、タグ、メモ、API タイプでフィルタリングできます。
• 健全性と使用状況の概要：残高、今日の使用量、今日のリクエスト数、利用可能なモデル数、最終更新時間、および健全性を表示できます。
• インターフェース検証：API が利用可能かどうか、および CLI との互換性を個別に検証できます。
• モデル連携：現在の認証情報をモデルリストで直接開き、モデルディレクトリと検証結果を表示できます。
• クイックエクスポート：CherryStudio、CC Switch、Kilo Code、CLIProxyAPI、Claude Code Router、および現在設定されているカスタムホストサイトにエクスポートできます。

アクセス方法

1. プラグイン設定ページを開きます。
2. 左側のメニューから API 認証情報庫 を選択します。
3. 右上隅の API キーを保存 をクリックします。

キー管理 でアップストリームサイトのキーを取得した場合は、まずそこで検証または整理してから API 認証情報庫 に保存すると、後で使いやすくなります。

認証情報の追加方法

基本フィールド

API タイプ

現在、API タイプによる分類と検証をサポートしています。一般的なタイプは次のとおりです。

• OpenAI Compatible
• OpenAI
• Anthropic
• Google

一時的に別の API タイプを検証に使用する場合、インターフェースには、これが今回の検証の一時的な上書きであり、保存済みの認証情報タイプは変更されないことが明確に表示されます。

残高と使用状況の概要

各認証情報カードには、軽量なテレメトリ概要が表示され、一般的な指標には次のものが含まれます。

• 残高
• 今日の使用量
• 今日のリクエスト数
• 今日のトークン数
• 利用可能なモデル数
• 最終更新時間
• 健全性と最後のエラー

クエリ方法

各認証情報について、残高/使用量のクエリ方法を選択できます。

• 自動検出：組み込み順序で互換性のある方法を試します。
• NewAPI Token：New API と互換性のあるトークン使用量クエリに適しています。
• OpenAI Billing：標準の OpenAI Billing クエリに適しています。
• Sub2API：Sub2API スタイルのインターフェースに適しています。
• カスタム読み取り専用クエリ：サイトにカスタム読み取り専用クエリインターフェースがある場合に適しています。
• 無効：残高と使用量をクエリせず、認証情報自体のみを保持します。

詳細なテレメトリ指標

テレメトリを有効にすると、拡張機能は以下の指標の取得を試みます：

• リアルタイム残高
• 今日の支出
• 今日のリクエスト数
• 今日の Prompt/Completion Tokens
• 合計使用量/合計付与額/合計利用可能額
• 有効期限

カスタム読み取り専用クエリ

自動方法が現在のサイトに適していない場合は、カスタム読み取り専用クエリを使用できます。

1. カスタム読み取り専用クエリ を選択します。
2. クエリアドレスを入力します（Base URL と同一生成元である必要があり、/usage のようなルート相対パスをサポートします）。
3. フィールドマッピングの設定: 上記のすべてのテレメトリ指標に対して JSON Path を設定できます。
   • JSON Path はドット区切り形式（例：data.today_total_tokens）を使用します。
   • 拡張機能は自動的に解析し、統一された表示形式に変換します。

安定性とリクエスト制限

あなたのアカウントが上流サイトから異常な呼び出しと判定されるのを防ぐため、All API Hub にはインテリジェントなリクエストリミッターが組み込まれています：

• 同時実行制御: 単一サイトへの同時リクエスト数をデフォルトで 2 に制限します。
• レート制御: 単一サイトへのリクエストレートを 1 分間に約 18 回に制限します（小規模なバーストをサポート）。
• 自動キューイング: 複数のアカウントを更新したり、一括検証を実行したりする際、制限を超えるリクエストは自動的にキューに入り、429 Too Many Requests エラーの発生を回避します。

💡 説明: この制限は主に拡張機能のバックグラウンドでの更新および検証アクションを対象としており、他のツール（CherryStudio など）を介して直接インターフェースを呼び出す際のパフォーマンスには影響しません。

一般的な操作

1. インターフェースの検証

カードの インターフェースを検証 をクリックすると、次のことを確認できます。

• 現在のキーがまだ呼び出し可能かどうか。
• モデルリストが取得可能かどうか。
• 返信が期待される API タイプと互換性があるかどうか。

キーの交換、ネットワークの切り替え、または「クライアントが接続できないが、サイトは生きているように見える」状況のトラブルシューティングに適しています。

2. CLI 互換性の検証

CLI 互換性を検証 をクリックすると、次のことを個別にテストできます。

• 現在のインターフェースが CLI ツールに適しているかどうか。
• モデル ID が CLI シナリオで使用可能かどうか。
• 「Web では動作するが、CLI では動作しない」という互換性の違いがあるかどうか。

3. モデル管理で開く

モデル管理で開く をクリックすると、モデルリストページで現在の API 認証情報がデータソースとして直接使用されます。これにより、サイトアカウントを作成しなくても、モデルディレクトリを表示したり、モデルの可用性を検証したりできます。

4. クイックエクスポート

個々の認証情報から直接エクスポートできます。

• CherryStudio
• CC Switch
• Kilo Code
• CLIProxyAPI
• Claude Code Router
• 現在のカスタムホストサイト

主に「多数のアップストリームインターフェース設定を管理し、複数のダウンストリームツールに配布する」場合は、API 認証情報庫 は完全なアカウント管理よりも直接的です。

使用上の推奨事項

• 用途を含めた命名：例：「OpenAI 読み取り専用テストキー」「会社の中継ステーション Claude 専用キー」。後でフィルタリングしやすくなります。
• タグをグループとして使用：例：仕事、個人、本番、テスト、一時。
• エクスポート前に検証：これにより、無効なキーを複数のクライアントに一括インポートすることを回避できます。
• 制限条件をメモに記載：例：「Anthropic のみサポート」「残高表示は不正確」「内部ネットワークのみ利用可能」。

よくある質問

関連ドキュメント

• クイックエクスポートサイト設定
• サポートされているエクスポートツールと統合ターゲット
• CLIProxyAPI 統合
• データ管理