文档目录
接入 Cherry Studio
Cherry Studio 接入 Tokenway：Claude 和 GPT 各自怎么配、验证、常见报错。
Cherry Studio 里把本站添加为“自定义服务商”即可，Claude、GPT 和其他模型都能用，区别只在于服务商类型和地址。
先搞清楚：Claude 和其他模型要分开配
| 模型 | 服务商类型 | API 地址 |
|---|---|---|
| Claude 系列 | Anthropic | https://tokenwayapi.com（不带 /v1） |
| GPT 和其他模型 | OpenAI | https://tokenwayapi.com/v1 |
如果想在同一个客户端里同时用 Claude 和 GPT，需要添加两个服务商：一个 Anthropic 类型（只放 Claude 模型）、一个 OpenAI 类型（放 GPT 和其他模型），密钥可以是同一把。Claude 模型放在 OpenAI 类型下会返回 400。
步骤
- 打开 设置 → 模型服务，点击“添加”，输入一个服务商名称（例如 Tokenway）。
- 按上表选择服务商类型，并填入对应的 API 地址。
- 在 API 密钥 里填入
sk-xxxxxxxx。 - 点“管理”或“添加模型”：可以从拉取到的列表里勾选，也可以手动输入模型名；模型名必须与 模型定价 页一致。
- 点“检查”测试连通，通过后回到对话页选择该模型即可。
界面可能随版本变化
按钮名称以你安装的版本为准，需要填的三样东西不变：API 地址、密钥、模型名。
怎么确认接通了
- 在对话页选择刚添加的模型，发一句简单的话，能正常回复就说明接通了。
- 打开控制台的 使用记录，应该能看到刚才这一笔：模型名、输入输出 token 和扣费。
查看余额
本站支持 OpenAI 兼容的余额查询接口，客户端如果有“查询余额”功能可以直接用，详见 查询余额接口。
常见问题
| 现象 | 原因和处理 |
|---|---|
检查失败 / 401 | 密钥填错或已停用，到 API 密钥 页确认；注意前后别带空格。 |
402 | 余额不足，见 充值购买。 |
404 / 找不到模型 | 模型名拼写要和价格页一致；Anthropic 类型的地址别多带 /v1，OpenAI 类型的地址要带 /v1。 |
400：不支持 xxx 接口 | 模型放错了服务商类型：Claude 要放 Anthropic 类型，GPT 和其他模型放 OpenAI 类型。 |
| 连不上或很慢 | API 密钥 页里还有备用接入地址，换一个试试；到 服务状态 看线路是否正常。 |
其他错误见 错误码。
选好模型，核对费用再接入
查看当前模型的价格与参数，用自己的输入、输出和缓存用量估算成本；遇到报错时按错误码排查。