> ## 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/cn/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/cn/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/cn/cloud/models/harness-and-models.md)
* [模型常见问题](https://docs.aihubmix.com/cn/cloud/models/model-faq.md)
* [设置 › 账户](https://docs.aihubmix.com/cn/cloud/settings/account.md)
* [用量与账单记录](https://docs.aihubmix.com/cn/cloud/settings/usage-and-billing.md)
* [Plus 套餐](https://docs.aihubmix.com/cn/cloud/plus/plus-plan.md)


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