---
title: "配置模型供应商"
description: "创建本地网关上游、在应用页面启用，并确认请求经过 OcHub。"
version: "zh"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ochub.org/zh/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置模型供应商

模型供应商模式会先把工具指向 OcHub 的本地网关，再由 OcHub 把请求发送到当前上游。这样可以
在不反复改写工具配置的情况下切换上游，并集中处理接口转换、模型映射和用量统计。

## 什么时候使用模型供应商

- 多个工具需要共用同一个上游。
- 客户端与供应商使用不同的 API 接口。
- 需要模型别名、思考强度转换、统一用量统计或备用上游。

如果只是给一个工具配置一个地址，[直接连接](/zh/getting-started/direct-connection)
步骤更少。

## 创建模型供应商

1. **打开“模型供应商”。** 如果本机已有带 API Key 的兼容配置，可先点“从现有配置导入”。

2. **添加模型供应商。** 填写名称、上游 API 地址和访问密钥。API 地址不要以 `/v1` 结尾；OcHub 会按接口自动补上 `/v1/messages` 等请求路径。

3. **检测可用接口。** 点击“检测”，OcHub 会尝试 Anthropic Messages、OpenAI Chat 和 OpenAI Responses。自动检测失败时，按上游文档手动选择。

4. **保持简单配置。** 第一次使用先不要填写默认模型、模型例外或自定义思考预算。

5. **保存并核对卡片。** 保存前可用编辑器里的“HTTP 延迟测试”确认地址可达；保存后核对卡片上的接口标签、模型数量和启停状态。延迟正常只代表地址可达，最终仍需用真实模型请求验证。

6. **在应用页面启用。** 打开目标应用页面（如 Codex），在“模型供应商模式”区域点击该模型供应商的“切换”。切换成功后，该供应商标记为“当前”、按钮变为“使用中”，工具配置指向本地网关。

## 切换模型供应商

之后的切换同样在应用页面完成：

1. 在目标应用页面的“模型供应商模式”区域（已启用时显示为“当前模型供应商”）选择一个已启用的模型供应商。
2. 点击切换后，OcHub 只更新本地路由，不再反复改写工具配置。
3. “当前模型供应商”会标记正在使用的供应商，并显示其默认模型或模型映射数量。

## 验证请求路径

- 启动目标 CLI 并发起一条短请求。
- 在 OcHub **用量 → 请求日志**中查找来源为“模型供应商请求”的记录。
- 打开请求详情，核对请求模型、实际计价模型、Provider、状态和延迟。

如果工具报告无法连接，先确认 OcHub 仍在运行，然后检查模型供应商是否处于“已启用”状态。

## 让其他工具接入

“其他工具接入”区域会提供本机地址和本地密钥。任何支持 OpenAI Chat 接口的本机工具都可以
使用这组信息。

> **本地密钥不是上游密钥**
>
> 这里的密钥由 OcHub 在本机生成和验证，只用于访问本地网关，不能拿到其他电脑或上游服务中使用。
> 不要把本地监听地址暴露到公网。

## 断开与恢复

- 在应用的连接页面删除指向该模型供应商的连接，即可解除这个应用与模型供应商的关系。
- 正被应用使用的模型供应商无法删除，对话框会列出受影响的应用；先把这些应用切换到其他模型供应商或直接连接，再删除。
- 停用正在使用的模型供应商会让相关工具的请求立即失败；停用前先把这些应用切换到其他模型供应商或直接连接。
- 要回到直接连接，在对应应用页面选择一个直接连接并切换。

需要模型映射、接口例外或故障转移时，继续阅读[路由实战](/zh/advanced/routing-recipes)。

Source: https://docs.ochub.org/zh/getting-started/relay/index.mdx