Chatbox 配置
Chatbox 适合聊天、翻译、写文案和简单图片理解。它的配置入口比较直观，适合第一次学习 Key、Base URL、模型名怎么填。
官方信息 下载和文档以官方站点为准
适合什么场景
文字对话翻译改写多模型切换新手优先
配置前先确认什么
| 要准备的内容 | 从哪里拿 | 新手注意 |
|---|---|---|
| API Key | 服务商后台的令牌、Key 或 API Key 页面 | 只复制 Key 本身，不要复制备注名、创建时间或前后空格 |
| Base URL / API Host | 服务商后台的 API 地址、接口地址或 Endpoint | 整段复制；是否带 /v1 以后台示例为准 |
| 模型 ID / 模型名 | 服务商后台模型列表 | 优先获取模型列表；获取不到时再手动填后台给出的原始标识 |
| 余额和权限 | 服务商后台的余额、模型分组或可用模型 | 余额不足、模型未授权时，配置看起来正确也会失败 |
配置项怎么填
| 配置项 | 填写方式 |
|---|---|
| Provider | OpenAI API / OpenAI Compatible |
| API Key | 从服务商后台复制的 Key |
| API Host / Base URL | 服务商后台给出的完整 API 地址，可能带 /v1，也可能不带 |
| Model | 服务商模型列表里的模型名 |
配置步骤
- 打开 Chatbox，进入 设置 或 模型提供方。
- 服务类型选择 OpenAI API、OpenAI Compatible 或类似名称。
- 把服务商后台复制出来的 API Key 粘贴进去。
- 把 API Host / Base URL 改成服务商给你的 API 链接。不要自己随意加删
/v1。 - 模型名填服务商支持的模型，比如
gpt-4.1、deepseek-chat或后台展示的原始名称。 - 保存后新建对话，发送“请用一句话回复配置成功”。
| 字段 | 怎么填 | 新手容易错的地方 |
|---|---|---|
| API Key | 复制完整 Key | 前后多了空格、复制了备注名、Key 已被禁用 |
| Base URL | 复制后台给出的 API 链接 | 把官网首页、控制台地址、API 地址混在一起 |
| Model | 照抄模型列表 | 把显示名当模型名，或改了大小写和横线 |
可以复制到聊天框里的测试语句
请只回复：配置成功| 测试结果 | 优先检查 | 怎么处理 |
|---|---|---|
| 提示 Unauthorized / invalid api key | API Key | 重新复制 Key，确认没有多余空格，Key 没有禁用或过期 |
| 提示 model not found | 模型 ID / 模型名 | 回服务商后台复制模型列表里的原始标识，不要填中文显示名 |
| 连接超时或网络错误 | Base URL / API Host | 确认填的是 API 地址，不是官网首页或控制台地址 |