GPT88 / API Docs

Cherry Studio 接入 gpt88.cc

把 gpt88.cc 接到 Cherry Studio 的 OpenAI 兼容工作流里，适合多模型管理、提示词模板和常用对话场景。

选择 OpenAI Compatible provider，填入 Base URL 和 Key，再从稳定模型开始。

这篇教程按进入配置、选择提供商、验证连通性、排查失败的完整流程展开。

这篇教程讲什么

  • 把 Cherry Studio 接到 gpt88.cc 的 OpenAI 兼容接口。
  • 选择一个稳定模型先跑通。
  • 连接失败时知道先检查什么。

准备工作

checklisttext
1. 先把 Provider 选成 OpenAI Compatible
2. Base URL 一定要写成 https://api.gpt88.cc
3. API Key 使用控制台生成的真实 Key
4. 先选一个已知稳定的聊天模型
5. 发一条最小消息验证
6. 如果失败，先回到 cURL 检查接口

快速配置

setuptext
1. 打开 Cherry Studio
2. 进入模型提供商 / API 配置
3. 选择 OpenAI Compatible
4. Base URL 填 https://api.gpt88.cc
5. API Key 填 gpt88.cc 控制台生成的 Key
6. 模型先选一个稳定可用的聊天模型
7. 发送一条最小消息测试连通性

建议先用一条最小请求确认通路，再导入更多模型和提示词模板。

smoke-test.shbash
curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":"介绍一下 gpt88.cc"}]
  }'

验证连通性

  1. 先在 Cherry Studio 保存配置。
  2. 新建对话并发送最短问题。
  3. 能返回内容后，再逐步增加上下文和提示词复杂度。
  4. 不能返回时，先用 cURL 验证 Key 和 Base URL。

使用建议

  • 把常用模型固定成默认项，减少手动切换。
  • 长上下文优先用更强模型，快速问答优先用低成本模型。
  • 给不同项目单独建 Key，方便统计成本和停用。

常见问题

  • 模型列表拉不到时，手动输入模型 ID。
  • 返回 404 时，检查 Base URL 是否带正确的 /v1。
  • 返回 401 时，确认 Key 是否复制完整。

排障清单

troubleshootingtext
1. 模型列表空白
   - 手动输入模型 ID
   - 到模型导航复制真实模型名

2. 返回 401
   - Key 无效或过期

3. 返回 404
   - Base URL 写错，或者没带 /v1

4. 回复很慢
   - 先换一个更轻的模型
   - 先关掉知识库和多轮长上下文

下一步