如何在 Cursor 中使用大模型 API - 大模型服务平台百炼

阿里云百炼支持通过 Cursor 使用千问系列模型。您可在 Cursor 中配置 OpenAI 兼容的 Base URL 和 API Key，将模型切换为百炼提供的模型进行代码编写与对话。

模型配置

文本生成-千问	千问Max、千问Plus、千问Flash、千问Turbo、千问Coder、QwQ
文本生成-千问-开源版	Qwen3.5、Qwen3、QwQ-开源版、QwQ-Preview、Qwen2.5、Qwen-Coder

深度研发与架构设计：推荐使用qwen3.5-plus 、qwen3-max、qwen3-coder-next（兼具代码能力与响应速度）、qwen3-coder-plus。适用于复杂算法实现、系统架构设计及核心逻辑推理。
辅助编码与轻量任务：推荐使用 qwen3-coder-next、qwen3.5-flash。适用于代码补全、解释及日常脚本编写。

通过 Cursor 官网下载并安装 Cursor。

重要

由于 Cursor 的产品限制，仅订阅 Cursor Pro 及以上套餐的用户支持配置自定义模型，否则会报错，请参见报错信息。

注册账号：若无阿里云账号，需首先注册。
如遇问题，请参见注册阿里云账号。
开通阿里云百炼：使用阿里云主账号前往阿里云百炼大模型服务平台，阅读并同意协议后，将自动开通阿里云百炼，如果未弹出服务协议，则表示您已经开通。
如果开通服务时提示"您尚未进行实名认证"，请先进行实名认证。

首次开通百炼后，您可领取新人免费额度（有效期：百炼开通后90天内），用于模型推理服务。免费额度领取方法和详情，请查看新人免费额度页面。

说明

超出额度或期限将产生费用，开启免费额度用完即停功能可避免此情况下产生费用，具体费用请以控制台的实际报价和最终账单为准。

重要

本文档仅适用于按量付费模式，Coding Plan 用户请使用专属 Base URL 和 API Key 接入，详情请参考Cursor Coding Plan说明文档进行配置。

在 Cursor 中，点击图标，单击Cursor Settings，选择Models页面。
开启 OpenAI API Key，填入阿里云百炼API Key
开启 Override OpenAI Base URL，根据地域填入服务地址：
- 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
- 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1
- 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
在Add or search model中，输入要使用的模型名称，点击Add Custom Model，建议选择代码能力较强的模型，各模式支持的模型请参见模型列表。

配置完成后，在聊天面板中选择已配置的模型即可开始使用。

2026-02-03_17-20-29

A：如果在界面看到了如下报错：

The model xxx does not work with your current plan or api key.
Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

由于 Cursor 的产品限制，Cursor 免费版仅支持Auto模式，且不支持调用自定义模型。请升级至Cursor Pro 及以上套餐，即可正常使用阿里云百炼支持的模型。

A：请在聊天面板点击并关闭Auto模式，在模型下拉栏选择所需模型。

A：可能有以下原因：

您调用的模型不存在，各部署模型模式支持的模型请参见模型列表。
在配置了阿里云百炼的请求地址和API Key后，调用其他模型提供商的模型将导致报错。如需使用其他模型，请依据情况重新配置或关闭OpenAI API Key和Override OpenAI Base URL。
报错可能源于 Cursor 软件与部分模型不兼容，而非配置或模型提供商的问题。

A：响应速度受多种因素影响，建议：