什么是 Cursor
Cursor 是一款很常见的 AI 编程编辑器，基于代码编辑器工作流做了深度增强，支持聊天、代码生成、重构、Agent 操作和多模型接入。对很多开发者来说，Cursor 的优势在于它既保留了编辑器体验，又把 AI 能力直接带进了写代码的主场。
如果你想把 Cursor 接到 APIporter 上，这篇文章就按公开文档和真实配置路径，带你走一遍从设置 API Key 到添加模型开始使用的完整流程。
接入前需要准备什么
接入前准备补充：在开始配置前，建议先前往 APIporter 官网 https://www.apiporter.com 获取 API Key、接口地址以及当前支持的模型名称，再回到 Cursor 完成配置。
- 已经安装并可正常打开的 Cursor
- APIporter 的 API Key
- APIporter 的 Base URL / 请求地址
- 准备在 Cursor 中使用的模型名称
从公开资料来看，Cursor 支持在设置中填写自己的 API Key，并且支持兼容 OpenAI API 格式的服务商。对于 APIporter 这种底层就是 NewAPI 的服务，优先按 OpenAI 兼容接口接入是最稳的路线。
第一步：进入 Cursor 设置并打开 Models / API Keys
打开 Cursor 后，进入设置页面，在左侧找到 Models 或相关模型配置区域。根据公开教程和文档，这里会同时出现模型管理、自定义模型和 API Keys 相关设置。
如果你的 Cursor 版本较新，通常可以在这里看到：
- Add Custom Model
- OpenAI API Key
- Override OpenAI Base URL
- Verify 验证按钮
第二步：填写 APIporter 的 API Key
在 OpenAI API Key 一栏中，填写你从 APIporter 获取到的 API Key。公开文档普遍提到，这一步填写后需要点击 Verify 做一次验证，只有验证通过，Cursor 才会真正启用这套密钥。
如果验证失败，优先检查以下问题：
- API Key 是否复制完整
- 前后是否多了空格
- 当前账户是否可正常调用接口
第三步：开启 Override OpenAI Base URL
如果你要接的不是 OpenAI 官方接口，而是 APIporter 这样的 OpenAI Compatible 服务，就需要把 Override OpenAI Base URL 打开，并填写 APIporter 提供的真实接口地址。
这里特别要注意：
- 不要把 APIporter 官网首页误填成接口地址
- 不要把后台控制台地址或文档页地址误填成 Base URL
- 应填写 APIporter 实际提供的 API 请求地址
很多 OpenAI 兼容服务会使用带 /v1 的接口地址，但最终还是应以 APIporter 后台给出的实际地址为准。
第四步：添加自定义模型
Cursor 的公开教程里还有一个关键步骤：如果你想用的模型没有默认出现在列表里，需要点击 Add Custom Model，把 APIporter 当前支持的模型名称手动加进去。
这里不要自己乱写简称，模型名称必须和 APIporter 当前支持列表一致。模型 ID 写错时，常常会出现验证看起来没问题，但真正调用时模型不可用的情况。
第五步：回到聊天或编辑界面选择模型
当 API Key、Base URL 和自定义模型都配置完成后，回到 Cursor 的聊天区域或模型切换菜单，在下拉列表中选择刚刚添加的模型。
如果模型已经能正常显示，说明这套配置基本已经接通。接下来发一条简单测试消息，确认实际调用是否正常即可。
常见问题
一、Verify 失败。 先检查 API Key 是否复制完整，再看 Base URL 是否填写成了真实接口地址。
二、模型不显示。 多半是没有添加自定义模型，或者模型名称和 APIporter 支持列表不一致。
三、Base URL 填错。 官网地址不是接口地址，控制台地址也不是接口地址，这是最常见的坑。
四、验证通过但调用失败。 这时要重点检查模型 ID 是否正确，以及 APIporter 当前是否真的支持该模型。
总结
如果你想让 Cursor 接入 APIporter，核心流程就是：进入设置，打开 Models / API Keys，填写 APIporter 的 API Key，开启 Override OpenAI Base URL，必要时用 Add Custom Model 添加模型，然后回到编辑器中选择模型开始使用。
对于希望把 AI 能力直接带进写代码工作流的用户来说，Cursor + APIporter 这套组合是很顺手的：编辑器体验不变，模型来源更灵活，而且继续走 OpenAI 兼容接口，后续维护也更省事。
