Chatbox 配置
Chatbox 是一款跨平台 AI 客户端，支持 Windows、macOS、Linux、iOS 和 Android。通过它的自定义模型提供方功能，可以把 LAYSO AI 配置为 OpenAI、Responses、Anthropic 或 Gemini 兼容服务。
一个 Key，访问全平台模型
一个 LAYSO AI API Key 可以访问平台全部可用模型。系统按所选模型的当前价格计费；每个成功请求都有独立扣费明细，失败任务不会产生扣费。
前提条件
- 在 API Key 页面 创建并复制密钥。
- 在 模型与价格页面 选择模型，并复制页面显示的完整模型 ID。
- 从 Chatbox 官网 安装适合当前设备的版本。
不要猜测模型名称
模型 ID、上下文长度和能力以模型与价格页面为准。不要自行删除厂商前缀，也不要照抄本教程之外的示例模型名。
协议与地址
Chatbox 可以为自定义提供方选择不同的 API 模式。请根据模型支持的协议填写对应地址：
| Chatbox API 模式 | API 主机 | 适用场景 |
|---|---|---|
| OpenAI API 兼容 | https://api.layso.ai/v1 | Chat Completions、工具调用、视觉理解 |
| OpenAI Responses API 兼容 | https://api.layso.ai/v1 | Responses API 模型与新项目 |
| Anthropic Claude API 兼容 | https://api.layso.ai | Anthropic Messages 原生兼容 |
| Google Gemini API 兼容 | https://api.layso.ai | Gemini 原生兼容 |
地址规则
OpenAI 两种模式使用 https://api.layso.ai/v1；Anthropic 和 Gemini 模式使用网关根地址 https://api.layso.ai。不要在末尾重复添加 /v1、/messages、/v1beta 或具体请求路径。
桌面端配置
第 1 步：打开设置
启动 Chatbox，点击侧边栏左下角的 设置 / Settings。
/screenshots/chatbox/01-open-settings.png建议截图：标出桌面端左下角的设置入口。第 2 步：添加模型提供方
选择左侧的 模型提供方 / Model Provider，然后点击列表底部的 + 添加 / Add Provider。
/screenshots/chatbox/02-add-provider.png建议截图：标出模型提供方菜单和 + 添加按钮。第 3 步：选择 API 模式
名称填写 LAYSO AI，再按照目标模型选择协议：
- 常规对话优先选择 OpenAI API 兼容。
- 明确需要 Responses API 时选择 OpenAI Responses API 兼容。
- 使用 Anthropic 原生请求格式时选择 Anthropic Claude API 兼容。
- 使用 Gemini 原生请求格式时选择 Google Gemini API 兼容。
协议选择完成后点击 添加 / Add。
/screenshots/chatbox/03-select-api-mode.png建议截图：展示提供方名称和四种 API 模式。第 4 步：填写连接信息
根据所选 API 模式填写：
| Chatbox 字段 | 填写内容 |
|---|---|
| 名称 | LAYSO AI |
| API 密钥 | 从 API Key 页面 复制的完整密钥 |
| API 主机 | 使用上方协议表中的对应地址 |
填写后点击 获取 / Fetch 拉取模型列表。API 密钥只应粘贴在密钥字段中，不要放入名称或模型字段。
/screenshots/chatbox/04-provider-fields.png建议截图：完整展示 API 密钥、API 主机和获取按钮；密钥必须打码。第 5 步：启用模型
在获取到的模型列表中，点击目标模型右侧的 + 将它加入启用列表。
如果列表为空或缺少目标模型：
- 打开 模型与价格页面。
- 复制完整模型 ID。
- 返回 Chatbox 手动添加模型。
- 模型类型选择 聊天 / Chat。
- 按模型页面说明勾选视觉、推理和工具使用等能力。
/screenshots/chatbox/05-enable-model.png建议截图：展示模型列表、+ 按钮和能力选项。第 6 步：检查连接
点击 检查 / Check，选择一个已经启用的模型进行测试。
出现“连接成功”后再保存。如果检测窗口分别测试文本、图片或工具调用，只需要模型支持的能力显示成功；不支持的能力不要强行开启。
/screenshots/chatbox/06-connection-success.png建议截图：显示测试模型和连接成功结果。手机端配置
Chatbox 的 iOS 和 Android 版本使用相同的 LAYSO AI 地址，但入口布局与桌面端不同。
第 1 步：打开设置并添加提供方
点击左上角菜单按钮打开侧边栏，再进入 设置，选择 添加模型提供方。
填写：
- 名称：
LAYSO AI - API 模式：根据上方协议表选择
- API 密钥：从 API Key 页面 复制
- API 主机：使用上方协议表对应地址
/screenshots/chatbox/07-mobile-provider.png建议截图：展示手机端名称、API 模式、密钥和 API 主机字段。第 2 步：配置模型参数
保存提供方后进入模型配置：
- 从 模型与价格页面 复制完整模型 ID。
- 模型类型选择 聊天 / Chat。
- 仅勾选该模型实际支持的视觉、推理或工具调用能力。
- 保存模型。
第 3 步：测试连接
点击 测试模型 / Test Model。连接成功后返回主界面；如果测试失败，请按下方排查顺序检查。
/screenshots/chatbox/08-mobile-test.png建议截图：显示手机端模型测试成功结果。开始使用
- 关闭设置并返回 Chatbox 主界面。
- 点击输入框附近的模型选择器。
- 在
LAYSO AI分组下选择刚启用的模型。 - 发送一条简短消息，确认回复正常。
/screenshots/chatbox/09-first-chat.png建议截图：显示 LAYSO AI 分组、所选模型和首次回复。验证与计费
首次对话成功后检查：
- Chatbox 当前提供方为
LAYSO AI。 - 返回的模型与所选完整模型 ID 一致。
- 在 用量日志 中能够看到这次成功请求的逐笔扣费。
- 失败请求没有产生扣费。
- 截图、日志和导出的配置中没有完整 API Key。
常见问题
点击“获取”后模型列表为空
- 确认 API 主机与所选 API 模式匹配。
- 去掉地址末尾多余的
/，并检查是否重复追加协议路径。 - 重新复制 API Key，确保没有空格或换行。
- 仍无法获取时，从 模型与价格页面 手动添加完整模型 ID。
检查连接失败
- 确认网络可以访问
https://api.layso.ai。 - 确认 API Key 仍然有效。
- 确认模型 ID 与 API 模式兼容。
- 保存后完全退出并重新打开 Chatbox。
提示 401 或 403
重新从 API Key 页面 复制密钥。不要使用其他平台的 Key，也不要把 Bearer 前缀手动粘贴进 Chatbox 的 API 密钥字段。
提示 404
通常是 API 模式与主机地址不匹配：
- OpenAI 和 Responses：
https://api.layso.ai/v1 - Anthropic 和 Gemini：
https://api.layso.ai
不要在 API 主机中填写 /chat/completions、/responses、/messages 或 /v1beta/models 等完整端点。
文本成功，但视觉或工具调用检测失败
该模型可能不支持对应能力，或者模型能力开关配置错误。请以 模型与价格页面 的能力说明为准。
隐私与安全
- 不要在截图、聊天内容、日志或工单中发送完整 API Key。
- 公共设备使用后删除自定义提供方和密钥。
- 若怀疑密钥泄露，请立即在 API Key 页面 删除旧 Key 并创建新 Key。
- Chatbox 是第三方客户端；本地存储、同步与数据处理行为以 Chatbox 官方说明为准。
替换图片位置
本页只预留图片位置。把截图放入 docs/public/screenshots/chatbox/，再把占位块替换为普通 Markdown 图片，例如：
