> 内容来源：Onevium 官方文档
> 文章: 连接服务商与选择模型
> 原文: https://onevium.com/zh/docs/providers
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.22
> 功能状态: 已发布

---

# 连接服务商与选择模型

查看 Onevium 的服务商预设，区分 Claude Code 登录与 API Key，完成连接、模型选择和真实任务验证。

## 先选择连接方式

Onevium 有两条模型连接路径：

| 方式             | 适合的情况                            | 如何使用                                                                                          |
| -------------- | -------------------------------- | --------------------------------------------------------------------------------------------- |
| Claude Code 登录 | 使用已有的 Claude Code 账户登录或订阅授权      | 打开 Claude Code 连接状态面板，使用登录入口。应用会在内置终端启动随应用提供的 Claude Code 登录流程；完成后选择模型菜单里的 **Claude Code** 分组 |
| 服务商 API Key    | 使用 Anthropic API、其他预设厂商，或团队的兼容网关 | 打开 **设置 → 服务商**，添加凭据，再在模型菜单选择该服务商                                                             |

登录 Onevium、激活 Onevium 许可证与取得模型服务的使用权限是不同事项。Claude 订阅登录也不会生成可填入服务商表单的 API Key。

## 准备正确的账户与凭据

准备对应产品、地区和账户的 API Key，确认账户有权使用目标模型。Coding Plan、普通开放平台以及中国区和国际区可能使用不同的入口；按自己账户所属产品选择预设。

密钥填入专门的 **API Key** 字段，不发送到聊天，也不放进截图。选择 Bearer 认证时仍填写原始凭据，不自行添加 `Bearer ` 前缀。

## 查看内置预设

以下是 1.1.22 提供的 **9 个聊天预设**。它们使用 Anthropic/Claude 兼容接口；普通 OpenAI 兼容接口不能直接替代。

| 界面名称              | 地区或产品入口           | 预填 Base URL                              | 认证方式                  |
| ----------------- | ----------------- | ---------------------------------------- | --------------------- |
| Anthropic         | 官方 API            | `https://api.anthropic.com`              | API Key / `x-api-key` |
| DeepSeek          | 开放平台 API          | `https://api.deepseek.com/anthropic`     | Bearer Token          |
| GLM (CN)          | 中国区 GLM Code Plan | `https://open.bigmodel.cn/api/anthropic` | Bearer Token          |
| z.ai (Global)     | 国际区 GLM Code Plan | `https://api.z.ai/api/anthropic`         | Bearer Token          |
| Kimi Coding Plan  | Kimi Coding Plan  | `https://api.kimi.com/coding`            | API Key / `x-api-key` |
| Moonshot (CN)     | Moonshot 中国区 API  | `https://api.moonshot.cn/anthropic`      | API Key / `x-api-key` |
| Moonshot (Global) | Moonshot 国际区 API  | `https://api.moonshot.ai/anthropic`      | API Key / `x-api-key` |
| MiniMax (CN)      | 中国区 Code Plan     | `https://api.minimaxi.com/anthropic`     | Bearer Token          |
| MiniMax (Global)  | 国际区 Code Plan     | `https://api.minimax.io/anthropic`       | Bearer Token          |

预设会带入名称、地址、认证方式和模型配置，连接时通常只需填写 API Key。模型目录来自应用预设，不是实时查询你账户所得的可用清单；最终要以该账户的实际请求结果为准。

**图像生成单独配置：**

| 界面名称                  | 用途                 | 预设地址                                               | 凭据             |
| --------------------- | ------------------ | -------------------------------------------------- | -------------- |
| Google Gemini (Image) | 使用 Google 官方接口生成图像 | `https://generativelanguage.googleapis.com/v1beta` | Google API Key |

它位于 **Media Providers**，不会出现在聊天模型分组里。不要将它当作 Gemini 聊天接入；修改地址也不代表支持第三方图像代理。

## 例子：连接 DeepSeek 预设

1. 打开 **设置 → 服务商**，找到 **添加服务商**。
2. 在聊天服务商列表中找到 **DeepSeek**，点击 **连接**。
3. 粘贴 DeepSeek 账户的 API Key。预设会自动带入表中的 Anthropic 兼容地址和 Bearer 认证。
4. 检查 **Visible models / 可见模型**，按需要显示或隐藏模型，至少保留一个。暂时保留高级选项的默认配置。
5. 点击 **连接**。记录出现在“已连接的提供商”后，关闭设置。
6. 打开一个会话，在输入框的模型菜单中找到刚添加的 DeepSeek 分组，选择账户可用的模型。

保存记录不会自动完成联网测试，也不会替你切换所有会话。其他聊天预设的添加过程相同，使用各自账户的凭据即可。

![DeepSeek 预设连接表单](https://onevium.com/assets/docs/providers-connect-zh.png "真实组件的隔离示例：填写自己的 API Key，并选择可见模型；保存配置后仍需验证实际请求。")

## 选择模型、切换连接与管理可见性

开始任务前核对输入框中的服务商和模型。模型菜单按服务商分组；同名模型可能属于不同的连接。以界面中的选择为准，不用模型在回复中自报的名字判断实际接入。

在 **设置 → 服务商 → 已连接记录 → Models / 模型** 中调整显示与隐藏。这只管理模型菜单，不会撤销 API Key。每个服务商至少保留一个可见模型；需要补充真实模型 ID 时，见[自定义服务商](https://onevium.com/zh/docs/providers/custom#model-routing)。

服务商连接在应用内共享，会话保存自己的选择。输入框也会记住最近的选择。渠道与自动化有独立配置，不会因为你在当前会话换了模型就全部改变。

**Disconnect / 断开连接会删除服务商记录，不是暂停。** 使用前先检查仍引用它的会话、渠道和自动化，并将它们改为可用连接。日常换模型直接在输入框选择，无需先删除旧服务商。

## 分两层验证连接

先点击已连接记录旁的听诊器图标，打开 **Provider 诊断**。它检查本地凭据配置、认证冲突、地址和模型记录，**不会请求上游服务**。诊断通过后还要完成真实验证。

第一步，发送一个只需文字回复的小请求：

```text
用一句话确认收到这条消息。
不要读取文件或执行命令。
```

确认所选连接能够回复，再验证实际需要的工具。打开一个有 README.md 的测试项目，发送：

```text
只读取项目根目录的 README.md，概括其中的运行步骤。
如果文件不存在就说明，不要创建或修改文件，也不要执行命令。
```

检查是否出现实际文件读取工具及其返回结果。文字回复成功，不代表图像、长上下文或全部工具都可用。准备交给渠道或自动化的任务，应在对应入口再验证一次。

## 排查常见问题

| 现象                 | 优先检查                                                                         |
| ------------------ | ---------------------------------------------------------------------------- |
| 401 或认证失败          | Key 是否属于当前地区和产品；认证字段是否匹配 `x-api-key` 或 Bearer；不要重复添加另一套认证环境变量                |
| 模型不存在或无权访问         | 当前服务商、真实模型 ID、账户权限；预设目录不等于账户已开通的模型                                           |
| 自定义连接仍显示 Claude 模型 | 是否未填写模型映射或自定义模型条目；按[自定义配置步骤](https://onevium.com/zh/docs/providers/custom)补齐 |
| 超时或连接失败            | Base URL、网络和 **设置 → 网络代理**；代理地址不能填进 Base URL。代理测试成功也不证明模型凭据有效                |
| 文字正常，工具报错          | 查看失败工具与上游错误；确认接口支持 Claude 兼容工具调用，换一个具备所需能力的模型再测试                             |
| 换电脑后提示密钥无法解密       | 编辑该服务商，重新输入原账户的 API Key 并保存                                                  |
| 渠道或自动化仍使用旧模型       | 回到对应渠道或自动化配置，检查它自己的服务商和模型选择                                                  |

## 下一步

团队网关或需要自填字段时，阅读[添加自定义服务商](https://onevium.com/zh/docs/providers/custom)。连接可用后，继续[第一个任务](https://onevium.com/zh/docs/getting-started)，并了解[权限与计划](https://onevium.com/zh/docs/permissions)及[设置与数据](https://onevium.com/zh/docs/settings-and-data)。