How to use your own API key in Cursor
AutoRouter6 min read
Key facts
- Cursor takes your own keys for OpenAI, Anthropic, Google, Azure OpenAI and AWS Bedrock under Cursor Settings > Models (Cursor, checked November 13, 2026).
- On individual plans, requests on your own key don't draw from included usage or prepaid credit. On Teams and Enterprise, eligible third-party models carry the Cursor Token Rate of $0.25 per million tokens, including on your own key.
- Plus ($8 a month) doesn't allow your own API keys, and custom keys never cover Tab completion.
- Cursor's Zero Data Retention policy doesn't apply to requests on your own key; your provider's policy does.
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:
- Open Cursor Settings and go to Models.
- Find the provider you want: OpenAI, Anthropic, Google, Azure OpenAI or AWS Bedrock.
- Paste your API key into the provider's field.
- 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.
| Provider | What your key covers |
|---|---|
| OpenAI | Standard, non-reasoning chat models; the picker shows which |
| Anthropic | All Claude models available through the Anthropic API |
| Gemini models available through the Google AI API | |
| Azure OpenAI | Models deployed in your Azure OpenAI Service instance |
| AWS Bedrock | Models 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."
| Plan | Own API key | Cursor charge on top of your provider's bill |
|---|---|---|
| Plus ($8/month) | Not available | Not applicable |
| Premium, Super, Ultra | Yes | None |
| Legacy Pro, Pro+, Ultra | Yes | None |
| Teams and Enterprise | Yes | Cursor Token Rate of $0.25 per million tokens on eligible models |
| Free and legacy Hobby | Not stated in Cursor's docs | Not 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.
| Model | Provider bills you | Cursor adds on an individual plan | Cursor 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?
- Tab completion. It always runs on Cursor's built-in models.
- Zero Data Retention. Cursor's ZDR policy doesn't apply to requests on your own key; your provider's privacy policy governs them. Cursor tells teams that rely on ZDR to use its built-in models (Cursor).
- Local-only requests. Your key is sent to Cursor's backend with every request, because Cursor builds the final prompt on its servers. Cursor says the key is sent over encrypted connections and isn't stored after the request.
- The Plus plan. Plus runs Cursor's own models only.
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.
| Option | Who bills the model | Plans | Uses Cursor's included pool |
|---|---|---|---|
| Your own API key | Your provider | Premium and above, legacy Pro and above, Teams, Enterprise | No |
| Third-party model from the picker | Cursor, from prepaid credit | Premium and above | No (legacy Pro and above draw from the Other Models pool) |
| Auto, Cost mode | Cursor, as a Cursor-model request | Paid plans except Plus | Yes |
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
- Bring your own API key, Cursor, checked November 13, 2026
- Models & Pricing, Cursor, checked November 13, 2026
- Usage and limits, Cursor, checked November 13, 2026
- Cursor Token Rate, Cursor, checked November 13, 2026
- AWS Bedrock setup, Cursor, checked November 13, 2026