Cherry Studio 配置 GPT API：自定义服务商、生图模型与报错排查

准备：对话和生图各建一把 Key

Cherry Studio 里对话和生图要用两把不同分组的 Key：对话用「OpenAI」分组，生图用「GPT 生图」分组，先在控制台建好。API Key 是一串以 sk- 开头的密钥，相当于调用接口的密码；Key 绑定分组，分组决定这把 Key 能调哪类模型。

1. 打开 注册页，用邮箱注册，收验证码完成登录。用纯数字 QQ 邮箱（如 123456789@qq.com）注册的新用户送 5 美元体验额度，英文别名的 QQ 邮箱不送，活动仅限中国用户。
2. 体验额度用完后到「充值」页面充值，支持微信、支付宝。按量计费，用多少扣多少。
3. 进「API 密钥」页面点新建，对话用的 Key 分组选「OpenAI」，生图用的 Key 分组选「GPT 生图」。两类都要用就各建一把，复制出来的 sk-xxxxxxxx 就是 Key。

第一步：添加自定义服务商，API 地址填带 /v1 的地址

在 Cherry Studio 设置里新增一个 OpenAI 兼容类型的服务商，API 地址填 https://gpt.com.se/v1，API 密钥填 OpenAI 分组的 Key。API 地址也叫 Base URL 或 API 域名，就是接口地址，Cherry Studio 会把请求发到这里。

1. 打开 Cherry Studio 的设置，进入模型服务商的管理页面（不同版本可能叫「模型服务」或「模型服务商」）。
2. 点添加，名称自己起，比如「GPT.COM.SE 对话」；类型选 OpenAI（或「OpenAI API 兼容」/ Custom）。
3. API 地址填 https://gpt.com.se/v1，结尾带 /v1，前后不要有空格。
4. API 密钥填 OpenAI 分组的 Key（sk-xxx）。
5. 保存，确认这个服务商已启用，接着按下一步添加模型。

第二步：添加对话模型，模型名和价格对照

对话服务商里添加的模型名必须和本站模型名完全一致：可以点「获取模型」拉取这把 Key 可用的列表（按钮名称以你的版本为准），也可以手动添加下表里的模型名。添加后回到对话界面，在模型选择里选中它就能开始聊。

表里的 token 是模型计算文字量的单位，输入和输出分别按 token 数计费，价格按每百万 token 标。缓存读指重复发送的相同内容命中缓存后的价格，比普通输入便宜。上下文是模型回答时能看到的前文长度。

gpt-5.6-sol 的 $4 / $20 是官方限时价，官方说明至少到 2026-11-21；单次请求输入（含缓存读）超过 272K token 时，在售对话模型都按输入和缓存读 2 倍、输出 1.5 倍计价。gpt-6-luna 本站暂未提供，填了会直接报错。

怎么选：写代码、跑 Agent 优先 gpt-6-astra；日常聊天和写作用 gpt-5.6-terra；批量简单任务用 gpt-5.6-luna 更省。各型号的详细对比见 全部 GPT 模型与选型，完整价格见 GPT API 价格。

第三步：配置生图模型（gpt-image-2.5-sunburst、gpt-image-2）

生图要单独加一个服务商：API 地址同样填 https://gpt.com.se/v1，API 密钥换成 GPT 生图分组的 Key，再添加 gpt-image-2.5-sunburst 等生图模型。

1. 按第一步再添加一个服务商，名称起「GPT.COM.SE 生图」，类型选 OpenAI（或「OpenAI API 兼容」/ Custom）。
2. API 地址填 https://gpt.com.se/v1。
3. API 密钥填 GPT 生图分组的 Key，别用对话那把。
4. 点「获取模型」或手动添加，模型名填 gpt-image-2.5-sunburst。
5. 保存后选择这个服务商和生图模型，输入提示词出图。Cherry Studio 各版本的生图入口不完全一样，以你安装的版本为准。

三个生图模型同价，1K、2K、4K 分辨率价格一样，尺寸支持 1024、2048、4096 等常见规格。客户端里出不了图时，先在终端用下面这条命令直接调一次生图接口，能返回图片数据就说明 Key 和模型没问题，再回头检查 Cherry Studio 的设置。把 sk-你的Key 换成 GPT 生图分组的 Key。

curl https://gpt.com.se/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "一只戴墨镜的柴犬，扁平插画风",
    "size": "1024x1024"
  }'

生图模型的区别、Python 调用写法见 GPT 生图 API。

Cherry Studio 聊一轮要花多少钱：算例

按一轮对话输入 2000 token、输出 800 token 算，用 gpt-5.6-terra 每轮约 ¥0.014，聊 100 轮约 ¥1.4。下表按全部输入都没命中缓存计算，命中缓存的部分按缓存读价格计，实际会更低。

算法：费用等于 token 数除以 100 万再乘单价。例如 gpt-5.6-terra 每轮输入 2000 ÷ 1000000 × ¥2 = ¥0.004，输出 800 ÷ 1000000 × ¥12 = ¥0.0096，合计 ¥0.0136。

同一个对话越聊越贵。聊天客户端每发一条新消息，一般会把同一对话里前面的内容一起发给模型当上下文，聊得越久，每轮输入的 token 越多。换话题时新开一个对话，输入费用会明显下降。生图另算，每张 0.3 元，出 10 张 ¥3。

Cherry Studio 报错排查：api key 无效、连接失败、获取模型失败

报错先看状态码：401 查 Key，403 查余额，404 查地址，获取模型失败先查地址再查 Key。

用 curl 直接测一次对话 Key

分不清是客户端设置还是 Key 的问题时，在终端运行下面这条命令。curl 是系统自带的命令行请求工具，能返回模型回复就说明 Key 和地址都没问题，问题在 Cherry Studio 的设置里。把 sk-你的Key 换成 OpenAI 分组的 Key。

curl https://gpt.com.se/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'

怎么确认 Cherry Studio 调用的就是你选的模型

看控制台的用量明细：每次调用都记录模型名、token 数和费用，和你在 Cherry Studio 里选的模型对一下就清楚。

本站不做模型替换，用户请求哪个模型就调用哪个模型，缺货时直接报错。扣费按 OpenAI 官方美元标价，明细里的费用可以用本页的价格表和算例自己核算。更多自检方法见 不替换模型与自检方法。