拿到 API Key 后，在 Cherry Studio / Cursor 里接入 OpenAI 兼容接口

准备

• 一个模型平台的 API Key（还没有的话，先看本站的领取指南）
• 已安装 Cherry Studio 或 Cursor

步骤

1. 01

   准备好三样东西：API Key、Base URL、模型 ID

   所有 OpenAI 兼容工具都只认这三项。以两家平台的官方文档为例：

   • 火山方舟：Base URL 为 https://ark.cn-beijing.volces.com/api/v3；API Key 在 API Key 管理 创建；模型 ID 在方舟的 模型列表 查。
   • SiliconFlow（硅基流动）：Base URL 为 https://api.siliconflow.cn/v1；API Key 在 API 密钥 页面点「新建 API 密钥」；模型名在 模型广场 查，例如官方快速上手示例中的 Pro/deepseek-ai/DeepSeek-R1（模型会更新，以模型广场为准）。

   其他平台同理：去它的官方文档里找「兼容 OpenAI」那一节，抄下 Base URL 即可。

2. 02

   （可选）先用 curl 验证 Key 能用

   在工具里排查问题比较费劲，建议先在终端确认 Key 和模型名没问题。下面以 SiliconFlow 为例，把 Key 和模型名换成你自己的；换成火山方舟只需把地址改成 https://ark.cn-beijing.volces.com/api/v3/chat/completions。

   bash复制

   curl https://api.siliconflow.cn/v1/chat/completions \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer 你的API Key" \
     -d '{
       "model": "Pro/deepseek-ai/DeepSeek-R1",
       "messages": [{"role": "user", "content": "你好"}]
     }'

3. 03

   Cherry Studio：接入火山方舟（通用 OpenAI 方式）

   按火山方舟官方文档的配置：

   • 打开 Cherry Studio，进入设置 → 模型服务，点击添加提供商，提供商类型选 OpenAI；
   • API 密钥：粘贴你的方舟 API Key；
   • API 地址：https://ark.cn-beijing.volces.com/api/v3；
   • 模型：点击添加模型，填写要用的模型 ID。

   保存后回到对话页，在顶部选中这个模型就能聊天了。其他兼容 OpenAI 的平台，也可以用同样的方式添加。

4. 04

   Cherry Studio：接入 SiliconFlow（内置提供商，更省事）

   Cherry Studio 内置了硅基流动，按 SiliconFlow 官方文档：

   • 点击左下角设置，在模型服务里选择硅基流动；
   • 填入在 API 密钥 页面新建或复制的 Key；
   • 点击管理，把需要的模型添加到「我的模型」。

   之后在左侧「对话」里输入文字即可开始，可通过顶部的模型名切换模型。

5. 05

   Cursor：用自己的 Key 接入（需要付费套餐）

   火山方舟官方文档说明：由于 Cursor 的限制，只有订阅了 Cursor Pro 及以上套餐的用户才支持自定义配置模型。 Cursor 官方文档里自带 Key 的入口在 Cursor Settings → Models，火山方舟文档给出的配置项如下：

   • OpenAI API Key：填你的平台 API Key；
   • Override OpenAI Base URL：填平台的 Base URL，例如 https://ark.cn-beijing.volces.com/api/v3；
   • Add Custom Model：添加要用的模型 ID。

   配置完成后，在聊天面板里选中这个模型即可。Cursor 设置界面更新较频繁，如果找不到对应选项，以 Cursor 当前版本为准。

注意事项

• Base URL 只填到 /api/v3 或 /v1 为止，按上面的官方写法填，不要自己加上 /chat/completions（Chatbox 这类工具会把路径单独放在 API Path 一栏里）。
• 火山方舟文档提醒：配置工具前要确认对应模型服务可用；如果报“未开通”或无权限，去方舟控制台的开通管理页检查该模型的状态。
• 提示 Key 无效时，先检查是否复制完整、有没有多带空格；建议直接从控制台复制粘贴。
• Cursor 官方说明：自定义 API Key 只对聊天模型生效，Tab 补全仍使用 Cursor 自带模型；请求会经过 Cursor 的服务器拼装提示词，Key 随请求加密传输、不在服务器上保存。
• Cursor 官方说明：个人套餐（Pro / Pro+ / Ultra）用自己的 Key 时由模型平台直接计费、不占 Cursor 内含用量；Teams / Enterprise 套餐仍会按 Cursor Token Rate 计入用量。
• 用免费额度时，也建议在平台侧开好额度保护（例如火山方舟的「安心体验模式」或用量上限），避免工具自动重试把额度一下子用完。

常见问题

相关优惠

• 新人 · 火山引擎火山方舟新用户免费推理额度每个模型 50 万 tokens（以控制台显示为准）
• 额度 · 火山引擎豆包大模型送 50 万 tokens注册送 50 万 tokens

信息来源

• 火山方舟 · 接入三方工具（Cherry Studio / Cursor 等）docs.volcengine.com/docs/ark/integrate-third-party-tools
• 火山方舟 · 兼容 OpenAI SDKdocs.volcengine.com/docs/ark/compatible-with-openai-sdk
• SiliconFlow · 快速上手docs.siliconflow.cn/cn/userguide/quickstart
• SiliconFlow · 在 Cherry Studio 中使用docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-cherry-studio
• Cursor · Bring your own API keycursor.com/docs/settings/api-keys

最后核实日期：2026-10-08 · 政策可能随时调整，请以官方页面为准