第一次配置提供商
提供商（Provider）就是给你提供 LLM 服务的厂商，比如 OpenAI、Anthropic、Google 或者任何提供"OpenAI 兼容接口"的中转服务。ETOS LLM Studio 本身不内置任何模型，所有对话都要靠你接入的提供商。
这一页用最详细的步骤教你接好第一个提供商，确认聊天能正常返回文字。后续高级配置（请求头覆盖、表达式、原始请求体等）放在最后的「进阶选项」里，第一次不要碰。
新手必读
在动手前先准备这三样
| 准备 | 怎么拿到 |
|---|---|
| 一个有效的 API Key | 在你打算用的厂商控制台里申请。OpenAI 在 platform.openai.com/api-keys，Anthropic 在 console.anthropic.com，Google 在 aistudio.google.com/apikey。 |
| 接口的「Base URL」 | 官方厂商可以直接照抄下表。第三方中转服务在它们文档里搜「OpenAI 兼容地址」或「base_url」字段。 |
| 至少一个能用的模型 ID | 比如 gpt-4o、claude-3-7-sonnet-latest、gemini-2.5-pro。模型 ID 必须完全照抄，错一个字母都会报"模型不存在"。 |
没必要一次配齐多家
第一次只配一家最稳定的就够。等聊天链路跑通了再考虑加第二家或第三家。
各家官方的 Base URL 速查表
下表所有地址都是根地址——你只需要填到 /v1 或对应版本号那一级，App 会自动在后面拼上 /chat/completions 之类的具体路径。
| 厂商 | API 格式 | Base URL |
|---|---|---|
| OpenAI（Chat Completions 接口） | OpenAI 兼容 | https://api.openai.com/v1 |
| OpenAI（Responses 接口，推荐 GPT-4.1 / GPT-5 系列） | OpenAI Responses | https://api.openai.com/v1 |
| Anthropic Claude | Anthropic | https://api.anthropic.com/v1 |
| Google Gemini | Gemini | https://generativelanguage.googleapis.com/v1beta |
| 任何"OpenAI 兼容"中转服务 | OpenAI 兼容 | 服务商文档里的 base_url 字段 |
OpenAI 兼容 vs OpenAI Responses 怎么选？
- OpenAI 兼容（Chat Completions）：传统接口，几乎所有第三方中转都支持这个。如果你接的不是 OpenAI 官方，几乎只能选这个。
- OpenAI Responses：OpenAI 在 GPT-4.1 之后推荐的新接口，支持更强的推理摘要、工具调用、跨轮状态保持。只有 OpenAI 官方端点支持。
不确定就先选「OpenAI 兼容」，跑通后再回来切换。
完整操作步骤
下面以 OpenAI 官方为例，其他家流程几乎一样，差别只在第 4、5、6 步要填的具体值。
步骤 1：打开提供商列表
聊天页 → 底部 Tab Bar 点「设置」
→ 在「对话行为」分组里找到「提供商与模型管理」
→ 点进去进去之后你会看到一个空列表（或者只有一条默认占位项）。页面标题写着「提供商与模型管理」。
步骤 2：添加一个新提供商
点右上角的「+ 添加提供商」按钮（图标是一个加号）。
会出现「添加提供商」表单，分成四个 Section：基础信息、认证、代理（提供商级）、请求头覆盖。
步骤 3：填写「基础信息」
| 字段 | 填什么 |
|---|---|
| 提供商名称 | 自己给它起个显示名，会出现在模型选择列表里。比如「OpenAI 官方」「我的中转」「Claude」都行。 |
| API 地址 | 填上面速查表里对应的 Base URL。注意结尾不要多 /，也不要带上 /chat/completions 这种具体路径。 |
| API 格式 | 从下拉里选。OpenAI 官方默认选「OpenAI 兼容」，其他家按速查表对应。 |
容易翻车的细节
- Base URL 末尾不要多斜杠（
/v1而不是/v1/） - 不要把
https://漏掉 - 中转服务的 base_url 如果给的是
https://xxx.com/v1/，结尾的/去掉再粘
步骤 4：填写「认证」
| 字段 | 填什么 |
|---|---|
| API Key | 把你从厂商控制台复制的 Key 粘进去。只粘 Key 本身，前后不要加 Bearer 、不要带引号。 |
| 显示明文 | 一个 Toggle，开了之后会显示 Key 全文方便你检查有没有粘错。检查完关上。 |
一个提供商可以放多个 Key
如果你有多张 Key 想轮询使用（防止单 Key 用量耗尽），用英文逗号把多个 Key 拼在一起，比如 sk-aaa,sk-bbb,sk-ccc。每次请求会按顺序自动轮换。
步骤 5：「代理（提供商级）」先跳过
如果你的网络能直连厂商，不要打开"使用独立代理"。所有代理配置等基础链路跑通后再说。
步骤 6：「请求头覆盖」先跳过
第一次配置不要碰这里。这是给需要塞自定义 HTTP Header 的高级场景用的（比如某些中转要求 X-Org-ID）。
步骤 7：保存
点右上角的「保存」。如果有字段填错（比如 Base URL 为空），保存按钮会变灰，按提示补全即可。
保存成功后会自动跳回提供商列表，看到你刚配好的那一条。
步骤 8：进入这个提供商，添加模型
点击你刚配的提供商那一行，进入「提供商配置」详情页。底部会有一个空的「模型」区域。
你有两种方式添加模型：
- 从云端获取：右上角有一个云朵图标按钮（无障碍标签是「从云端获取」）。点它会向厂商发一次
GET /models请求，自动把这个 API Key 能用的模型列表拉下来。优先用这个——省事且不会拼错模型 ID。 - 手动添加：旁边的「+」按钮（标签是「添加模型」）。手动填模型 ID（比如
gpt-4o-mini）和显示名。适用于厂商不提供/models端点的情况。
模型加进来之后，点开模型行最右侧的开关让它变成"已启用"。没启用的模型在聊天页是看不到的。
步骤 9：做个连通性测试
提供商配置页右上角还有一个测试按钮（无障碍标签「模型测试」）。点它会自动用这个 Key 发一次最小请求，看是不是真的能通。这是第一次配置最有用的功能——不用回聊天页发消息也能验证。
测试结果只有两种：
- ✅ 绿色"测试通过"：万事 OK，可以继续。
- ❌ 红色错误：根据错误提示对照下面的「常见错误」一节。
步骤 10：回设置页选定为"当前模型"
回到「设置」最顶部的「当前模型」分组，点「模型」一行，从弹出的列表里选你刚启用的模型。
到这里你才算真正配完——可以去 第一次发起聊天 测试了。
常见错误对照表
| 错误提示 | 真实原因 | 怎么修 |
|---|---|---|
401 Unauthorized / "鉴权失败" | API Key 错 / 已过期 / 复制时多了空格 | 重新去厂商控制台复制 Key，注意首尾不要带空格 |
404 Not Found | Base URL 写错，或最后多了/少了路径 | 对照速查表重新填 Base URL |
"模型不存在" / model not found | 模型 ID 写错，或这个 Key 没开通这个模型 | 用「从云端获取」让 App 自己拉列表，从里面选 |
| "连接超时" / "网络错误" | 网络无法直连厂商 / 需要代理 | 见进阶选项里的代理配置 |
429 Too Many Requests | 触发了厂商速率限制 | 等几分钟再试，或者换更高额度的账户 |
进阶选项
下面所有内容只在基础聊天跑通之后再考虑。
自定义请求头（Header Override）
某些第三方中转或企业内部接口要求额外的 HTTP Header，比如 X-Org-ID、Authorization: Bearer xxx-yyy 这种自定义格式。
位置：编辑提供商 → 请求头覆盖 → 点「添加表达式」。
写法：每行一条，格式是 key=value，比如：
User-Agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64)
X-Org-ID=org_abc123
Authorization=Bearer {api_key}{api_key} 占位符：会被自动替换成当前请求使用的 API Key（如果你配了多 Key 轮询，会替换成轮询到的那一个）。这对那些要求把 Key 放在自定义 Header 而不是标准 Authorization 里的服务非常有用。
提供商级代理
如果你的网络无法直连厂商，可以为这个提供商配独立代理：
位置：编辑提供商 → 代理（提供商级） → 打开「使用独立代理（优先于全局）」
| 字段 | 说明 |
|---|---|
| 启用代理 | 总开关，关闭后这一组配置不生效 |
| 代理类型 | 支持 HTTP / HTTPS 和 SOCKS5 两种 |
| 代理地址 | 主机名或 IP，比如 127.0.0.1 |
| 端口 | 1～65535 之间的整数。常见值：HTTP 代理 8080 / 7890，SOCKS5 1080 |
| 用户名（可选） | 代理鉴权用户名；填了之后会自动启用鉴权 |
| 密码（可选） | 代理鉴权密码 |
全局代理 vs 提供商级代理
ETOS 同时提供「全局代理」（设置 → 提供商与模型管理 → 全局代理）和"提供商级代理"。提供商级配置的优先级更高：如果某个提供商打开了"使用独立代理"，它会忽略全局代理。
适合的场景：A 厂商需要走代理，B 厂商在国内能直连——给 A 单独配代理，B 不动。
多 API Key 轮询
「认证」里 API Key 字段支持英文逗号分隔多个 Key：
sk-aaaaaaaaaa,sk-bbbbbbbbbb,sk-cccccccccc每次发请求会自动按顺序轮询。如果某个 Key 触发 429 或鉴权失败，下一次会自动跳过用下一个。
不同能力分配不同模型
ETOS 把模型按"能力"分槽。同一个提供商下可以让 GPT-4o 当聊天模型、whisper-1 当语音输入模型、tts-1 当 TTS 模型，互不冲突。
位置：设置 → 「对话行为」分组里的「偏好设置」/「语音朗读（TTS）」/「语音输入」/「图片生成」/「每日脉冲」等各自的子页面，每个能力里都有独立的"专用模型"选择器。
模型高级参数（参数表达式 / 原始 JSON 请求体）
在「提供商与模型管理」列表里点击具体某个模型进入「模型配置」页，里面可以：
- 给单个模型覆盖默认参数（temperature、top_p 等）
- 编写参数表达式：用模板语法动态计算参数值（比如根据消息长度调整
max_tokens） - 直接编辑原始 JSON 请求体：在发出之前最后修改请求 body，适合接入某些非标准接口
这部分内容详见 聊天与模型 进阶选项小节。
下一步
提供商配好、连通性测试通过、当前模型选定 → 第一次发起聊天