> 说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何同时兼容 OpenAI 和 Anthropic 格式的网关都一样，换成你自己用的地址即可。

[Cherry Studio](https://docs.cherryai.com.cn/docs/en-us/pre-basic/providers/zi-ding-yi-fu-wu-shang) 是一款免费的桌面 AI 客户端（Windows / macOS / Linux），有助手、知识库、MCP 工具、多模型并排回答。它本身不带模型，要自己接服务商。这篇讲清楚在 Cherry Studio 里怎么加自定义服务商、地址到底要不要带 `/v1`，以及几个常见报错。

## 两种接法怎么选

| | 自定义服务商（OpenAI 端点） | 内置 Anthropic 服务商 |
|---|---|---|
| 位置 | 设置 → 模型服务 → + 添加服务商 | 设置 → 模型服务 → Anthropic |
| 地址 | `https://api.apivai.com` | `https://api.apivai.com` |
| 能用的模型 | Claude 和 GPT | 只有 Claude |
| 适合 | 一个条目覆盖所有模型 | 想用 Claude 原生 Messages 格式 |

大多数人选**自定义服务商**就够了：一个 Key，Claude 和 GPT 都在同一个模型列表里。两种也可以用同一个 Key 同时配上。

## 第 1 步：添加自定义服务商

1. 点左侧栏的**设置**（齿轮）。
2. 打开**模型服务**。
3. 点服务商列表下方的 **+ 添加服务商**，弹出「添加自定义提供商」。
4. 按下表填写，点**添加**。

| 字段 | 值 |
|---|---|
| 提供商名称 | 随便起，比如 `APIVAI` |
| API 密钥 | 你的 Key |
| 端点设置 → OpenAI | `https://api.apivai.com` |

**关于 `/v1`**：Cherry Studio 要的是基础地址，会自己补上 `/v1/chat/completions`。所以填 `https://api.apivai.com`，实际请求的是 `https://api.apivai.com/v1/chat/completions`。新版本填 `https://api.apivai.com/v1` 也不会重复，但**千万别**粘贴带 `/v1/chat/completions` 的完整地址。地址末尾加 `#` 的意思是「原样使用这个地址」，这里不需要。

旧版本会让你选「提供商类型」，选 **OpenAI** 即可。

## 第 2 步：添加模型

1. 打开刚建的服务商。
2. 点**获取模型列表**，在需要的模型旁点 **+**。只有点过 **+** 的模型才会出现在对话的模型选择器里。
3. 也可以点 **+** 手动填模型 ID，比如 `claude-sonnet-4-6`、`claude-haiku-4-5`、`gpt-5.5`。

模型列表会变，以「获取模型列表」返回的 ID 为准，别照抄旧截图。

## 第 3 步：测试并启用

1. 点 **API 密钥**旁边的**检查**，选一个模型，提示成功说明 Key 和地址都对。
2. 打开服务商页面右上角的开关，列表里会显示绿点。
3. 在对话顶部的模型下拉框里选模型，发条消息试试。

## 可选：用内置 Anthropic 服务商接 Claude

在**模型服务**里打开 **Anthropic**，填入 Key，把 **API 地址**从 `https://api.anthropic.com` 改成 `https://api.apivai.com`。**不要加 `/v1`**，格式和 Anthropic 官方一致。然后获取模型列表、添加 Claude 模型、打开开关。GPT 模型在这里用不了，要走上面的自定义服务商。

## 模型怎么搭配

- 默认助手（快速提问、翻译、摘要）：`claude-haiku-4-5` 或 `gpt-6-luna`，便宜又快
- 主力助手（写作、代码）：`claude-sonnet-4-6` 或 `claude-sonnet-5-5`
- 最难的分析推理：`claude-opus-5-5`，真正需要时再用
- 想对比效果：Cherry Studio 能把同一个问题同时发给多个模型，拿自己的任务对比最直观

省钱小技巧：每条消息都会把之前的对话重新发一遍，对话越长每轮越贵，换话题就新开一个话题。

## 知识库能用吗

对话没问题，但知识库需要嵌入（embedding）模型来索引文件，APIVAI 不提供 embeddings，需要在 Cherry Studio 里给知识库另配一个嵌入模型服务商；负责回答的助手仍然可以用 Claude 或 GPT。图像生成模型也不提供。

## 常见报错

- **401 / invalid API key**：Key 没复制全，或者已经被删了。
- **402 / insufficient_quota**：这个 Key 的预算用完了，或者剩得太少、不够贵的模型（Opus、Sonnet 4.6 等）发一次请求。给 Key 加点预算，或者先换便宜的模型。
- **404**：地址填错了。自定义服务商填 `https://api.apivai.com`，不要带 `/chat/completions`，末尾也不要加 `#`；Anthropic 服务商填 `https://api.apivai.com`，不要带 `/v1`。
- **找不到模型**：模型 ID 必须完全一致（如 `claude-sonnet-4-6`），不是显示名称。GPT 模型放在 Anthropic 服务商下会失败。
- **对话里选不到模型**：服务商开关没开，或者获取了列表但没点模型旁边的 **+**。
- **回复为空或被截断**：思考 token 也算进输出上限。在助手的模型参数里把最大输出 token（MaxToken）的限制关掉，或者调到 4096 以上。
- **回复一次性蹦出来 / 流式中断**：检查同一页的「流式输出」开关，以及 Cherry Studio 网络设置里的代理。
- **429**：默认每个 Key 每分钟 60 次请求，多模型同时对比会一次消耗好几次，稍等一下再试。

有问题欢迎评论区交流。


说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何同时兼容 OpenAI 和 Anthropic 格式的网关都一样，换成你自己用的地址即可。

Cherry Studio 接入 Claude / GPT API：自定义服务商怎么填、地址要不要带 /v1

Cherry Studio 里添加自定义服务商接入 Claude 和 GPT 的步骤：地址要不要带 /v1、模型怎么添加和搭配、内置 Anthropic 服务商的用法，以及 401、402、404 等常见报错的排查。

人工智能

开发工具

客户端

在CherryStudio中配置APIVAI自定义服务商，填入基础地址https://api.apivai.com（无需带/v1），获取并添加模型后开启开关即可使用Claude与GPT。内置Anthropic服务商仅支持Claude，需改API地址。注意避免常见404、401、402错误，模型ID需完全一致，调整MaxToken防止输出截断。

2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在CherryStudio中配置APIVAI自定义服务商，填入基础地址https://api.apivai.com（无需带/v1），获取并添加模型后开启开关即可使用Claude与GPT。内置Anthropic服务商仅支持Claude，需改API地址。注意避免常见404、401、402错误，模型ID需完全一致，调整Max...

Cherry Studio 接入 Claude / GPT API：自定义服务商怎么填、地址要不要带 /v1-腾讯云开发者社区-腾讯云

Cherry Studio 接入 Claude / GPT API：自定义服务商怎么填、地址要不要带 /v1

Cherry Studio 接入 Claude / GPT API：自定义服务商怎么填、地址要不要带 /v1

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐