Model Hub

Model Hub 是 Avibe 默认的本地模型网关。它把上游凭据和路由留在你的机器上，让多个 Agent 后端共享同一个来源，并在当前来源因可恢复问题无法继续供给时，把请求交给路由链里的下一个来源。 打开 模型 > 来源与网关。页面分成两部分：

• 来源列出你拥有的订阅和 API Key。它是资产清单，不是优先级列表。
• 网关展示每个 Agent 后端，以及每个型号的有效路由链；它可以继承默认路由，也可以来自已保存的手动覆盖。

​

选择网关或直连

全新安装默认使用网关模式。已有安装如果还没有 Model Hub 配置，会保持直连，直到你在模型页面逐个切换后端。 模式按后端分别设置，并且可以随时切回。切回直连会保留来源和路由链，但该后端会重新使用自己的原生配置。网关路由链里的原生跳仍然属于网关模式：这条链的故障切换和恢复仍由 Avibe 管理。

​

添加来源

​

添加订阅

1. 在来源里选择添加订阅，再选择厂商。
2. 选择凭据保留在哪里。
3. 选择去登录，完成厂商登录流程。

推荐选项因厂商而异：

• Claude：推荐原生使用，由 Claude Code 使用本机登录。你也可以明确选择登录为网关来源，把它供给其他 Agent，但 Avibe 会在登录前显示账号可能受限的警告。
• ChatGPT：推荐登录为网关来源，这样可以看到用量、额度和接管状态。仍然支持 Codex 原生登录，但额度耗尽时不会触发网关接管，用量也不会进入 Model Hub。

每个后端只能有一个原生来源，因为官方 CLI 只暴露一个当前登录。其他账号请添加为网关持有的来源。两种方式可以并存，但需要分两次添加。

​

添加 API Key

1. 选择添加 API Key。
2. 输入可选名称、Base URL 和 API Key。自定义 Base URL 可以指向中转、聚合或自建兼容服务。
3. 选择添加。保存前，Avibe 会实际连接一次，完成鉴权、识别接口并拉取型号列表。

拉取型号会执行同样的检查，但不会保存任何内容。如果 Avibe 已经连通却无法识别接口，请选择一次性的接口提示并重试。这个提示只改变探测顺序；Avibe 仍然要从真实响应中确认接口，才能保存来源。接口一旦保存就固定不变；要更换接口类型，请新建来源。 如果接口已经识别，但型号列表没有返回，你可以重试，或选择仍要添加。来源会在没有已发现型号清单的情况下保存，之后可以在来源详情里手动添加型号。

​

维护型号列表

来源添加成功后，Avibe 会打开来源详情 > 型号。你可以在这里：

• 选择重新拉取，检查已保存的来源、更新健康状态并刷新自动发现的型号。这是已保存来源唯一的刷新动作。
• 在自动发现找不到型号时手动添加。
• 编辑任意自动拉取或手动添加型号所接受的精确推理强度档位。系统不会默认选中或预填任何档位。
• 移除手动添加的型号。上游返回的型号由重新拉取维护。

重新拉取会保留手动型号和你编辑过的推理强度档位。清单变化可能改变自动匹配结果。如果某项变更会移除有效路由中的跳，或让型号失去供给，Avibe 会先列出受影响的跳和型号，再请你确认。拉取失败时，页面保留它最后一次真正读到的列表。 对于 API Key 来源，型号清单是匹配依据，不是唯一允许供给的型号列表。缺少记录不会阻止 API Key 请求，移除手动添加的型号也不会删除已保存的路由。明确标记为退役的来源与型号组合不能再使用。后端支持的型号、来源兼容性、凭据和健康状态仍然有效；未知型号不会自动获得来源未为该精确型号声明的推理强度档位。 订阅无论登录为网关来源还是原生使用，都保留现有型号支持范围。它们仍会参与自动匹配和手动路由，但新增或修改订阅跳时，仍须通过现有的型号清单和退役检查。路由设置不会扩展网关或原生 CLI 对订阅型号的支持。

​

配置默认路由

在网关里选择一个后端，打开默认路由，选择默认来源并排列顺序。没有已保存非空手动覆盖的型号会遵循这些默认设置；已保存的空链也会继承默认设置。每条有效路由链都是有序的精确组合：来源，以及实际要调用的上游型号。 例如，两个 API Key 来源的默认顺序为 A、B，请求的型号是 model-x。如果只有 B 列出了 model-x，链里就只有 B。如果两者都没列出它，路由链则为 A、B，每一跳都使用原样的 model-x。它不会在已知匹配的 B 之前先尝试未匹配的 A。 Avibe 先按默认顺序加入所有符合条件的匹配，包括匹配的订阅。只有完全没有匹配时，才会按默认顺序向符合条件的 API Key 来源原样传递请求的型号 ID。订阅不会作为未知型号透传的候选。原生 Claude 匹配支持其已知别名和版本；其他后端和 API 来源使用精确型号 ID。暂时不可用不会让已匹配的链变成透传。 新型号自动遵循默认设置。默认来源成员、顺序或匹配依据发生变化时，继承的路由随之更新；已保存的手动链保持不变。弹窗会显示多少型号继承默认设置、多少型号已有覆盖。变更只作用于当前后端。 如果调整默认来源成员会移除有效路由中的跳、让型号失去供给，或影响正在执行的请求，Avibe 会列出精确影响并请你确认。仅重排同一组来源不需要移除确认。从默认设置中移除来源，会保留使用它的手动路由；删除来源本身则通过另一项受确认保护的变更移除相关引用。

​

编辑型号路由

在网关里打开型号查看路由链。对于继承的路由，选择编辑路由开始手动草稿。你可以：

• 添加或移除一跳；
• 调整各跳顺序；
• 修改某一跳明确指定的上游型号映射，也可以输入 API Key 来源型号清单中没有的精确 ID；
• 选择保存，把非空路由链存为手动覆盖。

手动跳可以使用未列入该后端默认设置的兼容来源。保存非空链会创建手动覆盖，即使它与自动结果完全相同。空链视为没有覆盖：保存它会恢复继承路由，而不是禁用型号。 如果保存配置需要重启网关，Avibe 会先等待现有请求的传输完成或关闭，包括流式响应，再重启。变更应用期间，新请求会等待；保存不会截断正在进行的流式响应。 Avibe 使用第一个当前可运行的跳。如果某一跳已经被阻塞，或在输出开始前遇到允许回退的额度、限流、上游或网络故障，Avibe 才会继续尝试后面的跳。被阻塞的跳仍会留在计划中的位置；暂时的健康状态变化不会重排路由链或替换型号。

​

恢复自动路由

在路由弹窗底部选择恢复自动，预览继承的路由链。移除手动草稿的最后一跳，也会进入同样的恢复预览。这只改变草稿，结果也可能是透传或未配置。撤销恢复会还原之前的手动草稿。 选择保存时，Avibe 会检查有效路由的实际影响，必要时请你确认，再移除覆盖并应用继承路由。保存成功前，已保存的路由保持不变。取消或关闭弹窗不会写入任何修改。保存失败时，草稿会保留，供你重试。

​

看懂状态

每个型号的路由标记说明这条链从何而来： 悬停或聚焦标记可查看说明，触屏上轻点也可查看，不会打开路由弹窗。按 Escape 或在说明外操作即可关闭。这些标记描述路由的来源方式，不表示来源健康，也不保证上游接受该型号；停止网关不会改变路由的来源方式。 如果继承后没有符合条件的跳，型号会显示未配置，包括默认来源只有订阅、且没有匹配的型号。使用配置默认路由选择符合条件的默认来源，或保存一条非空手动路由。健康状态变化和请求错误不会改变路由的来源方式。 来源行会显示以下状态： 每个网关后端都会针对当前选中的型号显示一种供给状态： 只有当第一跳因可恢复问题不可用、请求交给后面的跳时，页面才会显示接管中。成功接管不会在对话里插入通知。模型页面会展示当前来源、暂停的原路径和临时替代来源；第一跳恢复后，下一个回合会自动回到它，而且不会改变你保存的顺序。

​

理解报错并恢复

​

最近已记录回合

路由弹窗会读取仍保留的、可精确归属到当前后端和型号的最近已结束回合。如果该回合以终止错误结束，最近已记录回合会显示记录时间，以及当时的来源和型号。查看错误详情打开同一条记录的安全结构化详情，包括原因，以及已记录的 HTTP 状态和实际观察到的错误码（如有）。其中不包含上游原始报错文本或凭据。 后续记录为成功或取消，或没有保留记录时，不会显示旧错误面板。读取失败可选择重试。这里并不记录每个请求：OpenCode 共享进程中的请求无法精确归属到某个回合时，仍不跟踪。 错误码取决于上游协议实际返回的内容。观察到 model_not_found 时才会显示型号不存在的说明；通用的 Anthropic not_found_error 不会被改写成该错误码。没有具体错误码时，面板使用记录的原因。路由标记和来源健康状态与这些详情分别展示。

​

模型页面上的提示

​

回合里的提示

​

按原因恢复

• **冷却或接管：**等待页面显示的重试时间。恢复以及回到第一跳都会自动发生，不会改变路由链。
• 订阅登录过期：按该来源的需要重新登录操作处理。
• 余额耗尽：到厂商处充值，然后打开来源详情并选择重新拉取。
• **API Key 被吊销：**在现有来源上替换 Key，再重新拉取。来源身份和所有路由位置都会保留。
• **账号受限：**按厂商给出的方式处理，或把受影响型号移到其他来源。
• 未分类异常：修复可能的上游问题，再使用重新拉取。当前检查成功后会清除阻塞。
• **上游拒绝该型号：**核实精确型号 ID 和上游支持情况，再编辑型号或路由。仅仅未出现在 API Key 来源拉取的清单中，不代表型号不可用；订阅仍遵循现有型号检查。
• **来源已不存在：**编辑路由链。重新添加一个来源不会修复仍指向已删除来源的跳。
• **原生 CLI 不可用：**恢复对应后端的本地 CLI 和登录，再重试。
• 需要立即绕开问题：只把受影响的后端切换到直连。来源和路由链会保留，之后切回时仍可继续使用。