How to use model APIs in Cursor - Alibaba Cloud Model Studio

Install Cursor

Download and install Cursor from the Cursor official website.

Configure Access Credentials

In Cursor, click the settings icon and go to Cursor Settings > Models. Enable OpenAI API Key and Override OpenAI Base URL, then enter the API Key, Base URL, and model name corresponding to your selected plan.

Model Studio offers three billing plans. Choose based on your needs:

Token Plan (Team Edition): Seat-based subscription; token consumption deducts Credits.
Coding Plan: Fixed monthly subscription, metered by model invocation count.
Pay-as-you-go: Post-paid based on actual usage.

Token Plan (Team Edition)

API Key

Token Plan (Team Edition) dedicated API Key

Base URL

https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

Available models

Token Plan (Team Edition) supported models

Some model names need adjustment: kimi-k2.6 should be written as kimi-k2-6, kimi-k2.5 as kimi-k2-5, glm-5.2 as glm-5-2, glm-5.1 as glm-5-1, and glm-5 as glm-5-0.

Coding Plan

API Key

Coding Plan dedicated API Key

Base URL

https://coding-intl.dashscope.aliyuncs.com/v1

Available models

Coding Plan supported models

Some model names need adjustment: kimi-k2.5 should be written as kimi-k2-5, glm-4.7 as glm-4-7, and glm-5 as glm-5-0.

Pay-as-you-go

API Key

Alibaba Cloud Model Studio API Key

Base URL

Enter the URL corresponding to your region:

China North 2 (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1
Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Replace WorkspaceId with your actual Get the Workspace ID
US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1

Available models

Enter a supported model.

Some model names need to be adjusted: write kimi-k2.6 as kimi-k2-6, kimi-k2.5 as kimi-k2-5, glm-5.2 as glm-5-2, glm-5.1 as glm-5-1, glm-5 as glm-5-0.

FAQ

Error Codes

If you encounter errors during configuration, refer to the FAQ documentation for the corresponding billing plan:

Pay-as-you-go: Error codes
Coding Plan: Coding Plan FAQ
Token Plan (Team Edition): Token Plan (Team Edition) FAQ

Cannot invoke an added model in Cursor

Error messages:

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.

Cause: The free version of Cursor only supports Auto mode and does not support invoking custom models.

Solution: Upgrade to Cursor Pro or a higher plan.

Cannot find the added model after configuration

In the chat panel, click to disable Auto mode, then select the desired model from the model dropdown.

Model invocation error: "We're having trouble connecting to the model provider." or "Unauthorized User API key"

Troubleshoot the following items:

Verify that the API Key, Base URL, and model name match the selected billing plan. Credentials are not interchangeable between plans.
Some model names conflict with Cursor's built-in model names and require aliases. Refer to the available models section above for details.