Model Hub

• 供应商与路由：配置模型从哪里来，以及每个 Agent 怎样用到它们。
• 工具：Vibey 可调用的工具，包括网页搜索和本机优先的网页读取，以及真实使用中观察到的状态，见使用托管工具。
• 用量：查看网关计量的调用，见查看用量。
• 订阅额度：查看每个添加为模型供应商的订阅的额度，以及它的用量按 API 价格值多少，见查看订阅额度。

• 模型供应商列出你拥有的订阅、模型 API Key 和搜索／读取服务。它是资产清单，不是优先级列表；纯服务供应商不提供模型。
• 路由展示每个 Agent 后端，以及每个型号的有效路由链；它可以继承默认路由，也可以来自已保存的手动覆盖。

选择由谁管理后端

迁移已保存的 API Key

添加供应商

添加订阅

1. 在模型供应商里选择添加订阅，再选择供应商。
2. Claude 订阅需要选择由谁持有登录：默认选中添加为模型供应商，另一个选项是由 Agent 管理。
3. 选择去登录，完成供应商的登录流程。

• Claude：选择由 Agent 管理时，Claude Code 继续使用本机登录，这个订阅只供给 Claude Code。Anthropic 的订阅条款只覆盖它自己的应用（如 Claude Code 和 claude.ai），Avibe 会在 Claude 选项下方用一行字说明。把 Claude 订阅加入模型网关前，请先阅读 Anthropic 的条款。
• ChatGPT 和其他订阅只能添加为模型供应商。Codex 已经登录时仍然支持它的原生登录，但额度耗尽时不会触发网关接管，用量也不会进入 Model Hub。

添加 API Key

1. 选择添加 API Key。
2. 选择供应商。选 DeepSeek、Qwen、Kimi 等时，会自动填好官方地址和 API 格式；其他情况选择其他供应商 · 自己填写地址。然后输入可选名称、Base URL 和 API Key。自定义 Base URL 可以指向中转、聚合或自建兼容服务。
3. 选择添加。保存前，Avibe 会实际连接一次，完成鉴权、识别接口并拉取型号列表。

维护型号列表

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

配置默认路由

管理后端的型号列表

添加型号

• 没有供应商列出的目录型号会显示在模型目录分组里，并标着供应商未列出。选中后，会按目录信息直接添加：厂商自己的型号 ID（例如 claude-fable-5-2）、上下文和输出上限、输入类型以及推理强度档位，不弹出表单。Avibe 不会检查你的供应商是否提供它；如果没有供应商提供，使用时聊天里会说明。
• 你的供应商和模型目录里都没有这个型号时，把「x」添加为自定义模型会按默认参数直接添加你输入的 ID，不弹出表单。
• **添加自定义模型…**会打开完整的编辑器，用来按自己的参数添加 ID。

从型号选择器添加

• 添加模型只对由模型网关管理的后端显示，并且只对实例 Owner 显示，因为只有 Owner 能修改 Model Hub。由 Agent 管理的后端列出的是它自己的原生型号。
• 添加失败时会出现提示，弹窗和已选的型号都会保留。

使用 Fast 模式

• 当 Model Hub 通过说这个模型自家协议的 API Key 或订阅调用它时，就能使用 Fast：OpenAI 或 Anthropic 的 API Key（官方地址或中转都可以），或者由 Model Hub 托管的 ChatGPT、Claude 订阅。由 Agent 管理的后端和 OpenCode 不能使用。
• 每次回复都会报告这次是否真的以 Fast 运行。中转可能丢掉这个请求，或者按标准速度提供服务。如果某次 Fast 回复没有得到确认，菜单箭头旁的闪电会变成空心，思考强度下面也会有一行提示。Fast 仍然保持开启，你也可以随时打开或关闭。下一次 Fast 回复会再检查一次，供应商一确认，闪电就会变回实心。用量统计只把确认过的 Fast 回复按 Fast 价格计算。
• 切换到不支持 Fast 的模型时，开关状态会保留，但聊天按标准速度运行；切换回来后，会再次以 Fast 模式运行。
• 在 Web 界面新建的聊天会沿用你上一次的选择。从聊天软件发起的聊天、定时任务和 vibe agent run 都使用标准速度。
• 如果供应商拒绝 Fast 模式，比如 Claude 订阅没有开通额外用量额度，这次回复会改用标准速度，不会失败。
• Fast 模式费用更高。OpenAI 和 Anthropic 按各自更高的价格计费，ChatGPT 订阅会消耗更多额度，Claude 订阅从额外用量额度中扣除。具体价格以供应商为准。

编辑型号路由

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

恢复自动路由

看懂状态

查看用量

搜索与读取服务用量

查看订阅额度

• 近 7 天按 API 价格：最近 7 天。
• 本期按 API 价格：账号在价格覆盖文件里设置了续费日时，统计当前计费周期；否则显示近 30 天按 API 价格。
• 回本：把这段时间的价值和套餐月费相比，显示为月费的倍数，或还差多少回本。

修正价格

{
  "models": {
    "my-relay-model": {"input": 3, "output": 15, "cache_read": 0.3, "cache_write": 3.75},
    "relay-alias": {"alias": "claude-sonnet-5"}
  },
  "plans": {"team_seat": {"fee_usd": 30}},
  "sources": {"src_abc123": {"plan": "team_seat", "renewal_day": 14}}
}

• 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）设置计费周期每月续费的日期；短月份没有这一天时，按该月最后一天续费。

使用托管工具

添加搜索服务

1. 打开模型 > 工具 > 网页搜索 > 添加搜索服务，或模型供应商 > 添加供应商 > 搜索服务。
2. 选择 Tavily、**Exa（使用 API Key）**或 DeepSeek。弹窗会展示各厂商的价格、免费额度信息，以及查询发送到哪里的说明。
3. 输入厂商的 API Key 并保存。Tavily 和使用 API Key 的 Exa 会创建提供搜索和读取、不提供模型的纯服务供应商。DeepSeek 创建使用官方端点、同时提供模型、搜索和读取的普通 DeepSeek 供应商；已有符合条件的供应商会复用其密钥。DeepSeek 中转供应商不会继承这些服务 API。

内置免密 Exa

搜索怎样运行

• **原生：**模型厂商在模型调用中完成搜索。
• **搜索服务：**模型网关把查询发送给 Tavily、使用 API Key 的 Exa、内置免密 Exa，或 DeepSeek 的搜索 API。内置 Exa 不使用密钥。
• **模型代搜：**另一个供应商的轻量模型代替 Vibey 运行该厂商的原生搜索；供应商必须列出符合条件的代搜模型。

Gemini 的 Google 搜索

• 查询发往哪里： Google 在模型调用中执行搜索。按 Google 的 Gemini API 附加条款，Google 会把提示、你提供的上下文和输出保存 30 天，用于生成基于搜索的回答。
• 费用： Google 按模型执行的每个搜索查询计费。Gemini 3 及以后的模型每月共享 5,000 次免费查询，之后每 1,000 次 $14（Google 的价格，复核于 2026 年 10 月 29 日）。一次回答可能执行多个查询。付费层的默认上限是每个项目每天 1,500 次基于搜索的请求。
• 来源： Google 给出的每个来源都是它自己在 vertexaisearch.cloud.google.com 上的跳转链接，所以引用的链接文字显示这个域名。模型先搜索、再调用其他工具时，来源以引用的形式出现在回答里，不显示在搜索卡片上。
• 搜索建议： Google 随搜索结果返回的搜索建议（Search Suggestions），Avibe 不会显示，尽管 Google 的条款要求应用显示它们。请按你的用途查看这些条款。要让 Gemini 改按搜索顺序执行，可以关闭优先用模型自带的搜索；这个开关作用于所有模型。

读取网页

• 工具总开关可以关闭网页读取。每一行还有独立的用于网页读取开关；关闭某个服务的读取开关不会改变搜索设置。
• 读取顺序始终可见。用上移／下移按钮排序；停用行仍显示在末尾。恢复自动移除手动顺序。Jina 默认排在最后，手动排序后不固定在最后。
• 改动从下一个回合生效。页面无法读取或执行项不可用时，链会尝试下一个符合条件的项，但策略拒绝或本机遇到登录限制会终止执行。立即重试只清除服务冷却，不会发送测试请求。Exa 的冷却与网页搜索共享，但两个开关独立。

URL 和内容会发给谁

读取费用和限制

兼容端点

• OpenAI Responses 端点上，gpt- 模型运行 OpenAI 的网页搜索，grok-4 模型运行 xAI 的网页搜索和 X 搜索；列出了这些厂商的轻量模型时也能代为搜索，列出了 gpt-image-2 时还会提供它。
• Anthropic Messages 端点上，Claude 模型运行 Claude 的网页搜索，列出的 Claude Haiku 模型可以代为搜索。
• Chat Completions 端点上，没有原生搜索；列出了 Gemini 的图片模型时会提供它们。

状态与拒绝记录

恢复搜索服务

生成图片

• 厂商有标价时显示标价，例如 Grok Imagine 的 $0.02 / 张；
• 能按 token 价格估算时显示估算，标 ≈，例如 Nano Banana 的 ≈ $0.067 / 张；
• 两者都没有时显示暂无单价，例如 gpt-image-2，OpenAI 按图像 token 计费；
• 订阅供应商上的模型显示订阅内含。

费用

• API Key 按厂商 API 标价估算，中转的实际账单可能不同。
• 订阅不另计费。
• 原生搜索和模型代搜遵循厂商的搜索及模型 token 计费规则。搜索服务请求单独计价；模型读取搜索结果所用的 token 仍属于模型调用。
• Claude 订阅不提供托管搜索或图片生成；网页读取使用自己的本机／服务链。

供应商详情

在对话中

降级前须知

理解报错并恢复

最近已记录回合

模型页面上的提示

回合里的提示

按原因恢复

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