> ## 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

> 三種模型來源的區別與配置：Plus 套餐包含的模型、自帶 ChatGPT / Claude 等訂閱、BYOK API Key，以及 AI 助理、Key 失敗改用 Plus 模型和系統任務模型。

**模型來源**決定會話裡的模型由誰提供、用量記在哪裡。AIHubMix Cloud 有三種模型來源：**Plus 模型**（Plus 套餐包含的模型）、**自帶訂閱**（你自己的 ChatGPT、Claude 等訂閱帳號）和 **BYOK**（你自己新增的 API Key）。三種來源都在「设置 › 个人 › 账户」裡配置，在會話裡透過模型選擇器選用，見 [Harness 與模型](https://docs.aihubmix.com/zh-Hant/cloud/models/harness-and-models.md)。

## 適用範圍

| 形態 | 支援情況 | 說明 |
| - | - | - |
| 桌面客戶端 | 支援 | 本頁按桌面客戶端描述。 |
| 網頁版 | 支援 | 與桌面客戶端一致。 |
| 手機網頁 | 支援 | 設定頁為移動佈局。 |

## 入口

* 「设置 › 个人 › 账户」：Plus 卡下方依次是「自带订阅」「BYOK」「系统任务模型」三個分割槽。
* 模型選擇器：組標題旁的鉛筆圖示開啟編輯窗；來源為空時的「连接订阅」「添加 API Key」就地開啟新增視窗。
* 命令選單 `⇧⌘P`（Windows 為 `Ctrl+Shift+P`）裡的「模型来源（订阅 / BYOK）」。

## 三種模型來源

| | Plus 模型 | 自帶訂閱 | BYOK |
| - | - | - | - |
| 是什麼 | Plus 套餐包含的模型 | 你自己的訂閱帳號（ChatGPT、Claude 等） | 你自己的 API Key（閘道器、模型廠商或自定義服務） |
| 用量記在哪裡 | Plus 套餐，不另扣費 | 該訂閱帳號的套餐額度 | 對應服務商，按其價格計費 |
| 怎麼接入 | 開通 Plus 後即可用 | 在你的雲主機裡登入授權 | 填寫 API Key |
| 在設定裡的位置 | 「BYOK」分割槽第一行 | 「自带订阅」分割槽 | 「BYOK」分割槽 |
| 模型選擇器頁籤 | BYOK（第一組） | 訂閱 | BYOK |
| 能搭配的 Harness | 以模型選擇器顯示為準 | 按訂閱型別，見 [支援的訂閱](#supported-subscriptions) | 按介面格式，見 [介面格式與 Harness](#api-format-harness) |

AIHubMix 在 BYOK 裡也是一個普通的閘道器服務商：你自己新增 AIHubMix 的 API Key 後，它和其他 Key 一樣按服務商計費，與 Plus 無關。

## Plus 模型

**Plus 模型**是 Plus 套餐包含的模型，用量算在套餐裡，不另扣費。包含哪些模型以 Plus 訂閱彈窗和產品內顯示為準。

### Plus 模型在哪裡

* 「设置 › 账户 › BYOK」分割槽的第一行：帶 AIHubMix 圖示，標「Plus 套餐包含」（未開通時為「升级到 Plus 后可用」）、模型數和 AI 助理。這一行不能刪除，也不計入 Key 數量上限。
* 模型選擇器 BYOK 頁籤的第一組。

### Plus 額度狀態

已開通 Plus 時，Plus 模型行只在額度異常時顯示狀態，不顯示金額或用量數字：

| 狀態 | 你會看到 |
| - | - |
| 達到某個週期的上限 | 「已达到本日 / 本周 / 本月用量上限，时间 恢复」 |
| 用量已用完 | 「用量已达上限」 |
| 正在準備或暫時不可用 | 「正在准备，稍后可用」或「暂时不可用」，稍後再看 |

### 選擇 Plus 模型

你可以決定 Plus 模型組裡顯示哪些模型：

1. 在 Plus 模型行點鉛筆圖示（或在模型選擇器裡懸停 Plus 模型組標題點鉛筆）。
2. 在「我的模型」裡勾選或移除模型，見 [雙欄模型選擇](#model-columns)。
3. 點「保存」。

改過之後底部出現「恢复默认」，點選恢復為套餐的全部模型；要加回之前移除的模型，也請先「恢复默认」。

## AI 助理

**AI 助理**是每個模型來源各自的後臺模型，在會話之外處理後臺任務，例如處理合併衝突、跨會話整理上下文。預設為「自动」，在該來源裡選一個低成本、低延遲的模型，通常無需修改。

要修改時，在帳戶頁對應行（Plus 模型行、訂閱帳號行或 Key 行）點「AI 助理 · 模型名」選擇；新增訂閱帳號或 API Key 時視窗裡也可以「修改」。

## 自帶訂閱

**自帶訂閱**是把你自己的訂閱帳號接入 AIHubMix Cloud，模型用該帳號的訂閱額度執行。登入授權在你自己的雲主機裡完成，AIHubMix 不儲存、不中轉你的訂閱憑據。

### 支援的訂閱

能新增哪些訂閱以「添加订阅账号」視窗為準，每個服務商下寫明連線方式和對應的 Harness（「默认使用 X」）：

| 訂閱 | 連線方式 |
| - | - |
| ChatGPT | 瀏覽器登入，也可「改用设备码登录」 |
| Claude | 授權碼登入 |
| OpenCode | 授權令牌 |
| GitHub Copilot | 裝置碼登入 |
| GLM | 貼上 Key |

* 套餐等級由授權的帳號決定，不需要手動選擇。
* 「添加订阅账号」置灰時表示暫不能新增；已連線的帳號照常可用。

### 新增訂閱帳號

開始前請確認雲主機正在執行，否則會提示「云主机还没有运行，请先到“云主机”页确认运行中再连接」。

1. 開啟「设置 › 账户」，在「自带订阅」分割槽點「添加订阅账号」（已有帳號時點「+」）。也可以在模型選擇器訂閱頁籤為空時點「连接订阅」。
2. 選擇服務商，確認「名称」（用來區分同一家的多個帳號），點「继续」。
3. 閱讀條款，勾選「我已了解并同意」，點「继续」。
4. 視窗給出「授权页地址」，可「复制」或「打开」。
5. 在瀏覽器裡登入並授權，然後按服務商完成最後一步：
   * ChatGPT（瀏覽器登入）：登入後瀏覽器會跳到一個打不開的頁面，複製位址列裡的整條地址，貼到「回调地址」裡，點「提交」。
   * ChatGPT（裝置碼）：在任意瀏覽器或手機上開啟連結，輸入視窗裡的「验证码」。如果無法登入，請先在 ChatGPT 帳戶的安全設定裡開啟裝置碼登入。
   * Claude：把授權頁給出的授權碼貼到「授权码」裡，點「提交」。
6. 提示「已连接 名称（邮箱）」，帳號出現在列表裡。

| 情況 | 提示 / 處理 |
| - | - |
| 這一家的帳號數已達上限 | 「这一家的订阅账号已达上限，先断开一个再添加」 |
| 雲主機版本太舊 | 「云主机需要先升级才能添加多个账号」 |
| 同一家已有一個正在新增的帳號 | 先完成或取消它 |
| 登入被取消或沒有完成 | 點「重试」 |

### 多個帳號與帳號名稱

同一家可以連線多個帳號，例如個人和公司各一個，在模型選擇器裡按名稱分組顯示。額度用完時不會自動換帳號。

* 預設名稱為服務商名，之後依次為「ChatGPT (2)」「ChatGPT (3)」…
* 改名：在帳戶頁點帳號行的鉛筆圖示。名稱不能為空，最多 32 個字元，所有訂閱帳號之間不能重名（不區分大小寫）。

### 預設帳號

同一家有多個帳號時，其中一個標「默认」，新會話用這家訂閱時預設用它。在其他帳號行點「设为默认」可以更換。

### 需要重新連線

| 帳戶頁顯示 | 你可以 |
| - | - |
| 「授权已失效，这个订阅暂时不能用」 | 點「重新连接」 |
| 「在终端手动登录，凭据 Agent 可以读取，建议从这里重新连接」 | 點「重新连接」，改為從這裡授權 |
| 其他錯誤資訊 | 按提示處理 |

重新連線：點「重新连接」後點「前往 名称 授权」，按 [新增訂閱帳號](#add-subscription) 的第 4–6 步完成。

### 斷開訂閱帳號

在帳戶頁帳號行點「断开」，帳號立即移除，不需要確認。正在用這個帳號的會話會暫停，彈出「订阅账号已断开」，可點「换模型继续」或「稍后」。

### 訂閱額度用完

會話所用訂閱帳號的額度用完時，會話暫停，已做的改動和環境都保留，並彈出「名称 额度已用完」，說明哪個額度用完、大約多久恢復。AIHubMix Cloud 不會自動切換帳號。

| 情況 | 你可以 |
| - | - |
| 同一家還有其他帳號 | 在「换用的账号」裡選一個，點「换这个账号继续」，模型不變。 |
| 沒有其他帳號 | 點「添加账号」去帳戶頁新增，或換模型繼續。 |
| 想換模型 | 點「换模型继续」開啟模型選擇器（Harness 不變），換好後會話自動繼續。 |
| 先不處理 | 點「稍后」關閉彈窗。 |

各訂閱帳號的 5 小時、7 天額度用量和重置時間，可以在「设置 › 用量」的「订阅额度」裡檢視，見 [用量與賬單記錄](https://docs.aihubmix.com/zh-Hant/cloud/settings/usage-and-billing.md)。

## BYOK

**BYOK**（Bring Your Own Key）是使用你自己新增的 API Key，由對應服務商計費。最多可以新增 10 把 Key（Plus 模型行不算），滿 10 把後「+」置灰。

### 支援的服務商

新增 API Key 時可選以下服務商，選中後自動帶出 Base URL 和介面格式：

* **閘道器**：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、月之暗面 Kimi、智譜 GLM、通義千問（阿里雲百鍊）、MiniMax、豆包（火山方舟）。
* **其他**：自定義，自己填寫 Base URL 和介面格式。

除 Anthropic 預設為「Anthropic 兼容」外，預置服務商預設都是「OpenAI 兼容」。Cloudflare AI Gateway 和 Azure OpenAI 的地址需要換成你自己的帳號、閘道器或資源名。

### 新增 API Key

1. 開啟「设置 › 账户」，點「BYOK」分割槽的「+」（「添加 API Key」）。也可以在模型選擇器 BYOK 頁籤為空時點「添加 API Key」。
2. 在「服务商」裡搜尋或選擇。需要改 Base URL 或介面格式時點「修改」。
3. 填寫「API Key」，填好後自動獲取模型，推薦模型會被自動勾選。按需增減，見 [雙欄模型選擇](#model-columns)。
4. 「名称（可选）」：不填則顯示為「服务商名 ··后四位」，最多 64 個字元。
5. 點「添加」，Key 出現在 BYOK 列表裡。

* 獲取模型失敗（含 Key 無效）時顯示原因，可以「重试」，也可以手動輸入模型名新增。
* 沒選服務商、一個模型都沒選或 Base URL 不完整時，「添加」不可點。
* 儲存後介面只顯示打碼的 Key。
* Base URL 是內網地址時，雲主機上執行的會話連不上這把 Key，只能在本地專案裡用。

### 編輯和刪除 Key

帳戶頁每把 Key 一行，行尾是鉛筆（編輯）和垃圾桶（刪除）。也可以在模型選擇器裡點組標題旁的鉛筆圖示編輯。

* 已儲存的 Key 不能更換服務商；Base URL、介面格式點「修改」後可改。
* 「API Key」留空儲存則保留原 Key，輸入新 Key 後儲存則替換。
* 點垃圾桶 Key 立即刪除，不需要確認。

### 雙欄模型選擇

Key 編輯窗和 Plus 模型編輯窗用同一套雙欄模型選擇：

* 左欄「全部模型」：推薦模型排在最前並標「推荐」，搜尋框只篩選左欄，點模型行勾選或取消。
* 右欄「已添加」：已選模型，點關閉圖示移除。
* BYOK 可以在搜尋框輸入列表裡沒有的模型 ID，點「添加「模型 ID」」新增。每把 Key 最多選 200 個模型。

### 介面格式與 Harness

每把 Key 有一個介面格式：「OpenAI 兼容」或「Anthropic 兼容」。Claude Code 需要 Anthropic 相容介面，Codex CLI 需要 OpenAI 相容介面。

格式不匹配時，模型選擇器裡這把 Key 的組置灰並寫明原因（例如「接口格式不兼容，Claude Code 不能用」）；新會話裡點其中的模型會自動換成能用的 Harness。如果你的服務同時提供另一種介面，可以在編輯窗裡改 Base URL 和介面格式，或為同一服務再新增一把 Key。

### Key 失敗時改用 Plus 模型

「BYOK」分割槽標題右側有一個開關「Key 失败时改用 Plus 模型」，預設關閉，點選即生效。

* 關閉：自帶 Key 呼叫失敗時，本輪直接報錯。
* 開啟：自帶 Key 呼叫失敗（額度用盡、限流或 Key 失效）時，本輪改用 Plus 套餐包含的模型繼續。還沒開通 Plus 時，開通後才生效。
* 還沒新增任何 Key 時開關不可用。

## 系統任務模型

「设置 › 账户」的「系统任务模型」分割槽只讀顯示後臺系統任務（例如「环境修复」「会话起名」）當前實際使用的模型，每行為「模型名 · 来源 · 强度 X」。

* 要更換，請改對應訂閱行、Key 行或 Plus 模型行的「AI 助理」。
* 顯示「读取失败」時任務本身不受影響，可以點「重试」。

## 注意與限制

* 訂閱額度用完、Key 失敗時不會自動換帳號；只有開啟「Key 失败时改用 Plus 模型」後，Key 失敗才會改用 Plus 模型。
* 刪除 Key、斷開訂閱帳號沒有二次確認，操作立即生效。
* 新增訂閱需要雲主機正在執行。
* 編輯 Key 或 Plus 模型不會改變已經開始的會話所用的模型。
* Plus 模型清單、訂閱可用模型、推薦模型以產品內顯示為準。

## 相關

* [Harness 與模型](https://docs.aihubmix.com/zh-Hant/cloud/models/harness-and-models.md)
* [模型常見問題](https://docs.aihubmix.com/zh-Hant/cloud/models/model-faq.md)
* [設定 › 帳戶](https://docs.aihubmix.com/zh-Hant/cloud/settings/account.md)
* [用量與賬單記錄](https://docs.aihubmix.com/zh-Hant/cloud/settings/usage-and-billing.md)
* [Plus 套餐](https://docs.aihubmix.com/zh-Hant/cloud/plus/plus-plan.md)


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