はじめに

New API などのAI中継ステーションアカウントの管理体験を最適化するために設計されたオープンソースのブラウザ拡張機能です。ユーザーは、アカウント残高、モデル、キーを簡単に一元管理・確認でき、新しいサイトを自動的に追加できます。モバイルデバイスでは、Kiwiまたはモバイル版Firefoxブラウザでの使用をサポートしています。

1. ダウンロード

チャネル版の比較

チャネル	ダウンロードリンク	現在のバージョン
GitHub Release	Release ダウンロード
Chrome ストア	Chrome ストア
Edge ストア	Edge ストア
Firefox ストア	Firefox ストア

ヒント

ストア版は審査プロセスで1〜3日遅延する場合があります。新機能や修正をいち早く体験したい場合は、GitHub Release版を優先するか、リポジトリのソースコードからビルドすることをお勧めします。

2. サポートされているサイト

以下のプロジェクトに基づいてデプロイされた中継ステーションをサポートしています：

注意

サイトが二次開発され、一部の重要なAPI（例：/api/user）が変更された場合、拡張機能はこのサイトを正常に追加できない可能性があります。

3. サイトの追加

ヒント

まずブラウザで目的の中継ステーションにログインする必要があります。これにより、拡張機能の自動認識機能がCookieを介してアカウントのアクセストークンを取得できます。

3.1 自動認識による追加

拡張機能のメインページを開き、「アカウントを追加」をクリックします。

中継ステーションのアドレスを入力し、「自動認識」をクリックします。

自動認識が正しいことを確認した後、「追加を確定」をクリックします。

ヒント

拡張機能は、以下のようなアカウントの様々な情報を自動的に認識します：

ユーザー名
ユーザーID
アクセストークン
チャージ金額のレート

目的のサイトがCloudflareの5秒シールドを有効にしている場合、拡張機能は自動的に独立したウィンドウをポップアップ表示し、シールドを通過するのを助けます。通過後、認識プロセスを続行できます。 IPの品質が悪い、またはその他の理由により、タイムアウト前にポップアップウィンドウで手動でシールドを通過する必要があります。

3.2 Cloudflare シールドバイパスアシスタントの概要

Cloudflareの5秒シールドが検出された場合、拡張機能は自動的に一時的なウィンドウを起動して検証を完了させます。チャレンジに手動での介入が必要な場合は、ポップアップ内で検証をクリックしてください。
検証が完了すると、元のプロセスに自動的に戻り、アクセストークンとサイト情報の取得を続行します。
詳細については、Cloudflare保護と一時ウィンドウのフォールバックを参照してください。

3.3 手動追加

ヒント

自動認識が成功しなかった場合、手動でサイトアカウントを追加できます。以下の情報を事前に取得する必要があります。（各サイトのUIは異なる場合があるため、ご自身で探してください）

ユーザー情報

目的のサイトがカスタマイズ版（AnyRouterなど）の場合、アカウント追加時に手動でCookieモードに切り替えてから、自動認識または手動入力を実行してください。厳重な保護が施されたサイトに遭遇した場合でも、Cloudflareシールドバイパスアシスタントと組み合わせて使用できます。詳細については、よくある質問を参照してください。

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

この拡張機能は、追加済みのサイトAPI設定をCherryStudio、CC Switch、およびNew APIにワンクリックでエクスポートすることをサポートしており、これらのプラットフォームでアップストリームプロバイダーを追加するプロセスを簡素化します。

4.1 設定

クイックエクスポート機能を使用する前に、拡張機能の基本設定ページで、ターゲットプラットフォーム（New API）のサーバーアドレス、管理者トークン、およびユーザーIDを設定する必要があります。

4.2 エクスポートプロセス

キー管理への移動：拡張機能のキー管理ページで、エクスポートしたいサイトに対応するAPIキーを見つけます。
エクスポートをクリック：キー操作メニューで、**「CherryStudio / CC Switch / New APIにエクスポート」**を選択します。
自動処理：
- New APIの場合：拡張機能は、ターゲットプラットフォームに同じBase URLのチャネルが既に存在するかどうかを自動的に検出し、重複追加を回避します。存在しない場合は、新しいチャネルを作成し、サイト名、Base URL、APIキー、および利用可能なモデルリストを自動的に入力します。
- CherryStudio / CC Switchの場合：拡張機能は、ターゲットアプリケーションのプロトコルに従って、サイトとキーをローカルプログラムまたはクリップボードに直接送信し、項目ごとの貼り付けの手間を省きます。

この機能により、APIプロバイダーの設定を他のプラットフォームに簡単にインポートでき、手動でのコピー＆ペーストが不要になり、作業効率が向上します。

5. 機能の概要

5.1 自動更新と健康状態

設定 → 自動更新を開くと、アカウントデータの定期的な更新を有効にできます。デフォルトの間隔は6分（360秒）で、最短60秒をサポートしています。
**「拡張機能を開いたときに自動更新」**にチェックを入れると、ポップアップを開いたときにデータを同期できます。
**「健康状態を表示」**を有効にすると、アカウントカードに健康状態のインジケーター（正常/警告/エラー/不明）が表示されます。

5.2 チェックイン検出

アカウント情報で**「チェックイン検出を有効にする」**にチェックを入れると、サイトのチェックイン状態を追跡できます。
カスタムチェックインURLとカスタムチャージURLの設定をサポートし、カスタマイズされたサイトに対応します。
チェックインが必要なアカウントはリストにヒントが表示され、クリックするとチェックインページにジャンプします。

5.3 WebDAVバックアップと多端末同期

設定 → WebDAVバックアップに進み、WebDAVアドレス、ユーザー名、パスワードを設定します。
同期ポリシー（マージ/アップロードのみ/ダウンロードのみ）を選択し、自動同期間隔を設定できます。
JSONインポート/エクスポートと組み合わせて、二重バックアップを実現することをお勧めします。

5.4 ソート優先順位

設定 → ソート優先順位設定でアカウントのソートロジックを調整します。
現在のサイト、健康状態、チェックイン要件、カスタムフィールドなどの条件を組み合わせて並べ替えることをサポートします。
ドラッグ＆ドロップで優先順位を調整でき、不要なソートルールはいつでも無効にできます。

5.5 データインポート/エクスポート

設定 → データとバックアップの「インポートとエクスポート」領域で、現在のアカウント設定をすべてJSONとしてワンクリックでエクスポートできます。
旧バージョンまたは他のデバイスからエクスポートされたデータのインポートをサポートしており、迅速な移行や復元に便利です。

Cloudflareによって認識またはAPI呼び出しがブロックされた場合（一般的なステータスコード401/403/429）、自動的に一時ウィンドウに切り替えて再試行し、ターゲットドメインのCookieを保持します。通常、手動操作は不要です。原理の詳細については、Cloudflare シールドバイパスアシスタントを参照してください。
人間による検証が必要なシナリオに遭遇した場合は、ポップアップ表示されるアシスタントウィンドウでチャレンジを完了してください。頻繁に失敗する場合は、ネットワークを変更するか、リクエスト頻度を下げてみてください。

6. 詳細ドキュメント

7. よくある質問とサポート

認証方法、AnyRouterへの対応、機能の使用方法など、より詳細なよくある質問をご覧ください。
問題が発生した場合や新機能が必要な場合は、GitHub Issuesまでフィードバックをお寄せください。
過去の更新については、更新履歴をご覧ください。

次のステップ

基本設定が完了したら、自動更新、チェックイン検出、またはWebDAV同期を続けて設定し、より完全な使用体験を得ることができます。