Beta
Download

How to use your own API key in Cursor

AutoRouter6 min read

Key facts

As of November 13, 2026, you add your own API key in Cursor under Cursor Settings > Models: find the provider (OpenAI, Anthropic, Google, Azure OpenAI or AWS Bedrock), paste the key and click Save, as Cursor's API key page describes. That provider's models then appear in the model picker and are billed to your provider account. Cursor's Plus plan doesn't allow your own keys, Tab completion keeps using Cursor's own models, and on Teams and Enterprise a $0.25 per million token rate still applies to eligible models. For Cursor's plans and resets, see Cursor usage limits by plan.

How do you add your own API key in Cursor?

You add a key in Cursor's settings, one provider at a time:

  1. Open Cursor Settings and go to Models.
  2. Find the provider you want: OpenAI, Anthropic, Google, Azure OpenAI or AWS Bedrock.
  3. Paste your API key into the provider's field.
  4. Click Save. The provider's models appear in the model picker.

For AWS Bedrock you can use access and secret keys in the editor, or set up IAM roles from the Cursor dashboard (setup guide). If a key is invalid or the provider rejects it, requests to that provider fail until you update or remove the key.

Which providers and plans support your own API key in Cursor?

Five providers take your own key, and only chat models use it: "Tab completion continues using Cursor's built-in models," Cursor's help page says.

ProviderWhat your key covers
OpenAIStandard, non-reasoning chat models; the picker shows which
AnthropicAll Claude models available through the Anthropic API
GoogleGemini models available through the Google AI API
Azure OpenAIModels deployed in your Azure OpenAI Service instance
AWS BedrockModels available in your Bedrock configuration

Plan support follows from Cursor's plan list, which says Plus has "no Auto, Cloud Agents, Automations, Bugbot, Origin, third-party models, or your own API keys."

PlanOwn API keyCursor charge on top of your provider's bill
Plus ($8/month)Not availableNot applicable
Premium, Super, UltraYesNone
Legacy Pro, Pro+, UltraYesNone
Teams and EnterpriseYesCursor Token Rate of $0.25 per million tokens on eligible models
Free and legacy HobbyNot stated in Cursor's docsNot stated

What does a request on your own API key cost?

On an individual plan, a request on your own key costs whatever your provider charges and nothing from Cursor. On Teams and Enterprise, Cursor adds its Token Rate of $0.25 per million tokens on input, output and cached tokens, unless the model's cache-read price is strictly below $0.10 per million tokens on every pricing tier. Cursor charges only that rate for those tokens, so you aren't billed twice for the model.

To put numbers on it, AutoRouter priced one agent request (8,000 fresh input tokens, 40,000 cache-read tokens and 2,000 output tokens, 50,000 in all) at the Anthropic list prices Cursor shows as of November 13, 2026, leaving out cache writes. The request size is our assumption.

ModelProvider bills youCursor adds on an individual planCursor adds on Teams
Claude Opus 5.5 ($4 / $0.20 / $20 per million)$0.080$0$0.0125
Claude Sonnet 5.5 ($2 / $0.10 / $10)$0.040$0$0.0125
Claude Haiku 5.5 ($0.10 / $0.01 / $0.50)$0.0022$0$0 (cache read under $0.10, exempt)

Sonnet 5.5's cache-read price of exactly $0.10 per million is not strictly below the threshold, so it pays the rate. On a team, the $0.0125 adds about 16% to an Opus 5.5 request of this shape and about 31% to a Sonnet 5.5 request.

What doesn't work with your own API key in Cursor?

How else can you use other models in Cursor?

Without your own key, Premium, Super and Ultra let you pick Claude, GPT and Gemini models directly, billed at API list price from prepaid credit from the first request (Cursor). Auto picks a model for you, in Cost mode on individual plans.

OptionWho bills the modelPlansUses Cursor's included pool
Your own API keyYour providerPremium and above, legacy Pro and above, Teams, EnterpriseNo
Third-party model from the pickerCursor, from prepaid creditPremium and aboveNo (legacy Pro and above draw from the Other Models pool)
Auto, Cost modeCursor, as a Cursor-model requestPaid plans except PlusYes

AutoRouter, the Mac app for Codex and Claude Code, also works with Cursor. You enable Cursor in AutoRouter's setup, and while AutoRouter is the model selected it sends each task to the model that does it best; you can still pick a specific model any time. Cursor Auto mode vs Copilot auto vs AutoRouter compares it with Cursor's Auto.

Questions

Does my own API key count against Cursor's included usage?

Not on individual plans: your provider bills the model cost, and the requests don't draw from included usage or prepaid credit. On Teams and Enterprise, the Cursor Token Rate on eligible models comes out of the team's prepaid credit, or the Other Models allowance on a legacy Teams plan.

Can I point Cursor at a custom base URL or proxy?

Cursor's current API key help page, checked November 13, 2026, lists five providers and doesn't document a custom base URL. Check Cursor Settings > Models in your version, and treat any older guide that describes one as possibly out of date.

Is my API key stored on Cursor's servers?

Cursor says no. The key travels to Cursor's backend with each request over an encrypted connection and isn't persisted after the request completes.

Why do my requests fail after adding a key?

An invalid key, or one your provider rejects, makes every request to that provider fail until you update or remove it. Check that the key is active and has access to the model you picked, and on OpenAI that the model is one of the standard chat models Cursor supports.

Sources