> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# モデルソース：Plus モデル、自分のサブスクリプション、BYOK

> 3 つのモデルソースの違いと設定方法を説明します。Plus プランに含まれるモデル、自分の ChatGPT / Claude などのサブスクリプション、BYOK の API キーに加え、AI アシスタント、キーが失敗したときの Plus モデルへのフォールバック、システムタスクのモデルについても説明します。

**モデルソース**は、セッションでモデルを提供するのが誰か、使用量がどこで計上されるかを決めます。AIHubMix Cloud には 3 つのモデルソースがあります。**Plus モデル**（Plus プランに含まれるモデル）、**自分のサブスクリプション**（自分の ChatGPT、Claude などのサブスクリプションアカウント）、**BYOK**（自分で追加した API キー）です。3 つとも **Settings › Personal › Account** で設定し、セッションではモデルピッカーで選択します。[Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md)を参照してください。

## 対応状況

| プラットフォーム | 対応 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | このページはデスクトップアプリについて説明します。 |
| Web アプリ | 対応 | デスクトップアプリと同じです。 |
| モバイル Web | 対応 | 設定はモバイルレイアウトで表示されます。 |

## 入口

* **Settings › Personal › Account**：Plus カードの下に **Your subscriptions**、**BYOK**、**System task models** の 3 つのセクションがあります。
* モデルピッカー：グループタイトルの横にある鉛筆アイコンで編集ウィンドウが開きます。ソースが空の場合は、**Connect subscription** と **Add API key** でその場で追加ウィンドウが開きます。
* コマンドメニュー `⇧⌘P`（Windows では `Ctrl+Shift+P`）の **Model sources (subscriptions / BYOK)**。

## 3 つのモデルソース

| | Plus モデル | 自分のサブスクリプション | BYOK |
| - | - | - | - |
| 内容 | Plus プランに含まれるモデル | 自分のサブスクリプションアカウント（ChatGPT、Claude など） | 自分の API キー（ゲートウェイ、モデルベンダー、カスタムサービス） |
| 使用量の計上先 | Plus プラン（追加料金なし） | そのサブスクリプションアカウントのプランの利用上限 | 対応するプロバイダー（そのプロバイダーの料金） |
| 接続方法 | Plus を取得すると利用可能 | クラウドサーバー上でサインインして認可 | API キーを入力 |
| 設定内の場所 | **BYOK** セクションの 1 行目 | **Your subscriptions** セクション | **BYOK** セクション |
| モデルピッカーのタブ | BYOK（最初のグループ） | Subscriptions | BYOK |
| 対応する Harness | モデルピッカーの表示に従う | サブスクリプションの種類による。[対応サブスクリプション](#supported-subscriptions)を参照 | API 形式による。[API 形式と Harness](#api-format-harness)を参照 |

AIHubMix は BYOK の通常のゲートウェイプロバイダーでもあります。自分の AIHubMix API キーを追加した場合、他のキーと同様にそのプロバイダーから請求され、Plus とは関係ありません。

## Plus モデル

**Plus モデル**は Plus プランに含まれるモデルです。使用量はプランに計上され、追加料金はかかりません。含まれるモデルは Plus のサブスクリプションダイアログと製品内の表示に従います。

### Plus モデルの場所

* **Settings › Account › BYOK** セクションの 1 行目です。AIHubMix のアイコンがあり、**Included with Plus**（Plus 未契約の場合は **Available with Plus**）、モデル数、AI アシスタントが表示されます。この行は削除できず、キーの上限にも含まれません。
* モデルピッカーの BYOK タブの最初のグループです。

### Plus の利用上限の状態

Plus を契約している場合、Plus モデルの行には利用上限に問題があるときのみ状態が表示されます。金額や使用量の数値は表示されません。

| 状態 | 表示内容 |
| - | - |
| 期間の利用上限に到達 | **Daily / Weekly / Monthly usage limit reached; resets time** |
| 使用量を使い切った | **Usage limit reached** |
| 準備中または一時的に利用不可 | **Getting ready, available soon** または **Temporarily unavailable**。しばらくしてから再度確認してください |

### Plus モデルを選ぶ

Plus モデルのグループに表示するモデルを決められます。

1. Plus モデルの行の鉛筆アイコンをクリックします（またはモデルピッカーで Plus モデルのグループタイトルにカーソルを合わせ、鉛筆アイコンをクリックします）。
2. **Your models** でモデルを選択または削除します。[2 列のモデルピッカー](#model-columns)を参照してください。
3. **Save** をクリックします。

変更した後は、下部に **Reset to default** が表示されます。クリックするとプランのすべてのモデルが復元されます。以前に削除したモデルを戻す場合も、先に **Reset to default** を使用してください。

## AI アシスタント

**AI assistant** は各モデルソースのバックグラウンドモデルで、マージコンフリクトの解決やセッションをまたいだコンテキストの整理など、セッション外のバックグラウンドタスクを処理します。デフォルトは **Auto** で、そのソースから低コストかつ低レイテンシのモデルが選ばれます。通常は変更する必要はありません。

変更するには、Account ページの該当する行（Plus モデルの行、サブスクリプションアカウントの行、またはキーの行）で **AI assistant · model name** をクリックして選択します。サブスクリプションアカウントや API キーを追加するときのウィンドウで **Change** をクリックすることもできます。

## 自分のサブスクリプション

**Your subscriptions** は自分のサブスクリプションアカウントを AIHubMix Cloud に接続する機能で、モデルはそのアカウントのプランの利用上限の範囲で実行されます。サインインと認可は自分のクラウドサーバー上で行い、AIHubMix はサブスクリプションの認証情報を保存も中継もしません。

### 対応サブスクリプション

追加できるサブスクリプションは **Add a subscription** ウィンドウに従います。各プロバイダーには接続方法と対応する Harness（**Uses X by default**）が表示されます。

| サブスクリプション | 接続方法 |
| - | - |
| ChatGPT | ブラウザでサインイン、または **Use a device code instead** |
| Claude | 認可コードでサインイン |
| OpenCode | アクセストークン |
| GitHub Copilot | デバイスコードでサインイン |
| GLM | キーを貼り付け |

* プランのティアは認可したアカウントによって決まり、手動で選択する必要はありません。
* **Add a subscription** がグレーアウトしている場合は、現在追加できません。接続済みのアカウントは引き続き使用できます。

### サブスクリプションアカウントを追加する

始める前に、クラウドサーバーが稼働していることを確認してください。稼働していない場合は **Your cloud server isn’t running. Make sure it’s running on the Cloud server page, then connect.** と表示されます。

1. **Settings › Account** を開き、**Your subscriptions** セクションの **Add a subscription** をクリックします（すでにアカウントがある場合は **+** をクリックします）。モデルピッカーの Subscriptions タブが空の場合は **Connect subscription** をクリックすることもできます。
2. プロバイダーを選び、**Name**（同じプロバイダーの複数アカウントを区別するために使用）を確認して、**Continue** をクリックします。
3. 規約を読み、**I understand and agree** にチェックを入れて **Continue** をクリックします。
4. ウィンドウに **Authorization URL** が表示され、**Copy** または **Open** できます。
5. ブラウザでサインインして認可し、プロバイダーに応じた最後の手順を完了します。
   * ChatGPT（ブラウザでサインイン）：サインイン後、ブラウザは読み込まれないページに移動します。アドレスバーから完全なアドレスをコピーし、**Callback URL** に貼り付けて **Submit** をクリックします。
   * ChatGPT（デバイスコード）：任意のブラウザまたはスマートフォンでリンクを開き、ウィンドウに表示された **Verification code** を入力します。サインインできない場合は、先に ChatGPT アカウントのセキュリティ設定でデバイスコードでのサインインをオンにしてください。
   * Claude：認可ページの認可コードを **Authorization code** に貼り付けて **Submit** をクリックします。
6. **Connected name (email)** と表示され、アカウントが一覧に表示されます。

| 状況 | メッセージ / 対処 |
| - | - |
| このプロバイダーのアカウント数の上限に到達 | **You’ve reached the account limit for this provider. Disconnect one before adding another.** |
| クラウドサーバーのバージョンが古すぎる | **Your cloud server needs an update before you can add more accounts** |
| 同じプロバイダーの別のアカウントを追加中 | 先にそちらを完了するかキャンセルします |
| サインインのキャンセル / 未完了 | **Retry** をクリックします |

### 複数アカウントとアカウント名

同じプロバイダーの複数のアカウントを接続できます。たとえば個人用と仕事用の 1 つずつです。モデルピッカーでは名前ごとに分けて表示されます。利用上限に達してもアカウントは自動的に切り替わりません。

* デフォルト名はプロバイダー名で、以降は「ChatGPT (2)」「ChatGPT (3)」のようになります。
* 名前の変更：Account ページでアカウントの行の鉛筆アイコンをクリックします。名前は空にできず、最大 32 文字で、すべてのサブスクリプションアカウントで一意である必要があります（大文字と小文字は区別されません）。

### デフォルトアカウント

同じプロバイダーのアカウントが複数ある場合、そのうち 1 つに **Default** が付き、そのプロバイダーのサブスクリプションを使う新しいセッションではデフォルトでそのアカウントが使われます。変更するには別のアカウントの行で **Make default** をクリックします。

### 再接続が必要な場合

| Account ページの表示 | できること |
| - | - |
| **Authorization expired, this plan can’t be used for now** | **Reconnect** をクリックします |
| **Signed in from a terminal, so your agent can read the credentials. Reconnect here instead.** | **Reconnect** をクリックして、ここから認可し直します |
| その他のエラーメッセージ | 案内に従います |

再接続するには、**Reconnect** をクリックし、**Authorize with name** をクリックして、[サブスクリプションアカウントを追加する](#add-subscription)の手順 4〜6 を完了します。

### サブスクリプションアカウントを切断する

Account ページでアカウントの行の **Disconnect** をクリックします。アカウントは確認なしですぐに削除されます。このアカウントを使用しているセッションは一時停止し、**Subscription account disconnected** が開きます。**Use another model** または **Later** をクリックできます。

### プランの利用上限に到達した場合

セッションで使用しているサブスクリプションアカウントが利用上限に達すると、セッションは一時停止し、完了した変更と環境は保持され、**name usage limit reached** が開きます。どの利用上限に達したか、おおよそいつリセットされるかが表示されます。AIHubMix Cloud はアカウントを自動的に切り替えません。

| 状況 | できること |
| - | - |
| 同じプロバイダーの他のアカウントがある | **Account to switch to** で 1 つを選び、**Continue with this account** をクリックします。モデルは変わりません。 |
| 他のアカウントがない | **Add account** をクリックして Account ページで追加するか、別のモデルで続行します。 |
| モデルを切り替えたい | **Use another model** をクリックしてモデルピッカーを開きます（Harness は変わりません）。切り替え後、セッションは自動的に再開します。 |
| 今は対応しない | **Later** をクリックしてダイアログを閉じます。 |

各サブスクリプションアカウントの 5 時間と 7 日間の利用上限の使用量とリセット時刻は、**Settings › Usage** の **Plan limits** で確認できます。[使用量と請求記録](https://docs.aihubmix.com/jp/cloud/settings/usage-and-billing.md)を参照してください。

## BYOK

**BYOK**（Bring Your Own Key）は自分で追加した API キーを使用し、対応するプロバイダーから請求されます。キーは最大 10 個まで追加できます（Plus モデルの行は含みません）。10 個に達すると **+** がグレーアウトします。

### 対応プロバイダー

API キーを追加するときは、次のプロバイダーから選択できます。選択すると Base URL と API 形式が入力されます。

* **ゲートウェイ**：AIHubMix、OpenRouter、SiliconFlow、Together AI、Groq、Fireworks AI、Vercel AI Gateway、Cloudflare AI Gateway、Novita AI、Azure OpenAI。
* **モデルベンダー**：OpenAI、Anthropic、Google Gemini、DeepSeek、xAI、Mistral AI、Moonshot (Kimi)、Zhipu GLM、Qwen (Alibaba Bailian)、MiniMax、Doubao (Volcano Ark)。
* **その他**：Custom。Base URL と API 形式を自分で入力します。

プリセットのプロバイダーはデフォルトで **OpenAI compatible** です。Anthropic のみデフォルトで **Anthropic compatible** です。Cloudflare AI Gateway と Azure OpenAI では、アドレス内のアカウント、ゲートウェイ、リソース名を自分のものに置き換えてください。

### API キーを追加する

1. **Settings › Account** を開き、**BYOK** セクションの **+**（**Add API key**）をクリックします。モデルピッカーの BYOK タブが空の場合は **Add API key** をクリックすることもできます。
2. **Provider** でプロバイダーを検索または選択します。Base URL や API 形式を編集する必要がある場合は **Change** をクリックします。
3. **API key** を入力します。モデルが自動的に読み込まれ、推奨モデルが自動的に選択されます。必要に応じてモデルを追加または削除します。[2 列のモデルピッカー](#model-columns)を参照してください。
4. **Name (optional)**：空のままにすると「ベンダー ··末尾 4 文字」と表示されます。最大 64 文字です。
5. **Add** をクリックします。キーが BYOK の一覧に表示されます。

* モデルの読み込みに失敗した場合（無効なキーを含む）は、理由が表示されます。**Retry** するか、モデル名を入力して手動で追加できます。
* プロバイダーが選択されていない、モデルが選択されていない、または Base URL が不完全な場合、**Add** は無効です。
* 保存後は、マスクされたキーのみが表示されます。
* Base URL がプライベートネットワークのアドレスの場合、クラウドサーバー上で実行するセッションはこのキーに到達できません。ローカルプロジェクトでのみ機能します。

### キーを編集・削除する

各キーは Account ページで 1 行として表示され、行末に鉛筆（編集）とゴミ箱（削除）があります。モデルピッカーでグループタイトルの横にある鉛筆アイコンをクリックして編集することもできます。

* 保存済みのキーのプロバイダーは変更できません。Base URL と API 形式は **Change** をクリックすると編集できます。
* **API key** を空のまま保存すると元のキーが保持されます。新しいキーを入力して保存すると置き換わります。
* ゴミ箱アイコンをクリックすると、キーは確認なしですぐに削除されます。

### 2 列のモデルピッカー

キーの編集ウィンドウと Plus モデルの編集ウィンドウは、同じ 2 列のモデルピッカーを使用します。

* 左列 **All models**：推奨モデルが先頭に表示され **Recommended** が付きます。検索ボックスは左列のみを絞り込みます。モデルの行をクリックすると選択または選択解除できます。
* 右列 **Added**：選択したモデルです。閉じるアイコンをクリックすると削除できます。
* BYOK では、一覧にないモデル ID を検索ボックスに入力し、**Add “model ID”** をクリックして追加できます。1 つのキーで選択できるモデルは最大 200 個です。

### API 形式と Harness

各キーには API 形式があり、**OpenAI compatible** または **Anthropic compatible** です。Claude Code には Anthropic 互換 API が、Codex CLI には OpenAI 互換 API が必要です。

形式が一致しない場合、モデルピッカーではこのキーのグループがグレーアウトし、理由（例：**API format not compatible with Claude Code**）が表示されます。新しいセッションでこれらのモデルをクリックすると、互換性のある Harness に自動的に切り替わります。サービスがもう一方の API も提供している場合は、編集ウィンドウで Base URL と API 形式を変更するか、同じサービスのキーをもう 1 つ追加できます。

### キーが失敗したときに Plus モデルにフォールバックする

**BYOK** セクションタイトルの右側にトグル **Fall back to Plus models** があります。デフォルトはオフで、クリックするとすぐに反映されます。

* オフ：キーが失敗すると、そのターンはエラーで停止します。
* オン：キーが失敗した場合（利用上限に到達、レート制限、無効なキー）、このターンは Plus に含まれるモデルで続行します。まだ Plus を契約していない場合は、契約後に有効になります。
* キーを追加するまで、トグルは無効です。

## システムタスクのモデル

**Settings › Account** の **System task models** セクションには、バックグラウンドのシステムタスク（たとえば **Environment repair** や **Chat titles**）が現在使用しているモデルが読み取り専用で表示されます。各行には「モデル名 · ソース · Effort X」が表示されます。

* 変更するには、対応するサブスクリプションの行、キーの行、または Plus モデルの行で **AI assistant** を変更します。
* **Couldn’t load** と表示されても、タスクには影響しません。**Retry** をクリックできます。

## 注意事項と制限

* プランの利用上限に達したときやキーが失敗したときに、アカウントは自動的に切り替わりません。**Fall back to Plus models** がオンの場合に限り、キーの失敗時に Plus モデルに切り替わります。
* キーの削除やサブスクリプションアカウントの切断は確認なしで、すぐに反映されます。
* サブスクリプションを追加するには、クラウドサーバーが稼働している必要があります。
* キーや Plus モデルを編集しても、すでに開始しているセッションで使用しているモデルは変わりません。
* Plus のモデル一覧、サブスクリプションで利用できるモデル、推奨モデルは製品の表示に従います。

## 関連ページ

* [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md)
* [モデルに関するよくある質問](https://docs.aihubmix.com/jp/cloud/models/model-faq.md)
* [Settings › Account](https://docs.aihubmix.com/jp/cloud/settings/account.md)
* [使用量と請求記録](https://docs.aihubmix.com/jp/cloud/settings/usage-and-billing.md)
* [Plus プラン](https://docs.aihubmix.com/jp/cloud/plus/plus-plan.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.