跳到主要内容

其他工具

通用工具接入 菜ai (OpenAI 兼容协议)

菜ai 的接口完美兼容标准的 OpenAI API 协议。这意味着，只要你使用的工具支持自定义 OpenAI 节点（如 Cursor、Chatbox、各类 VS Code 插件等），你都可以轻松将底层模型替换为 菜ai 的高性能算力。

一、通用配置“三要素”​

无论你使用的是什么工具，找到其“设置 / API Configuration / Custom Provider”页面，替换以下三个核心参数：

配置项填写内容避坑指南
API Base URL
(或 接口地址)		https://cloud.ai.liandxu.cn/v1⚠️ 关于 /v1 的重要说明：
绝大多数工具（如 Cursor）需要带 /v1。但部分工具如果报错"404"或"无效 URL"，请删掉 /v1 仅保留根域名再试。
API Key
(或 密钥)		sk-xxxxxxxxxxxxxxxx请直接填写 菜ai 控制台获取的纯文本，不要手动添加 Bearer 前缀。
Model
(或 模型名称)		填写 菜ai 实际支持的模型名务必与 菜ai 控制台展示的名字一字不差（如 gpt-4o, claude-3-5-sonnet-20241022）。

二、实操演示（以 Cursor 为例）​

以主流 AI 编程工具 Cursor 为例：

注意：由于 Cursor 的产品限制，Cursor 免费版仅支持Auto模式，且不支持调用自定义模型。如需要自定义，请升级至Cursor Pro 及以上套餐，即可正常使用 菜ai 支持的模型。

  1. 打开 Cursor，进入 Settings -> Models。
  2. 找到 OpenAI 配置项，打开 Override OpenAI Base URL 开关，填入 https://cloud.ai.liandxu.cn/v1。
  3. 在 API Key 处填入你的 菜ai sk-... 密钥。
  4. 点击 Add Custom Model，输入你想使用的模型名（如 deepseek-v3.2-251201）并开启开关。
  5. 在对话框选中该模型即可开始使用。

(图例参考)

image.png​

三、通用排错指南 (FAQ)​

如果你在配置后无法正常对话，请按以下顺序排查“三大经典报错”：

1. 报错 404 (Not Found) / Invalid URL / 模型不存在？ 这是最常见的路径或名称拼接错误：

  • Base URL 结尾问题：这是不同工具的底层逻辑差异导致的。如果你填了 /v1 报错，请删掉 /v1 再试；如果没填报错，请加上 /v1 再试。
  • 模型名问题：不要凭直觉填写，必须确保填写的模型名在 菜ai 平台真实存在且你拥有调用权限。

2. 报错 401 (Unauthorized) / 认证失败？

  • 检查 Key 是否多复制了空格，或者画蛇添足地加上了 Bearer 前缀。
  • 登录 菜ai 控制台确认该 API Key 的状态是否正常、额度是否充足。

3. 报错 502/504 / 网络连接超时？

  • 可能是当前主网路由波动。请尝试将 Base URL 替换为其他官方备用节点（如 https://platform.ai.liandxu.cn/v1）。