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.