零代码使用 AI API 教程：客户端配置到首次对话全流程

开头：10 分钟完成首次对话，零代码

不会编程也能用 AI API。准备好三样东西：服务商给的接口地址（Base URL）、密钥（API Key）、模型名称（如 gpt-4）。选择支持"自定义服务商"的客户端，填入这三项信息，即可开始对话。

实测成本：首次测试消耗约 0.02-0.05 元（基于 OpenOx 1 元起充，2026-08-14 实测）。整个流程不需要安装开发工具，也不需要写代码。

本文基于 Chatbox 和 Cherry Studio 两款主流客户端的真实配置流程，带你完成从零到首次对话的全部步骤。

准备工作

你需要的三样东西

AI API 服务商账号
- 推荐新手选择：OpenOx（1 元起充，赠送 $3 测试额度）
- 或：UU API（1 元起充，进群赠送额度）
- 注册后获得：Base URL、API Key
支持自定义服务商的客户端（选其一）
- Chatbox：https://chatboxai.app/
- Cherry Studio：https://cherry-ai.com/
- 两者都支持 Windows/Mac/Linux，界面简洁，适合新手
小额测试预算
- 最低 1 元即可开始测试
- 首次对话消耗约 0.02-0.05 元
- 建议充值 5-10 元，足够测试 100-200 次对话

预计时间

注册服务商账号：3-5 分钟
下载安装客户端：2-3 分钟
配置 API 信息：3-5 分钟
首次对话测试：1-2 分钟

总计：10-15 分钟

安全提醒

⚠️ 下载客户端时：

只从官网或 GitHub Releases 下载
不要使用网盘分享的"修改版"
客户端能读取你的密钥和对话内容

⚠️ 填写密钥时：

不要在截图中暴露完整密钥
不要在群聊中分享密钥
为每个客户端创建独立密钥

详细步骤

第 1 步：获取 API 信息

操作：

登录你的 API 服务商账号（本文以 OpenOx 为例）
点击页面右上角的"控制台"或"Dashboard"
在左侧菜单找到"API 密钥"或"API Keys"

填写：

点击"创建新密钥"按钮
名称填写：测试客户端
额度限制：设置 5 元（可选，防止误用）
点击"确认创建"

验证：创建成功后，你会看到三项关键信息：

Base URL: https://api.openox.tech/v1
API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
可用模型: gpt-4, gpt-3.5-turbo, claude-3-sonnet...

结果：

✅ 复制 Base URL 到记事本
✅ 复制 API Key 到记事本（只显示一次，关闭后无法再查看）
✅ 复制一个模型名称（如 gpt-4）

⚠️ 注意：API Key 通常以 sk- 开头，完整长度约 48-51 个字符。如果复制时不小心多了空格或换行，后续会报 401 错误。

🖼️ 需要补充截图：OpenOx 控制台 → API 密钥页面 → 创建密钥弹窗

第 2 步：下载并安装客户端

操作（以 Chatbox 为例）：

访问 https://chatboxai.app/
点击页面中央的"Download"按钮
选择你的操作系统（Windows/Mac/Linux）

填写：

Windows：下载 .exe 安装包
Mac：下载 .dmg 文件
Linux：下载 .AppImage 文件

验证：

Windows：双击安装包，按提示安装
Mac：拖动到 Applications 文件夹
Linux：赋予执行权限后直接运行

结果：打开 Chatbox，首次启动会看到欢迎界面，提示"选择 AI 服务商"。

🖼️ 需要补充截图：Chatbox 官网下载页 + 首次启动欢迎界面

第 3 步：配置自定义服务商

操作：

点击 Chatbox 左下角的"设置"图标（齿轮形状）
在设置页面找到"AI 服务商"或"Model Provider"
点击"添加自定义服务商"或"Add Custom Provider"

填写（按顺序逐项填写）：

① 服务商名称：

OpenOx（或你的服务商名称）

② API 协议：

下拉选择：OpenAI Compatible（OpenAI 兼容）
大部分中转站都使用这个协议

③ Base URL：

https://api.openox.tech/v1

⚠️ 注意：

不要丢掉末尾的 /v1
不要多加斜杠变成 /v1/
确认 https:// 协议头完整

④ API Key：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 注意：

粘贴时确认前后无空格
完整长度约 48-51 个字符
如果复制不完整，会报 401 错误

⑤ 模型列表：

点击"添加模型"
输入模型 ID：gpt-4
可选：继续添加 gpt-3.5-turbo、claude-3-sonnet 等

验证：填写完成后，页面应该显示：

✅ 服务商名称旁有绿色对勾
✅ 模型列表显示你添加的模型
✅ 没有红色错误提示

结果：点击页面右下角的"保存"或"Save"按钮，配置生效。

🖼️ 需要补充截图：Chatbox 设置页面 → 添加自定义服务商表单（已填写示例数据）

第 4 步：首次对话测试

操作：

回到 Chatbox 主界面
点击左上角的"新建对话"或"New Chat"
在模型选择器中选择你刚才配置的 gpt-4

填写：在对话框中输入以下测试文本（建议复制）：

请只回复四个字：连接成功

为什么用这个测试：

✅ 请求短，响应快（通常 1-2 秒）
✅ 费用低（约 0.01 元）
✅ 结果明确，容易判断是否成功

验证：正常情况下，AI 会回复：

连接成功

或类似的四个字（如"连接正常"）。

结果： ✅ 如果收到回复：

说明配置成功
可以进行下一步完整测试

❌ 如果报错：

跳转到下方"常见错误"章节排查

第 5 步：完整功能测试

操作：在同一对话中，发送以下长文本测试：

请总结以下文字的三个要点：

人工智能技术正在快速发展，大语言模型的能力不断提升。
从文本生成到图像理解，AI 已经可以处理多种类型的任务。
然而，如何让这些强大的模型服务更多用户，如何降低使用门槛，
仍然是当前需要解决的重要问题。API 服务的出现，
让普通用户也能便捷地使用这些先进的 AI 能力。

验证： AI 应该返回类似这样的三点总结：

1. AI 技术和大语言模型能力快速提升
2. AI 可以处理多种类型任务（文本、图像等）
3. API 服务降低了 AI 使用门槛

结果： ✅ 如果正常返回总结：

说明 API 完全可用
可以开始正常使用

✅ 检查账单：

返回服务商控制台
找到"用量统计"或"账单"页面
确认刚才的两次对话是否产生扣费记录

预期扣费：

第一次（短文本）：约 0.01-0.02 元
第二次（长文本）：约 0.03-0.05 元
总计：约 0.04-0.07 元

🖼️ 需要补充截图：Chatbox 对话界面（显示测试对话和 AI 回复）+ 服务商后台账单页面

结果验证

成功的标志

✅ 三个确认点：

AI 正常回复了你的测试问题
回复内容符合预期（不是乱码或错误信息）
服务商后台显示了用量扣费记录

后续使用注意

模型选择
- 新手日常使用推荐 gpt-3.5-turbo（便宜快速）
- 复杂任务再用 gpt-4 或 claude-3-sonnet
密钥管理
- 为每个客户端创建独立密钥
- 定期检查用量，设置额度提醒
备用方案
- 建议配置 2-3 家服务商
- 当一家出现故障时可以快速切换

常见错误

错误 1：401 Unauthorized

错误信息：

Error: 401 Unauthorized
Invalid API Key

原因：

API Key 复制不完整（前后有空格或少了字符）
API Key 已过期或被撤销
API Key 未激活（部分服务商需要充值后才能使用）

解决方法：

重新复制 API Key，确认完整性
在服务商后台确认密钥状态（是否启用、是否过期）
如果是新创建的密钥，等待 1-2 分钟再试
必要时删除旧密钥，创建新密钥

错误 2：404 Not Found

错误信息：

Error: 404 Not Found
The requested URL was not found

原因：

Base URL 填写错误（多了或少了路径）
常见错误示例：
- ❌ https://api.example.com（少了 /v1）
- ❌ https://api.example.com/v1/（多了末尾斜杠）
- ❌ https://api.example.com/v1/chat（多加了 /chat）

解决方法：

检查服务商文档中的标准 Base URL 格式
大部分应该是：https://域名/v1
删除多余的路径或斜杠
确认协议头是 https:// 而不是 http://

错误 3：模型不存在

错误信息：

Error: Model not found
The model 'gpt-4' does not exist

原因：

模型名称拼写错误（大小写敏感）
服务商不支持该模型
模型名称需要加前缀（如 openai/gpt-4）

解决方法：

检查服务商文档中的模型列表
确认模型名称的准确拼写：
- ✅ gpt-4
- ❌ GPT-4（大写错误）
- ❌ gpt4（少了连字符）
从服务商后台复制模型 ID，而不是手打
测试用 gpt-3.5-turbo（几乎所有服务商都支持）

错误 4：网络超时

错误信息：

Error: Request timeout
Failed to connect to API

原因：

本地网络问题
服务商 API 服务不稳定
客户端代理设置冲突

解决方法：

检查本地网络连接（能否访问其他网站）
关闭 VPN 或代理软件再试
切换到手机热点测试（排除网络环境问题）
如果持续超时，联系服务商确认服务状态
尝试切换备用服务商

费用说明

首次测试成本

基于 OpenOx（2026-08-14 价格）：

最低充值：1 元
新人赠送：3 美元测试额度
首次测试消耗：0.04-0.07 元（两次对话）

预算建议：

纯测试：充值 5 元（约 100 次对话）
日常使用：充值 20 元（约 400-500 次对话）
重度使用：充值 50-100 元

不同模型的成本

模型	输入价格	输出价格	单次对话成本
gpt-3.5-turbo	$0.50/M tokens	$1.50/M tokens	0.02-0.05 元
gpt-4	$30/M tokens	$60/M tokens	0.15-0.30 元
claude-3-sonnet	$3/M tokens	$15/M tokens	0.05-0.10 元

说明：

M tokens ≈ 750 个中文字或 1000 个英文单词
单次对话成本假设输入 100 字，输出 200 字
实际费用以服务商后台账单为准

退款政策

不同服务商退款政策：

OpenOx：支持无手续费退款（需人工审核）
UU API：不支持退款
APINebula：7 天内可退款（收取 5% 手续费）

建议：

首次充值金额不要过大（5-20 元即可）
测试满意后再充值更多
选择支持退款的服务商降低风险

安全提醒

密钥保护

❌ 不要做：

在截图中暴露完整密钥
在群聊或论坛中分享密钥
将密钥提交到公开的 Git 仓库
使用同一个密钥给多人共用

✅ 应该做：

为每个客户端创建独立密钥
为每个密钥设置额度限制（如 10 元）
定期（每月）轮换密钥
不用的密钥及时撤销

对话内容安全

⚠️ 不要在对话中发送：

身份证号、银行卡号、密码
公司内部文档、商业机密
他人隐私信息
完整的 API 密钥或访问令牌

设备切换

更换电脑时的正确操作：

在旧电脑上，到服务商后台撤销该设备的密钥
在新电脑上，创建新的密钥
不要将旧电脑的配置文件直接复制到新电脑

这样即使旧电脑遗失，也不会影响其他设备的使用。

测试信息

测试日期: 2026-08-14
测试客户端: Chatbox 1.3.5 / Cherry Studio 0.8.2
测试服务商: OpenOx、UU API
测试模型: gpt-3.5-turbo、gpt-4
参考文档:

Chatbox 官方文档：https://chatboxai.app/docs
OpenOx 快速开始：https://openox.tech/docs/quickstart

更新日志

2026-08-14: 初始版本，基于 Chatbox 1.3.5 和 OpenOx 实测
需要补充：Cherry Studio 配置流程截图
需要补充：更多服务商的配置差异说明

零代码使用 AI API 教程：客户端配置到首次对话全流程

开头：10 分钟完成首次对话，零代码

准备工作

你需要的三样东西

预计时间

安全提醒

详细步骤

第 1 步：获取 API 信息

第 2 步：下载并安装客户端

第 3 步：配置自定义服务商

第 4 步：首次对话测试

第 5 步：完整功能测试

结果验证

成功的标志

后续使用注意

常见错误

错误 1：401 Unauthorized

错误 2：404 Not Found

错误 3：模型不存在

错误 4：网络超时

费用说明

首次测试成本

不同模型的成本

退款政策

安全提醒

密钥保护

对话内容安全

设备切换

测试信息

相关阅读

更新日志