Chatbox 是很多普通用户最容易上手的 AI 客户端之一。它不像开发框架那样需要你写代码，只要填好 API 地址、API Key 和模型名，就能把第三方 API 接进聊天窗口里使用。
这篇文章适合第一次配置 Chatbox 的新手。本文以 147AI的API 接口文档 的流程为例：先在控制台充值、创建令牌，再从模型广场确认模型支持的 API 类型和模型名，最后把这些信息填入 Chatbox。
开始前准备
你需要先准备好：
- Chatbox 已安装
- 第三方 API 账户余额大于 0
- 已创建 API Key / 令牌
- 已从模型广场复制模型名
- 已确认模型详情页里的 API 端点
- 已确认这个模型支持哪一种 API 接口
如果只是测试配置，建议先用轻量模型，不要一开始就用高成本模型跑长文本。
第一步：添加 AI 模型提供方
打开 Chatbox 设置页，找到「模型提供方」。不同版本的 Chatbox 文案可能不完全一样，常见入口包括：
- OpenAI
- OpenAI Responses
- Gemini
- Claude / Anthropic
- 自定义服务商 / Custom Provider
这里不要只看模型名字，还要看模型详情页里写的 API 端点。不同模型服务商可能支持不同接口，例如：
- OpenAI Chat Completions API：常见路径是
/v1/chat/completions - OpenAI Responses API：常见路径是
/v1/responses - Anthropic API：Claude 原生接口常见路径是
/v1/messages - Gemini API：Gemini 原生接口使用 Google Gemini 的接口格式，也可能由平台额外提供 OpenAI 兼容端点
如果模型详情页显示它支持 openai: /v1/chat/completions，就可以优先按 OpenAI 兼容方式添加。如果显示的是 anthropic: /v1/messages，说明它更接近 Claude 原生接口，应选择 Chatbox 里的 Claude / Anthropic 相关配置。如果显示的是 Gemini 原生接口，就不要直接放到 OpenAI 兼容配置里测试；只有模型详情页明确提供 OpenAI 兼容端点时，才按 OpenAI 兼容方式配置。
简单说：先确认模型详情页支持的 API 类型，再在 Chatbox 里选择对应的服务商配置。不要把所有模型都默认当成 OpenAI 兼容接口。
第二步：填写 API 地址
常见写法是：
text
https://147ai.com/v1多数 Chatbox 这类面向普通用户的客户端会自动补全
/chat/completions、/responses或其他接口路径，所以它们的输入框一般要填 Base URL，而不是完整 HTTP 接口。
这类自动补全的好处是门槛低：用户只填 Base URL、API Key 和模型名，客户端负责把请求发到对应的聊天接口。
在少数情况中若 Chatbox 当前版本要求填写完整 Endpoint，再按模型详情页里的 API 端点填写。比如 OpenAI Chat Completions 兼容接口可能类似：
text
https://147ai.com/v1/chat/completions如果是 Claude 原生接口，路径可能是：
text
https://147ai.com/v1/messages不要把两种写法混着填。Base URL 输入框通常填到 /v1，完整接口地址输入框才填到 /chat/completions、/responses 或 /messages。如果你是自己写后端 HTTP 请求或用 curl 调接口，就属于不自动补全的场景，要写完整接口地址；Chatbox 这种客户端通常不需要这样做。
第三步：填写 API Key
把控制台「令牌管理」生成的 Key 粘贴到 API Key 输入框。常见格式类似：
text
sk-xxxxxxxx注意不要多复制空格，也不要把 Key 贴到模型名输入框里。
第四步：填写模型名
模型名从模型广场复制，不要手写。填完后保存配置。
如果 Chatbox 支持添加多个模型，可以先添加一个轻量模型用于测试，再添加正式使用的大模型。
第五步：发送最小测试
若当前版本提供 Verify/测试 等类似功能的按钮，先点击测试；如果没有，就用短问题测试返回，并到 147AI 控制台查看调用记录、余额变化或日志确认。
常见问题
Q1：报 401/403 error 怎么办？
检查 API Key 是否完整、账户余额或额度是否可用、令牌分组/权限是否允许调用该模型。
Q2：404
先确认 API Host 与 API Path 没有重复拼接 /v1；再按模型详情页判断应填 Base URL、API Path，还是完整 Endpoint。
Q3：model not found
模型名不匹配。回模型广场复制完整模型名，并确认令牌分组支持该模型。
Q4：能文本聊天，但图片不行
图片等能力不仅取决于模型是否支持，也取决于服务商是否透传、Chatbox 是否支持并正确配置该模型能力。
总结
Chatbox 接入第三方 API，本质就是四步：选对模型服务商、填 Base URL、填 API Key、填模型名。最容易出错的地方不是 Key，而是把接口类型选错。
配置前先看模型详情页：如果它写的是 OpenAI Chat Completions，就选 OpenAI 兼容配置；如果写的是 Anthropic、Gemini 或 Responses，就要选择对应的服务商或接口类型。遇到 404 或请求失败时，也优先回到模型详情页核对 API 端点。