在 ChatBox 中使用 gpt88.cc

选择 provider 和协议，填入 API Key，再发送一条最小测试消息。

这篇教程的目标不是“知道有个配置项”，而是让你按步骤把 ChatBox 从空白状态接成可用状态：先填 API Key，再填 Base URL，再选模型，最后做一轮验证。

准备工作

开始之前，先确认这几件事：

1. 已安装 ChatBox 桌面端
2. 已注册 gpt88.cc 账号并创建 API Key
3. 已确认你要接入的模型 ID
4. 已知道当前工具是 OpenAI 风格还是 Claude 风格
5. 已准备好一条最小测试消息

第一步：启动 ChatBox 并开始配置

首次启动 ChatBox 通常会看到配置向导；如果已经配置过，也可以从设置重新进入。目标是先配好 API Host 和模型 Provider。

1. 启动 ChatBox 应用。
2. 首次使用时进入新建对话或配置向导。
3. 已配置过则打开设置。
4. 找到 AI Provider / 模型提供商配置。

第二步：配置 gpt88.cc

2.1 选择模型提供商

gpt88.cc 最常见的方案是选择 OpenAI API。如果 ChatBox 版本提供 Claude API 选项并且要用 Claude 系列模型，也可以切到 Claude 风格。

2.2 填写 API 信息

推荐先按 OpenAI 风格配置：

Provider: OpenAI API
API Key: sk-你的-gpt88-api-key
API Host / API Domain: https://api.gpt88.cc
Model: claude-haiku-4-5-20251001 或 gpt-5-2-chat-latest

如果准备走 Claude 风格，再改成下面这样：

如果你的 ChatBox 版本提供 Claude API 选项：

Provider: Claude API
API Key: sk-你的-gpt88-api-key
API Host / API Domain: https://api.gpt88.cc
Model: claude-sonnet-4-6 或 claude-haiku-4-5-20251001

配置时最容易出错的就是“地址形态”和“模型名”。你可以直接对照下面的简表：

2.3 选择模型

配置好 Host 后，模型选择是第二个关键点。下拉列表没有刷新时，直接复制模型 ID 往往更快。

第三步：开始使用

配置完成后，回到主界面发一条最小请求。先确认能正常返回，再调整温度、最大输出长度和模型。

export GPT88_API_KEY="sk-你的-gpt88-api-key"

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-2-chat-latest",
    "messages": [
      {"role": "user", "content": "用一句话介绍 gpt88.cc"}
    ]
  }'

1. 返回主界面，新建一个对话。
2. 输入一句简单的问题，比如“用一句话介绍 gpt88.cc”。
3. 检查回复是否正常返回。
4. 如果成功，再逐步切换到更复杂的提示词。

调整模型参数（可选）

高级功能

• 多会话管理：为不同任务建立独立聊天窗口，避免上下文串线。
• 保存和导出对话：把有价值的讨论导出为 Markdown 或 JSON。
• 提示词模板：把常用提示词存成模板，减少重复输入。
• 模型切换：根据任务在快速模型和高质量模型之间切换。

排障清单

1. 连不上服务
   - 检查 Base URL 是否为 https://api.gpt88.cc
   - 检查 API Key 是否完整
   - 先用 curl 验证，再回到 ChatBox

2. 模型列表为空
   - 手动输入模型 ID
   - 到 /v1/models 或模型导航复制真实模型名

3. 返回 401
   - Key 无效、过期或权限不足

4. 返回 404
   - 多半是 Base URL 或模型名写错

5. 返回很慢
   - 先换一个更轻的模型测试网络和配置

如果你已经按上面的步骤配置完，还是不通，优先去控制台和 cURL 里确认 Key、 模型权限与 Base URL，而不是先怀疑 ChatBox 本身。

常见问题

Q1：无法连接到 gpt88.cc？

• 先确认 API Host 是否写成了 https://api.gpt88.cc。
• 确认 API Key 是否完整，且前缀和控制台一致。
• 先用 cURL 验证接口，再回到 ChatBox 排查客户端设置。

Q2：模型列表里没有显示模型？

• 直接手动输入模型 ID。
• GET /v1/models / model catalog से real model name copy करें。

Q3：对话报错怎么办？

• 401: 检查 Key 是否有效。
• 404: 检查模型名或接口路径。
• 429: 降低并发或换低成本模型。

Q4：怎么看用量和费用？

• gpt88.cc console。
• 建议给 ChatBox 单独用一把 Key，方便统计和停用。

Q5：ChatBox 支持哪些平台？

• 通常支持 Windows、macOS 和 Linux。
• 不同版本的配置名称可能略有差异，但核心字段通常都是 API Key、API Host、Model。

使用技巧

1. 先跑通最小请求，再调参数。
2. 把常用模型固定成默认模型，减少手动输入。
3. 长任务用更强模型，简单问答用更便宜、更快的模型。
4. 如果主要做开发，先看完整接入手册。 Guide

下一步

• 如果要理解整个站点的接入心智，可以看 gpt88.cc 通用接入教程。
• 如果要把配置同步给其他工具，可以看配置文件导出。
• 如果要继续看 API 说明，可以看快速开始和 Chat Completions API。