全部教程 · 第 06 篇
  1. 015 分钟上手总览
  2. 02Codex CLI 接入（Windows / macOS）
  3. 03Codex VS Code 插件
  4. 04Claude Code 接入
  5. 05CC Switch 一键导入
  6. 06Cherry Studio 与 ChatBox
  7. 07怎么选分组
  8. 08充值与兑换
  9. 09常见报错怎么办

教程 06 · 约 6 分钟 · 更新于 2026-10-07

Cherry Studio 与 ChatBox

两个桌面聊天软件接入章鱼烧的小店的填法，以及模型名怎么选。

Cherry Studio 和 ChatBox 都是装在电脑上的聊天软件，不用敲命令，填好地址和密钥就能用。本文只讲怎么把它们接到章鱼烧的小店。两款软件的填法差不多，关键只有三样：API 地址、API 密钥、模型名。

开始之前

  1. 先有一把密钥。登录控制台，到 API 密钥 页点「创建」，选一个分组。新手建议选「ChatGPT 【稳定分组 超高缓存 高并发 】」（0.12×）。密钥明文只显示一次，创建后马上复制保存。不会创建看 快速开始。
  2. 账户里要有额度。怎么买、怎么兑换看 充值与兑换。
  3. 记住一件事：密钥建在哪个分组，就只能用那个分组允许的模型。选错模型名会直接报错，后面会讲。

下面是两款软件都要填的内容，先放在手边：

类型：OpenAI（或「OpenAI API 兼容」）
API 地址：https://api.zyuou.com
API 密钥：sk-你的密钥
模型名：gpt-6.1-sol

Cherry Studio

  1. 打开 Cherry Studio，点左下角「设置」，进入「模型服务」。
  2. 点「添加」，名字随便起（比如「章鱼烧」），类型选 OpenAI。
  3. API 密钥填 sk-你的密钥。
  4. API 地址填 https://api.zyuou.com。注意末尾不要加斜杠，也不要自己写 /v1。
  5. 点「管理」（有的版本叫「获取模型」）。能拉到列表就勾选要用的模型；拉不到就点「添加」，手动输入模型名，例如 gpt-6.1-sol，一行一个。
  6. 回到聊天页，点顶部的模型名，切到刚添加的模型，发一句「你好」试试。

关于 /v1 的补全规则。Cherry Studio 看地址末尾：不以斜杠结尾，就自动在后面补 /v1；以斜杠结尾，就原样使用。所以填 https://api.zyuou.com，它会自己拼成 https://api.zyuou.com/v1，这是我们要的结果。如果你一定要手写全路径，请写成 https://api.zyuou.com/v1/（带末尾斜杠），否则会被拼成 /v1/v1 而报错。

ChatBox

  1. 打开 ChatBox，点左下角「设置」，进入「模型提供方」。
  2. 点「添加自定义提供方」，类型选 OpenAI API 兼容。
  3. API 域名填 https://api.zyuou.com。
  4. API 路径保持默认的 /v1/chat/completions，不用改。
  5. API 密钥填 sk-你的密钥。
  6. 模型那一栏手动输入模型名，例如 gpt-6.1-sol。ChatBox 一般不会自动拉列表，要自己填。
  7. 保存，回到对话窗口，右下角或顶部选中这个提供方和模型，发一句话测试。

模型名怎么填

模型名要一字不差地照抄，大小写、横线都不能错。下面是最近 7 天用得最多的几个，按请求量从高到低：

模型名平台官方参考价（每百万 token，输入 / 输出）
gpt-6.1-solopenai$2 / $10
gpt-6-astraopenai$10 / $50
gpt-5.6-solopenai—
gpt-5.6-lunaopenai$0.2 / $1.2
claude-opus-5-5anthropic$4 / $20
glm-5.3-flash国模—
deepseek-v4.1-flash国模—

实际扣费 = 官方价 × 分组倍率。比如在 0.12× 分组里用 gpt-6.1-sol，官方算 1 美元的用量，这里只扣 0.12 美元额度，也就是 0.12 元。花了多少随时到 使用记录 页看。

模型要和分组配对。密钥建在 openai 分组，就只能填 gpt 开头的模型；想用 claude-opus-5-5，要另建一把 anthropic 分组（如「CC MAX正价分组」）的密钥；想用 glm、deepseek，要建「国模」分组的密钥。一个软件里可以同时添加多个提供方，各配各的密钥。各分组的区别看 分组怎么选。

报错了怎么看

两款软件都会把服务器返回的错误原样显示出来，看状态码和文字就能判断：

  • 401，文字是 Invalid API key 或 API key is disabled：密钥抄错、多了空格，或者已经被停用。回 API 密钥 页核对。
  • 403，文字是 Insufficient account balance：余额不够了，去 兑换 页充值。
  • 404，文字是 Model "xxx" is not supported by any configured account in this group：模型名写错，或者这个分组不提供这个模型。对照上面的表改模型名，或者换分组重建密钥。
  • 429，文字含 rate-limited 或 Too many pending requests：请求太多，等几秒再发。

还是不行？

完整的报错对照表在 常见报错。还解决不了，加 QQ 群 1104498354（备注「新手」），或联系客服 QQ 3480261526，把软件名、填的地址和报错截图发过来。