在 Cursor 中使用 MiniMax-M2.7 与 MiniMax-M3

Cursor 可以在 Models 设置里调用任何 OpenAI 兼容接口。本指南把 MiniMax-M2.7、MiniMax-M2.7-highspeed 与 MiniMax-M3 作为自定义模型接入，由 YiduoChan 的 API Key 提供服务，并说明哪些 Cursor 功能会用到它们、各模型的价格，以及常见报错的处理方法。

Cursor 如何访问自定义的 OpenAI 兼容模型

Cursor 的 Models 设置允许你填入自己的 OpenAI API Key，并单独覆盖这个 Key 使用的 Base URL。覆盖生效后，Cursor 对经其 OpenAI 提供方路由的模型发出的每个请求，都会发到 <base URL>/chat/completions，并在 Authorization 请求头里带上你的 Key。YiduoChan 正是在 https://yiduochan.com/v1 上以这个接口提供 MiniMax 文本模型，所以 Cursor 不需要任何插件或扩展：三个自定义模型名、一个 Key、一个 URL 就够了。

开始前有两点要注意。第一，你在 Cursor 里填写的模型名会原样作为 model 字段转发，必须与 YiduoChan 的模型 ID 逐字符一致。第二，Cursor 官方文档说明了使用自定义 API Key 时请求如何路由，不同版本之间可能有差异；如果你的团队对哪些服务可以看到源代码有规定，推广到团队之前请先读一遍。

准备工作

一个有余额的 YiduoChan 账号。先注册，新账号自带 $0.10 试用额度，够发几次测试请求；正式使用前再充值。额度为预付美元、按量付费、无订阅，最低充值 $5，有效期 12 个月。
在 YiduoChan 控制台创建的 API Key。它以 Authorization: Bearer <API key> 的形式发送，请像对待其他密钥一样保管，不要提交到代码仓库。
较新版本的 Cursor。Models 页面的文字偶尔会变，但涉及的三个控件（自定义模型名、OpenAI API Key、Base URL 覆盖）在近期版本中一直稳定。

分步操作：在 Cursor Settings > Models 中添加 MiniMax 模型

打开 Cursor Settings。点击编辑器右上角的齿轮图标，或在命令面板中运行 Cursor Settings，然后选择 Models 标签页。
添加自定义模型名。在模型列表中选择 Add model（有些版本叫 Add custom model），输入 MiniMax-M2.7，再依次添加 MiniMax-M2.7-highspeed 和 MiniMax-M3。不要加前缀或后缀，也不要改成小写，这个字符串会被原样转发。
启用 OpenAI API Key。打开 OpenAI API Key 开关，粘贴你的 YiduoChan Key。Cursor 会对所有它视为 OpenAI 兼容的模型使用这个 Key，现在也包括刚添加的三个模型。
覆盖 OpenAI Base URL。启用 Override OpenAI Base URL，填入 https://yiduochan.com/v1。要包含 /v1，不要加结尾斜杠或任何后续路径；Cursor 会自己拼上 /chat/completions。
验证。点击 Verify，Cursor 会用你的 Key 向配置的 URL 发一个小请求。成功说明 Key 通过了鉴权、接口有响应。这一步报错几乎都是 Key 或 URL 的问题，见下文的排错部分。
整理模型选择器。覆盖生效期间，取消勾选列表里内置的 OpenAI 模型名。Cursor 可能也会把它们发到覆盖后的 URL，而 YiduoChan 不提供这些模型，保留勾选会让选择器里出现令人困惑的报错。三个 MiniMax 条目保持勾选。
在 Chat 中选择模型。打开聊天面板，在模型下拉框中选择 MiniMax-M2.7，发送一条简短的提示。Composer 里也有同样的下拉框。

独立验证接口

如果 Verify 失败，或者你想区分是 Cursor 的问题还是账号的问题，可以在终端里用同一个 Key 和 URL 测试。第一个请求列出你的 Key 可见的模型；第二个向 Cursor 调用的同一个 chat completions 接口发送最小请求。

export YIDUOCHAN_API_KEY="<API key>"

curl https://yiduochan.com/v1/models \
  -H "Authorization: Bearer $YIDUOCHAN_API_KEY"

curl https://yiduochan.com/v1/chat/completions \
  -H "Authorization: Bearer $YIDUOCHAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M2.7",
    "messages": [{"role": "user", "content": "Reply with the single word OK."}],
    "max_tokens": 16
  }'

返回 200 且带有 choices 数组，说明账号侧没有问题。如果两个请求都成功而 Cursor 仍然失败，问题出在 Cursor 的配置上。

自定义模型在 Cursor 中能用哪些功能

Cursor 对待自定义的 OpenAI 兼容模型与其他可选模型一样：界面上凡是出现模型下拉框的地方，都能看到并选择你的 MiniMax 条目。

Chat。聊天面板可以使用自定义模型，包括你用 @ 引用的文件和符号。这是端到端确认配置的最快方式。
Composer。多文件编辑使用 Composer 下拉框里选中的模型。请在那里显式选择 MiniMax-M2.7，聊天面板的选择不一定会带过去。

Cursor 的部分原生能力运行在 Cursor 自己托管的模型上，不读取这些设置。凡是从不显示模型下拉框的功能都属于这一类，某个版本也可能把更多功能绑定到 Cursor 托管的模型上。Cursor 没有公布稳定的清单，而且版本之间会变，实用的判断标准是：一个功能如果能选 MiniMax-M2.7，它就运行在 YiduoChan 上；如果不能，无论你的 Key 是什么，它都在 Cursor 那边运行。你依赖的功能，请先在不重要的文件上试一遍。

自定义 Key 只影响它所处理的请求的计费。你与 Cursor 之间关于编辑器本身的套餐由 Cursor 的条款约定；YiduoChan 只对到达 https://yiduochan.com/v1 的 token 计费。

在 MiniMax-M2.7、M2.7-highspeed 与 M3 之间怎么选

三个模型走同一个接口、配置方式相同，区别在延迟、上下文长度和价格。下表为每百万 tokens 的美元价格，按 MiniMax 刊例价水平，预付、无订阅。

模型 ID	在 Cursor 中何时选择	输入	输出	缓存读取
`MiniMax-M2.7`	Chat 与 Composer 的默认选择，三者中标准价最低。	$0.30	$1.20	$0.06
`MiniMax-M2.7-highspeed`	质量与 M2.7 相同、延迟更低。适合"改一下、跑一下、再修"的紧凑循环，瓶颈在等模型的时候用。	$0.60	$2.40	$0.06
`MiniMax-M3`，提示不超过 512K tokens	1,048,576 tokens（1M）上下文。一次对话需要仓库的很大一部分或很长的日志时使用。	$0.30	$1.20	$0.06
`MiniMax-M3`，提示在 512K 到 1M tokens 之间	同一个模型。只有提示超过 512K tokens 时才适用更高一档。	$0.60	$2.40	$0.12

MiniMax-M2.7 与 MiniMax-M2.7-highspeed 的缓存写入为每百万 tokens $0.375。有两点是 Cursor 特有的。M2.7 和 highspeed 输出质量相同，所以按工作方式而不是任务难度来选：来回交互的场景受益于低延迟，放着不管的长 Composer 任务则不需要。另外，发送多少上下文由 Cursor 决定；选择 MiniMax-M3 只是提高上限，并不会强制发送 1M tokens 的提示，所以在 M3 上的一次常规 Cursor 对话，按与 M2.7 相同的标准价计费。模型详情见 MiniMax-M2.7 与 MiniMax-M3 页面。

让 Cursor 的花费可预期

计费为预付、按量付费，没有需要续费的订阅，失败的请求从不计费。先充 $5 或 $10，正常用几天，在控制台看过实际用量再决定是否继续充值。预设档位有 $5、$10、$20、$50、$100、$200 和 $500，也可以自定义金额；额度有效期 12 个月。
把 MiniMax-M2.7 设为默认，有意识地切换到 MiniMax-M2.7-highspeed。highspeed 版本在输出质量相同的情况下输入和输出价格都翻倍，只有延迟真正拖慢你时才划算。
每一档的输出 token 价格都是输入的四倍。请让模型给出 diff 或具体函数，而不是整文件重写；对编辑类任务来说，账单主要由输出决定。
标准档缓存读取为每百万 tokens $0.06，新输入为 $0.30。较长且稳定的前缀（例如大的系统提示或固定的一组文件）受益最大；每轮都更换附加上下文则受益最小。
不要出于习惯一直选着 MiniMax-M3。提示在 512K tokens 以下时它与 M2.7 同价，但更高一档的输入价翻倍，而只有远超常规编辑所需的上下文才会触及那一档。
当前价格见定价页；控制台按模型展示用量，可以看出是哪个选择在推高成本。

常见报错排查

401 Unauthorized

Key 被拒绝。常见原因：复制时带上了前后空格；Key 已在控制台删除或停用；或者 Key 粘贴到了同一设置页的其他提供方字段（Anthropic 和 Google 字段在这里不起作用）。重新复制 Key，粘贴到 OpenAI API Key 字段，再点一次 Verify。如果上面的 curl 请求也返回 401，就是 Key 本身的问题。

model_not_found

模型名到达了 YiduoChan，但与提供的模型对不上。请逐字符核对自定义条目是否为 MiniMax-M2.7、MiniMax-M2.7-highspeed 或 MiniMax-M3。另一个常见原因是列表里仍勾选着内置的 OpenAI 模型名：覆盖生效时，Cursor 可能把它路由到 https://yiduochan.com/v1，而那里并没有这个模型，取消勾选即可。/v1/models 请求会准确列出你的 Key 能用的模型。

Verify 失败或返回 404

Base URL 必须是 https://yiduochan.com/v1，以 /v1 结尾。只填 https://yiduochan.com 会让 Cursor 调用 https://yiduochan.com/chat/completions，这个地址不存在。结尾加斜杠，或在字段里填了 /chat/completions，是另外两种把路径弄错的方式。改正后把覆盖开关关掉再打开，让新值生效，然后再 Verify。

curl 正常，Cursor 不行

保存设置，关闭并重新打开聊天面板；如果还不行，重启 Cursor，设置的改动不一定会应用到已打开的会话。另外确认 OpenAI API Key 开关是打开的，因为 Key 关闭时 Base URL 覆盖不生效。

报错提到余额或额度

额度用完了。在控制台充值即可，失败的请求没有计费。账号是预付制，余额为零时请求会被停止，而不会产生欠费。

响应慢

切换到 MiniMax-M2.7-highspeed，质量相同、延迟更低；同时精简用 @ 附加的上下文。

同一个 Key，其他工具

你为 Cursor 配置的 Key，可以原封不动地用于任何指向 https://yiduochan.com/v1 的 OpenAI SDK，也可以通过 /v1/messages 这个 Messages 接口用于 Anthropic 兼容工具。Claude Code 的环境变量如下：

export ANTHROPIC_BASE_URL=https://yiduochan.com
export ANTHROPIC_AUTH_TOKEN=<API key>
export ANTHROPIC_MODEL=MiniMax-M2.7
# optional
export ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7-highspeed

该配置及其限制见在 Claude Code 中使用 MiniMax；完整模型清单（包括语音模型）见 MiniMax 模型总览。具体配置问题请发邮件至 support@yiduochan.com。

常见问题

Cursor 能用 MiniMax 模型吗？

可以。在 Cursor Settings > Models 中把 MiniMax-M2.7、MiniMax-M2.7-highspeed 或 MiniMax-M3 添加为自定义模型名，打开 OpenAI API Key 并填入你的 YiduoChan Key，再把 OpenAI Base URL 覆盖为 https://yiduochan.com/v1。

在 Cursor 里接入 MiniMax 时 Base URL 填什么？

准确填写 https://yiduochan.com/v1，包含 /v1、不要结尾斜杠；Cursor 会自己拼上 /chat/completions。

在 Cursor 里该选哪个 MiniMax 模型？

默认选 MiniMax-M2.7，每百万 tokens 输入 $0.30、输出 $1.20；MiniMax-M2.7-highspeed 质量相同、延迟更低，价格翻倍；MiniMax-M3 提供 1,048,576 tokens 上下文，适合超大提示。详见 MiniMax-M2.7 与 MiniMax-M3。

为什么 Cursor 使用 MiniMax 时返回 model_not_found？

Cursor 发送的模型名必须与 MiniMax-M2.7、MiniMax-M2.7-highspeed 或 MiniMax-M3 完全一致；另外要取消勾选内置的 OpenAI 模型名，因为 Cursor 可能把它们路由到覆盖后的 Base URL，而那里没有这些模型。

为什么 Cursor 的 Verify 按钮报 401？

401 表示 Key 被拒绝：从 YiduoChan 控制台重新复制 API Key，不要带前后空格，粘贴到 OpenAI API Key 字段（不是 Anthropic 或 Google 字段），并确认该 Key 仍处于启用状态。

Cursor 调用 MiniMax 如何计费？

YiduoChan 按实际使用的 token 从预付美元额度中扣费，无订阅；新账号有 $0.10 试用额度，最低充值 $5，失败的请求不计费。完整价格见定价页，注册即可创建 Key。

免费注册获取 API Key 查看完整模型定价