Cursor gebruiken met een gratis LLM API
Cursor kan chataanvragen naar je eigen OpenAI API-sleutel sturen. Deze gids laat zien hoe je die sleutel koppelt aan gratis modellen via FreeLLMAPI. Ook staan er de beperkingen in. Cursor stuurt elke aanvraag via de eigen servers, en Tab-aanvullen gebruikt altijd de modellen van Cursor.
Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.
Wat werkt en wat niet werkt
Lees dit deel voordat je begint. De ondersteuning van Cursor voor eigen sleutels is smaller dan in de meeste andere editors.
| Functie van Cursor | Met je eigen sleutel | Bron |
|---|---|---|
| Chat met een standaard OpenAI-stijl model | Ja. Cursor documenteert eigen OpenAI-sleutels voor standaard chatmodellen zonder redenering. | Helppagina Cursor API-sleutels |
| Tab-aanvullen | Nee. Cursor zegt dat Tab de ingebouwde modellen van Cursor blijft gebruiken. | Helppagina Cursor API-sleutels |
| Agentmodus en Composer | Niet bevestigd. De documentatie van Cursor noemt alleen chatmodellen. Test het op je plan voordat je erop vertrouwt. | Niet gedocumenteerd |
| Aanvragen vanaf localhost | Nee. Cursor stuurt alle aanvragen via de eigen servers om de prompt op te bouwen, dus localhost op je computer zit niet in het pad. | Helppagina Cursor API-sleutels |
Plannen zijn ook belangrijk. De prijspagina van Cursor noemt modellen van derden en eigen API-sleutels op de plannen Premium, Super en Ultra. Er staat dat het Plus-plan geen eigen API-sleutels heeft. Voor het Free-plan staat op de pagina dat modellen van derden niet beschikbaar zijn. Controleer de prijspagina voor je plan voordat je verdergaat.
localhost. Lees Cline, Roo Code en Kilo Code met een gratis API.Stap 1: installeer FreeLLMAPI en maak het bereikbaar
FreeLLMAPI is open source en draait op je computer in Docker. Installeer het en voeg daarna ten minste twee gratis providersleutels toe op de pagina Keys.
Installeren op macOS of Linux
curl -fsSL https://freellmapi.co/install.sh | bashKopieer je uniforme sleutel van de pagina Keys. Geef de gateway daarna een publiek HTTPS-adres, omdat de servers van Cursor je localhost niet kunnen bereiken. Gebruik een betrouwbare HTTPS-tunnel of een server die je zelf beheert. De FreeLLMAPI-gids voor Cursor drukt deze stappen af:
De Cursor-gids afdrukken
npx freellmapi setup-cursorDit commando schrijft geen bestand. Cursor heeft geen configuratiebestand voor deze instelling, dus je voert de waarden in bij de instellingen van Cursor.
Authorization kan sturen, maak dan een apart in te trekken URL-token onder Keys, Agents. Trek het in wanneer je stopt.Stap 2: stel de sleutel en base URL in Cursor in
- Open Cursor Settings.
- Open Models.
- Zoek het veld OpenAI API key. Plak je uniforme FreeLLMAPI-sleutel. Klik op Save.
- Zet de override van de OpenAI base URL aan. De FreeLLMAPI-gids noemt deze instelling Override OpenAI Base URL.
- Voer je publieke adres in met
/v1aan het eind, bijvoorbeeldhttps://<your-tunnel-host>/v1. - Kies een model in de modelkiezer en stuur een korte chatbericht.
De privacydocumentatie van Cursor noemt de override van de OpenAI-compatibele base URL. Cursor documenteert de exacte stappen niet. De labels in jouw versie kunnen anders zijn.
Om zeker te weten dat de aanvragen bij de gateway aankomen, open je het aanvraaglog van het dashboard. Elk antwoord heeft ook een header X-Routed-Via die de provider en het model toont dat antwoordde.
Stap 3: kies modellen
Gebruik het model-id auto zodat de router voor elke aanvraag een gratis model kiest. Je kunt ook een catalogus-id gebruiken uit GET /v1/models. De chat van Cursor stuurt bij elk bericht bestandscontext mee, dus gebruik modellen met een groot contextvenster. De tabel toont vandaag gratis modellen met tool calling en ten minste 128K context.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 aanvragen/min 1 req/min per model | Ja | Nee |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 aanvragen/min 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nee |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 aanvragen/min 50 aanvragen/dag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 aanvragen/min 50 aanvragen/dag Shared rate limit | Ja | Nee |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 aanvragen/min 250 aanvragen/dag 70,000 tokens/min ~6M | Ja | Ja |
Toont 10 van 109 overeenkomende gratis modellen. Bekijk alle modellen.
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
Cursor documenteert eigen OpenAI-sleutels voor chatmodellen zonder redenering. Modellen met redenering kunnen via de override falen. Als een model faalt, gebruik dan auto of een ander model uit de tabel.
Rate limits en failover
Elke gratis tier heeft limieten per minuut en per dag. FreeLLMAPI telt het gebruik van elke sleutel. Wanneer één provider een 429-fout stuurt, stuurt de router het verzoek naar het volgende model in je fallbackketen. De chat gaat door en je wijzigt geen instellingen in Cursor.
- Voeg sleutels van vier of meer providers toe. Meer providers geven meer verzoeken per dag.
- Gebruik
auto:fastvoor korte vragen enauto:smartvoor moeilijke codevragen. - Start een nieuwe chat voor elke taak. Een kortere geschiedenis stuurt minder tokens.
Probleemoplossing
| Probleem | Oorzaak | Oplossing |
|---|---|---|
Cursor kan niet verbinden met http://localhost:3001/v1 | Cursor stuurt aanvragen vanaf de eigen servers, niet vanaf je computer | Gebruik een publiek HTTPS-adres voor de gateway |
| Geen optie voor een eigen sleutel | Je Cursor-plan bevat geen eigen API-sleutels | Controleer de tabel met plannen op de prijspagina van Cursor |
401 "Invalid API key" | De sleutel in Cursor is niet je uniforme FreeLLMAPI-sleutel | Kopieer de uniforme sleutel opnieuw van de pagina Keys |
| Tab-aanvullen gebruikt de gateway niet | Cursor gebruikt voor Tab altijd de eigen modellen | Geen oplossing. Gebruik Continue in VS Code voor gratis autocomplete |
| "Alle modellen rate-limited na N pogingen" | Alle sleutels in de keten zitten op hun limiet | Voeg sleutels van meer providers toe, of wacht op de cooldowns |
| Ingebouwde modellen werken niet meer | De override van de base URL staat nog aan | Zet de override uit |
Veelgestelde vragen
Kan ik Cursor gratis gebruiken met mijn eigen API-sleutel?
De prijspagina van Cursor noemt eigen API-sleutels op de plannen Premium, Super en Ultra, en zegt dat het Plus-plan geen eigen sleutels heeft. Op een plan met eigen sleutels geeft FreeLLMAPI de chat gratis modellen, dus de kosten van inferentie zijn $0.
Waarom verbindt Cursor niet met localhost?
Cursor stuurt alle aanvragen via de eigen servers om de prompt op te bouwen. Die servers kunnen localhost op je computer niet bereiken, dus de gateway heeft een publiek HTTPS-adres nodig.
Werkt het Tab-aanvullen van Cursor met een eigen API?
Nee. De documentatie van Cursor zegt dat eigen API-sleutels alleen werken met chatmodellen, en Tab-aanvullen blijft de ingebouwde modellen van Cursor gebruiken.
Welk gratis model is het beste voor Cursor?
Gebruik auto, of een model met tool calling en ten minste 128K context uit de tabel op deze pagina. Cursor stuurt bij elk bericht bestandscontext mee, dus een groot contextvenster is belangrijk.
Wordt mijn code naar Cursor gestuurd als ik mijn eigen sleutel gebruik?
Ja. Cursor zegt dat aanvragen voor de definitieve opbouw van de prompt via de eigen servers gaan. Zero Data Retention geldt niet wanneer je je eigen sleutels gebruikt.
Gerelateerde gidsen
- Gratis AI-modellen in VS Code
- Cline, Roo Code en Kilo Code met een gratis API
- Continue met een gratis LLM-API
- Beste gratis API's voor codemodellen
- Gratis OpenAI-compatibele API-basis-URL's
Bronnen
- Cursor help: API keys (gecontroleerd 20 November 2026)
- Cursor docs: models and pricing (gecontroleerd 20 November 2026)
- Cursor docs: privacy and data governance (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (gecontroleerd 20 November 2026)
- FreeLLMAPI CLI generators (gecontroleerd 20 November 2026)