Chei API proprii în Cursor (BYOK) în Cursor IDE

Poți folosi chei API proprii pentru OpenAI, Anthropic, Google, Azure OpenAI și AWS Bedrock; furnizorul te facturează direct, iar cererile trec prin serverele Cursor.

Sintaxă & invocare
Cursor Settings > Models > câmpul API Key al furnizorului

Ce face Chei API proprii în Cursor (BYOK)

În Cursor Settings > Models găsești furnizorul (OpenAI, Anthropic, Google, Azure sau AWS Bedrock), lipești cheia și salvezi. Modelele furnizorului apar apoi în selectorul de modele. Din Cursor 3.20, fiecare furnizor are câmpul lui API Key și comutatorul Use API Key, iar OpenAI are și un comutator de suprascriere a Base URL, cu câmp propriu.

Pe planurile individuale (Premium, Super, Ultra și vechile Pro, Pro+, Ultra), cererile cu cheia ta nu consumă din utilizarea inclusă. Pe Teams și Enterprise se aplică în continuare Cursor Token Rate pe modelele eligibile. Planul Plus nu permite chei API proprii. Cheile proprii merg doar pentru modelele de chat; Tab folosește în continuare modelele Cursor.

Cheia nu se stochează pe serverele Cursor, dar este trimisă la fiecare cerere, pentru că toate cererile trec prin serverele Cursor, unde se construiește promptul final. Zero Data Retention nu se aplică pentru cheile proprii. Documentația nu descrie conectarea unui server de modele care rulează local, de exemplu Ollama.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
OpenAI Modele de chat standard, fără raționament; Base URL se poate suprascrie.
Anthropic Modelele Claude din API-ul Anthropic.
Google Modelele Gemini din Google AI API.
Azure OpenAI Modelele din instanța ta Azure OpenAI Service.
AWS Bedrock Chei de acces în IDE sau roluri IAM configurate din dashboard.

Exemple practice

Exemplul 1: Adăugarea unei chei Anthropic

Cursor Settings → Models → Anthropic → API Key → Save

Greșeli frecvente și bune practici

  • Te aștepți ca Tab să folosească cheia ta. Cheile proprii se aplică doar modelelor de chat.
  • Presupui că o cheie proprie ține codul doar între tine și furnizor. Documentația spune că toate cererile trec prin serverele Cursor.
  • Folosești chei proprii într-o echipă care cere Zero Data Retention.

Comenzi înrudite