模型供应商模式会先把工具指向 OcHub 的本地网关,再由 OcHub 把请求发送到当前上游。这样可以 在不反复改写工具配置的情况下切换上游,并集中处理接口转换、模型映射和用量统计。
什么时候使用模型供应商
- 多个工具需要共用同一个上游。
- 客户端与供应商使用不同的 API 接口。
- 需要模型别名、思考强度转换、统一用量统计或备用上游。
如果只是给一个工具配置一个地址,直接连接 步骤更少。
创建模型供应商
-
打开“模型供应商”。 如果本机已有带 API Key 的兼容配置,可先点“从现有配置导入”。
-
添加模型供应商。 填写名称、上游 API 地址和访问密钥。API 地址不要以
/v1结尾;OcHub 会按接口自动补上/v1/messages等请求路径。 -
检测可用接口。 点击“检测”,OcHub 会尝试 Anthropic Messages、OpenAI Chat 和 OpenAI Responses。自动检测失败时,按上游文档手动选择。
-
保持简单配置。 第一次使用先不要填写默认模型、模型例外或自定义思考预算。
-
保存并核对卡片。 保存前可用编辑器里的“HTTP 延迟测试”确认地址可达;保存后核对卡片上的接口标签、模型数量和启停状态。延迟正常只代表地址可达,最终仍需用真实模型请求验证。
-
在应用页面启用。 打开目标应用页面(如 Codex),在“模型供应商模式”区域点击该模型供应商的“切换”。切换成功后,该供应商标记为“当前”、按钮变为“使用中”,工具配置指向本地网关。
逐步界面示意点击画面放大,左右方向键切换步骤;蓝色描边是当前要对照的位置。
STEP 01打开模型供应商
STEP 02填写供应商名称、地址和密钥
STEP 03检测支持的接口
STEP 04保持首次模型规则简单
STEP 05保存并检查供应商卡片
STEP 06让目标应用切换到模型供应商
切换模型供应商
之后的切换同样在应用页面完成:
- 在目标应用页面的“模型供应商模式”区域(已启用时显示为“当前模型供应商”)选择一个已启用的模型供应商。
- 点击切换后,OcHub 只更新本地路由,不再反复改写工具配置。
- “当前模型供应商”会标记正在使用的供应商,并显示其默认模型或模型映射数量。
验证请求路径
- 启动目标 CLI 并发起一条短请求。
- 在 OcHub 用量 → 请求日志中查找来源为“模型供应商请求”的记录。
- 打开请求详情,核对请求模型、实际计价模型、Provider、状态和延迟。
如果工具报告无法连接,先确认 OcHub 仍在运行,然后检查模型供应商是否处于“已启用”状态。
让其他工具接入
“其他工具接入”区域会提供本机地址和本地密钥。任何支持 OpenAI Chat 接口的本机工具都可以 使用这组信息。
断开与恢复
- 在应用的连接页面删除指向该模型供应商的连接,即可解除这个应用与模型供应商的关系。
- 正被应用使用的模型供应商无法删除,对话框会列出受影响的应用;先把这些应用切换到其他模型供应商或直接连接,再删除。
- 停用正在使用的模型供应商会让相关工具的请求立即失败;停用前先把这些应用切换到其他模型供应商或直接连接。
- 要回到直接连接,在对应应用页面选择一个直接连接并切换。
需要模型映射、接口例外或故障转移时,继续阅读路由实战。

