Cherry Studio 接入 NoneLinear

Cherry Studio 支持添加 OpenAI 兼容服务商。将服务商类型设为 OpenAI,并把 API 地址配置为 NoneLinear 的 OpenAI 兼容端点后,即可在 Cherry Studio 中调用 NoneLinear 模型。
Cherry Studio Agent 模式兼容性说明本文介绍的 OpenAI 兼容协议配置适用于 Cherry Studio 的普通聊天模式。Cherry Studio 当前的 Agent 模式要求服务商使用 Anthropic 类型,并且接口支持 Anthropic Messages API。因此,通过 OpenAI 类型服务商添加的模型即使可以正常聊天,也不会出现在创建智能体时的模型列表中。这属于 Cherry Studio 当前的协议兼容性限制,并非模型 ID 填写错误或模型获取失败。如需在 Agent 模式中使用 NoneLinear 模型,请另外添加一个服务商:
配置项填写内容
提供商名称非线智能 Agent
提供商类型Anthropic
API 密钥你的 NoneLinear API Key
API 地址https://api.nonelinear.com/anthropic
模型 IDNoneLinear 模型列表 中选择
原有的 OpenAI 类型服务商无需删除,可以继续用于普通聊天;Anthropic 类型服务商用于 Agent 模式。更多信息请参考 Cherry Studio Agent 使用教程

前置要求

配置步骤

1. 选择其他服务商

首次打开 Cherry Studio 时,在引导页点击 选择其他服务商 Cherry Studio 选择其他服务商 如果已经进入主界面,也可以从右上角 设置 进入模型服务商配置页。

2. 添加 NoneLinear 服务商

在服务商列表底部点击 添加,新建一个服务商:
字段填写内容
提供商名称非线智能
提供商类型OpenAI
填写完成后点击 确定 Cherry Studio 添加 NoneLinear 服务商

3. 填写 API Key 和 API 地址

选中刚刚添加的 非线智能 服务商,打开右侧配置页并填写:
字段填写内容
API 密钥你的 NoneLinear API Key
API 地址https://api.nonelinear.com/v1
Cherry Studio 会预览完整请求地址为 https://api.nonelinear.com/v1/chat/completions。填写完成后可以点击 检测 验证连接。 Cherry Studio 配置 NoneLinear API Key 和 API 地址
不要在截图、工单、公开仓库或聊天群中暴露真实 API Key。如果怀疑 Key 泄露,请立即在 NoneLinear 控制台删除并重新生成。

4. 添加模型

在模型区域点击 + 添加模型。模型 ID 必须与 NoneLinear 模型列表中的 ID 保持一致。 示例填写:
字段示例
模型 IDdeepseek-v4-flash
模型名称deepseek-v4-flash
分组名称deepseek-v4
Cherry Studio 添加 NoneLinear 模型
你也可以使用其他 NoneLinear 模型,例如 GPT、Claude、Qwen、GLM、豆包等系列模型。以 模型列表 中展示的模型 ID 为准。

5. 选择默认模型

返回引导流程,在 默认助手模型 下拉框中选择刚刚添加的模型,例如 deepseek-v4-flash | 非线智能,然后点击 开始使用 Cherry Studio 选择 NoneLinear 默认模型

6. 发送消息验证

进入对话界面后,确认顶部模型显示为 deepseek-v4-flash | 非线智能 或你配置的其他 NoneLinear 模型。发送一条测试消息,如果模型正常回复,说明接入成功。 Cherry Studio 使用 NoneLinear 模型对话

常见问题

检测失败怎么办?

优先检查三项配置:
  • API 地址是否为 https://api.nonelinear.com/v1,不要填写到 /chat/completions
  • API Key 是否完整复制,前后不要带空格。
  • 当前网络是否可以访问 NoneLinear API。

模型报错怎么办?

检查模型 ID 是否与 NoneLinear 模型列表 完全一致,包括大小写、连字符和版本号。模型 ID 不一致时,Cherry Studio 能保存配置,但调用时会失败。

可以配置多个模型吗?

可以。重复 添加模型 步骤,把常用模型分别加入同一个 非线智能 服务商下即可。之后可以在对话顶部的模型选择器中切换。