API 認証情報

「サイトアカウントがなく、Base URL + API Key のみを持つ」シナリオに適しています。独立したインターフェース認証情報を、完全なサイトアカウントを作成せずに、再利用可能な設定プロファイルとして管理、検証、エクスポートできます。

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

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

機能概要

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

アクセス方法

プラグイン設定ページを開きます。
左側のメニューから API 認証情報 を選択します。
右上隅の 認証情報を追加 をクリックします。

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

認証情報の追加方法

基本フィールド

フィールド	説明
名前	目的を区別しやすくします。例：「会社の中継ステーション読み取り専用キー」
Base URL	インターフェースの基本アドレス。保存時に自動的に正規化されます。
キー	対応する API Key
タグ	オプション。アカウントやブックマークとグローバルタグシステムを共有します。
メモ	ソース、目的、モデル制限などの情報を記録できます。

API タイプ

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

OpenAI Compatible
OpenAI
Anthropic
Google

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

残高と使用状況の概要

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

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

クエリ方法

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

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

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

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

Custom Read-only Endpoint を選択します。
クエリアドレスを入力します。
返される JSON 内の各フィールドのパスマッピングを構成します。

制限事項は次のとおりです。

現在の Base URL と同じオリジン内の読み取り専用 GET アドレスのみが許可されます。
クエリアドレスは、ルート相対パス（例：/usage）または完全な同じオリジン URL として記述できます。
JSON Path は、ドットで区切られたフィールド形式（例：data.balance）を使用します。
解析可能なフィールドマッピングが少なくとも 1 つ構成されている必要があります。

この種の設定は、「サイトが標準の New API / OpenAI Billing の返信形式ではないが、カードで残高と今日の使用量を確認したい」というシナリオに適しています。

一般的な操作

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 のみサポート」「残高表示は不正確」「内部ネットワークのみ利用可能」。

よくある質問

質問	説明
認証情報のみを保存しましたが、残高データがありません。	現在のクエリ方法がサイトに適していないか、サイトが対応する読み取り専用インターフェースを提供していない可能性があります。クエリ方法を切り替えるか、カスタム読み取り専用クエリを使用してみてください。
モデル関連の検証でモデル ID が要求されるのはなぜですか？	一部の CLI 互換性チェックとモデル呼び出し検証ではモデルを指定する必要があります。インターフェースは推奨モデルをできるだけ自動的に取得しようとしますが、手動で入力することもできます。
アカウント管理の代わりになりますか？	完全には代替できません。`API 認証情報` はインターフェースの再利用、検証、エクスポートにより適しています。アカウント管理は、サイト識別、残高更新、サインイン、使用量同期などのアカウントレベルの機能を引き続き担当します。
API 認証情報はバックアップに含まれますか？	はい。共有データの一部として、データのエクスポート/インポートおよび WebDAV の選択的同期とともに移行できます。