使用 Cursor 集成 GenStudio API
Cursor 是一款提供 AI 辅助编程的代码编辑器,支持如代码生成、补全、优化等功能,支持多种编程语言。
Cursor 支持使用 OpenAI 兼容的第三方 API 服务。本教程将指导用户如何在 Cursor 中集成 GenStudio 的 API 服务。
重要
本教程基于 Cursor 的 自带密钥 (BYOK) 功能。自带密钥 (BYOK) 选项允许您使用自己的 API 密钥访问 Cursor 的高级功能,仅向 Cursor 付费订阅用户开放。
获取 API 接入信息
在配置之前,您需要先确定所选的服务模式以获取对应的 API Key。
注意
在调用接口时,不同的应用或客户端工具可能需要您输入完整的 Endpoint(Base URL + 具体路径),或者分别输入 Base URL 与路径。请根据所用工具的要求提供以下参数。
Infini 编码套餐 (Coding Plan)
适用于订阅了预付费编程套餐的开发者,提供专享配额与预算控制。Coding Plan 使用专用的 Base URL 和 Endpoints,请根据您的客户端工具支持的协议(OpenAI 兼容或 Anthropic)来配置。详见 Infini 编码套餐。
API Key:前往编码套餐页面创建 API 密钥。Infini 编码套餐专用 API 密钥均带有
sk-cp-前缀。注意
Infini 编码套餐 (Coding Plan) 仅支持部分模型。实际支持情况请以平台编码套餐页面显示为准。
OpenAI (OpenAI Compatible)
- Base URL:
https://cloud.infini-ai.com/maas/coding/v1 - Endpoints
- Create Chat Completion:
/chat/completions - List Models:
/models
- Create Chat Completion:
- Base URL:
Anthropic (Anthropic Messages)
- Base URL:
https://cloud.infini-ai.com/maas/coding - Endpoints
- Create a Message:
/v1/messages - List Models:
/v1/models
- Create a Message:
- Base URL:
GenStudio 通用 LLM API
适用于按量付费、包并发服务,或希望免费体验(基础服务)的用户,可用于大语言模型、生图模型、视频模型等。GenStudio 通用 LLM API 使用平台通用的的 Base URL 和 Endpoints,请根据您的客户端工具支持的协议(OpenAI 兼容或 Anthropic)来配置。
API Key: 创建以
sk-前缀的 API 密钥。详见 GenStudio API 快速集成。注意
GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费,以及享受的 API 频率上限。详见 LLM API 计费规则。
OpenAI (OpenAI Compatible)
- Base URL:
https://cloud.infini-ai.com/maas/v1 - Endpoints
- Create Chat Completion:
/chat/completions - List Models:
/models
- Create Chat Completion:
- Base URL:
Anthropic (Anthropic Messages)
- Base URL:
https://cloud.infini-ai.com/maas/ - Endpoints
- Create a Message:
/v1/messages - List Models:
/v1/models
- Create a Message:
- Base URL:
在 Cursor 中集成 GenStudio API 服务
我们需要将 Cursor 自带的 OpenAI 服务替换为 GenStudio OpenAI 兼容服务。
警告
- 由于 Cursor 官方限制,非 Cursor 付费订阅用户无法使用本教程中的接入方式接入第三方 API 服务。
- VSCode 中的 GitHub Copilot 提供了与 Cursor 几乎一致的 Agent 编码体验,且不要求付费订阅。
完成以下步骤,在交互时选择需要的大模型,即可在 Cursor 的 Ask/Plan/Agent 模式中使用 GenStudio 的 API 服务。
打开 Cursor 设置,可通过右上角设置按钮快速进入设置页。
进入 Models 页面,点击Add Custom Model,添加 GenStudio 支持的模型,例如
minimax-m2.1。在 Models 页面,找到 OpenAI API Key 模块,继续完成以下配置:
- API Key:填写在 GenStudio 获取的 API 密钥
- Override OpenAI Base URL:填写
https://cloud.infini-ai.com/maas/v1
提示
如果您订阅了 Infini 编码套餐 (Coding Plan),请使用 Base URL
https://cloud.infini-ai.com/maas/coding/v1和对应的套餐 API Key (sk-cp-开头)。注意
由于 GenStudio AI 服务替换了 Cursor 内置 OpenAI 服务,配置完成后,Cursor 预置模型列表的部分模型可能无法使用。建议您在 Cursor 模型列表中直接禁用 GenStudio 不支持的模型。
如果在 Models 页面缺少期望的模型,可通过 Add Custom Models 自行添加。建议选用支持工具调用,并有出色的智能体/工具框架泛化能力的模型,例如
minimax-m2.1
警告
- 一般情况下,您填写的 Model Name 必须与 GenStudio API 服务支持的模型名称保持完全一致。如需查询模型名称,可前往 GenStudio 模型广场。
- 例外情况:使用 Coding Plan 时 GLM 与 KIMI 系列模型必须采用全大写形式,否则无法正常工作。例如:
GLM-5/GLM-4.7/KIMI-K2.5 - 例外情况:使用 GenStudio 通用 LLM API 时, GLM 与 KIMI 系列模型暂时无法正常工作。
相关文档
更多关于 GenStudio API 的使用说明,请参考以下文档。