Model Hub 在你的机器上把你自己的模型路由给 Agent。它不同于模型服务：模型服务为语音输入等 Avibe 功能提供云端模型。
- 供应商与路由：配置模型从哪里来，以及每个 Agent 怎样用到它们。
- 用量：查看网关计量的调用，见查看用量。
- 订阅额度：查看每个登录为网关来源的订阅的额度，以及它的用量按 API 价格值多少，见查看订阅额度。
- 来源列出你拥有的订阅和 API Key。它是资产清单，不是优先级列表。
- 网关展示每个 Agent 后端，以及每个型号的有效路由链；它可以继承默认路由，也可以来自已保存的手动覆盖。
选择网关或直连
全新安装默认使用网关模式。已有安装如果还没有 Model Hub 配置，会保持直连，直到你在模型页面逐个切换后端。 模式按后端分别设置，并且可以随时切回。切回直连会保留来源和路由链，但该后端会重新使用自己的原生配置。网关路由链里的原生跳仍然属于网关模式：这条链的故障切换和恢复仍由 Avibe 管理。添加来源
添加订阅
- 在来源里选择添加订阅，再选择厂商。
- 选择凭据保留在哪里。
- 选择去登录，完成厂商登录流程。
- Claude：推荐原生使用，由 Claude Code 使用本机登录。你也可以明确选择登录为网关来源，把它供给其他 Agent，但 Avibe 会在登录前显示账号可能受限的警告。
- ChatGPT：推荐登录为网关来源，这样可以看到用量、额度和接管状态。仍然支持 Codex 原生登录，但额度耗尽时不会触发网关接管，用量也不会进入 Model Hub。
添加 API Key
- 选择添加 API Key。
- 输入可选名称、Base URL 和 API Key。自定义 Base URL 可以指向中转、聚合或自建兼容服务。
- 选择添加。保存前，Avibe 会实际连接一次，完成鉴权、识别接口并拉取型号列表。
维护型号列表
来源添加成功后，Avibe 会打开来源详情 > 型号。你可以在这里：- 选择重新拉取，检查已保存的来源、更新健康状态并刷新自动发现的型号。这是已保存来源唯一的刷新动作。
- 在自动发现找不到型号时手动添加。
- 编辑任意自动拉取或手动添加型号所接受的精确推理强度档位。系统不会默认选中或预填任何档位。
- 移除手动添加的型号。上游返回的型号由重新拉取维护。
配置默认路由
在网关里选择一个后端，打开默认路由，选择默认来源并排列顺序。没有已保存非空手动覆盖的型号会遵循这些默认设置；已保存的空链也会继承默认设置。每条有效路由链都是有序的精确组合：来源，以及实际要调用的上游型号。 例如，两个 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 会检查有效路由的实际影响，必要时请你确认，再移除覆盖并应用继承路由。保存成功前，已保存的路由保持不变。取消或关闭弹窗不会写入任何修改。保存失败时，草稿会保留，供你重试。看懂状态
每个型号的路由标记说明这条链从何而来：
悬停或聚焦标记可查看说明，触屏上轻点也可查看，不会打开路由弹窗。按 Escape 或在说明外操作即可关闭。这些标记描述路由的来源方式，不表示来源健康，也不保证上游接受该型号；停止网关不会改变路由的来源方式。
如果继承后没有符合条件的跳，型号会显示未配置，包括默认来源只有订阅、且没有匹配的型号。使用配置默认路由选择符合条件的默认来源，或保存一条非空手动路由。健康状态变化和请求错误不会改变路由的来源方式。
来源行会显示以下状态：
已保存使用中性样式，旁边的连接状态说明只解释状态，不要求你修复问题。成功调用模型后，待验证状态会更新。实际发生的冷却、凭据或异常状态会优先显示。
每个网关后端都会针对当前选中的型号显示一种供给状态：
只有当第一跳因可恢复问题不可用、请求交给后面的跳时，页面才会显示接管中。成功接管不会在对话里插入通知。模型页面会展示当前来源、暂停的原路径和临时替代来源；第一跳恢复后，下一个回合会自动回到它，而且不会改变你保存的顺序。
查看用量
打开模型 > 用量，查看网关实际计量的调用。趋势图位于明细表上方。
页面会展示实际返回的时间范围，以及运行 Avibe 的机器所用的 UTC 偏移。
小时统计从支持记录它的版本开始。旧版本只有日汇总的用量仍计入每日总数，
不会被重新分摊到小时中。它可能归属的小时会标为不完整，并提示
含无具体小时记录的历史用量。旧记录没有时区信息时，这个范围可能覆盖相邻日期。
已记录的小时数值仍可查看，但不完整历史不代表完整的零用量。
多选供应商或模型，可同时筛选汇总、图表和明细。供应商对应配置的来源，
因此即使两个账号使用同一家厂商或相同显示名称，也会保持独立。
指标可选全部 Tokens、输入、输出、缓存读取或请求数。Token 趋势可按
Token 类型、模型或供应商分组，也可显示总量；请求数支持总量、模型和供应商分组。
按模型分组时，不同来源上的同一模型仍分别展示。图例显隐只影响图表，不改变报表筛选。
模型或供应商系列超过六个时，颜色会重复；可通过名称、详情或筛选来区分。
悬浮或点击时间点可查看精确数值，点击其他区域会关闭普通详情。
详情角落的图钉按钮用于明确固定或取消固定该时间点。固定后，点击其他区域
仍会保留详情，下方明细只展示该时段；取消固定后，明细恢复筛选后的完整时间范围。
按 Escape 可关闭详情并清除固定状态；改变时间范围、筛选条件、指标或图表分组
也会清除固定状态。使用键盘时，可聚焦时间点并按 Enter 或空格，将焦点移到固定按钮。
明细表显示已记录的计数，可按模型或供应商分组。点击当前指标列的表头可切换排序方向。
导出 CSV 使用当前筛选条件和已固定时段，按时间桶导出供应商/模型明细，
而不是复制表格的分组或排序。文件包含起止时间和历史完整标记，不可用的 token 数值留空。
供应商 ID 异常长时，CSV 的供应商 ID 列可能是缩短后的内部账本键，而不是原始 ID。
输入已经包含缓存输入。总 Tokens 等于输入加输出；按 Token 类型分组时，
则拆成非缓存输入、缓存读取和输出。缓存占比的分母是全部输入。请求数统计的是上游调用，因此一次 Agent 回合在发生回退时可能贡献多次请求。
Token 计数依赖上游返回的用量报告，未上报不等于零用量。
这些统计不包含绕过网关的调用。折合 API 价格是估算：同样的用量按厂商公开的 API 标价要花多少钱，不是实际扣费。
页面会显示所用价格表的日期，每一天都按这份当前价格表计算。
带 ≥ 的数字是下限：有请求没有上报 token 数、有用量暂无价格，或部分历史不完整。
没有已知价格的模型显示暂无价格：它们不计入总额，也不按零计算，页面会显示未计入的 token 数。
要补充或修正价格，见修正价格。
查看订阅额度
打开模型 > 订阅额度，查看所有登录为网关来源的订阅。页面每 5 分钟自动刷新，立即刷新可马上重新读取。 每个账号按厂商报告的额度显示，例如 5 小时额度、每周额度，以及单独计算的模型每周额度， 包括已用比例、重置时间，以及按当前速度能否用到重置。读取失败时，页面保留上一次的数据并注明是多久以前的； 不提供额度数据的订阅会直接说明。 页面还会把每个账号经网关计量的用量折合成 API 价格，算法和查看用量相同：- 近 7 天按 API 价格：最近 7 天。
- 本期按 API 价格：账号在价格覆盖文件里设置了续费日时，统计当前计费周期；否则显示近 30 天按 API 价格。
- 回本：把这段时间的价值和套餐月费相比，显示为月费的倍数，或还差多少回本。
修正价格
价格来自 Avibe 已经为型号选择器缓存的 models.dev 目录。 要给目录没有收录的模型定价、修正价格，或设置账号的套餐，可以创建~/.avibe/state/model_hub_prices.json。每次页面读取用量时都会重新读这个文件，所以修改会在下次读取时生效，不需要重启。
这个文件里的条目优先于 models.dev。
所有字段都是可选的：
models以型号 ID 为键，价格单位是每 100 万 tokens 的美元价。input和output必填；cache_read、cache_write（5 分钟缓存）和cache_write_1h可选。缺少cache_read或cache_write时按输入价计算， 缺少cache_write_1h时按输入价的两倍计算。条目也可以不写价格，改写alias，沿用另一个型号的价格。 匹配型号 ID 时会去掉日期后缀、[1m]这类方括号后缀和provider/前缀。超过 128 个字符的键会被忽略。plans为某个套餐键设置或新增月费，单位是美元。内置的键有claude_pro、claude_max_5x、claude_max_20x、chatgpt_plus和chatgpt_pro。sources以来源 ID 为键，来源 ID 可以在用量页导出的 CSV 的「供应商 ID」列里找到；Avibe 创建的来源 ID 形如src_abc123。 如果这一列显示的是缩短后的内部账本键，覆盖无法匹配它。plan设置账号的套餐， 优先于厂商报告的套餐；它可以是内置键、你在plans里添加的键，或者max 20x这样的厂商套餐名。renewal_day（1–31）设置计费周期每月续费的日期；短月份没有这一天时，按该月最后一天续费。
input 或 output 无效时整个型号条目被忽略，该型号继续使用 models.dev 的价格；可选价格无效时按缺省处理。
整个文件无法读取时，Avibe 会忽略它，只用 models.dev 定价。
理解报错并恢复
最近已记录回合
路由弹窗会读取仍保留的、可精确归属到当前后端和型号的最近已结束回合。如果该回合以终止错误结束，最近已记录回合会显示记录时间，以及当时的来源和型号。查看错误详情打开同一条记录的安全结构化详情，包括原因，以及已记录的 HTTP 状态和实际观察到的错误码（如有）。其中不包含上游原始报错文本或凭据。 后续记录为成功或取消，或没有保留记录时，不会显示旧错误面板。读取失败可选择重试。这里并不记录每个请求：OpenCode 共享进程中的请求无法精确归属到某个回合时，仍不跟踪。 错误码取决于上游协议实际返回的内容。观察到model_not_found 时才会显示型号不存在的说明；通用的 Anthropic not_found_error 不会被改写成该错误码。没有具体错误码时，面板使用记录的原因。路由标记和来源健康状态与这些详情分别展示。
模型页面上的提示
回合里的提示
按原因恢复
- **冷却或接管：**等待页面显示的重试时间。恢复以及回到第一跳都会自动发生，不会改变路由链。
- 订阅登录过期：按该来源的需要重新登录操作处理。
- 余额耗尽：到厂商处充值，然后打开来源详情并选择重新拉取。
- **API Key 被吊销：**在现有来源上替换 Key，再重新拉取。来源身份和所有路由位置都会保留。
- **账号受限：**按厂商给出的方式处理，或把受影响型号移到其他来源。
- 未分类异常：修复可能的上游问题，再使用重新拉取。当前检查成功后会清除阻塞。
- **上游拒绝该型号：**核实精确型号 ID 和上游支持情况，再编辑型号或路由。仅仅未出现在 API Key 来源拉取的清单中，不代表型号不可用；订阅仍遵循现有型号检查。
- **来源已不存在：**编辑路由链。重新添加一个来源不会修复仍指向已删除来源的跳。
- **原生 CLI 不可用：**恢复对应后端的本地 CLI 和登录，再重试。
- 需要立即绕开问题：只把受影响的后端切换到直连。来源和路由链会保留，之后切回时仍可继续使用。