GitHub Copilot API-sleutel gebruiken met Cursor API

API-sleutel compatibiliteit begrijpen

Wanneer ontwikkelaars verwijzen naar een GitHub Copilot API-sleutel, bedoelen ze doorgaans een token dat is gegenereerd binnen het Microsoft GitHub-ecosysteem. Deze sleutel verifieert verzoeken aan de servers van Microsoft, die modellen zoals GPT-4o of gespecialiseerde varianten die geoptimaliseerd zijn voor code, draaien. Hoewel deze modellen krachtig zijn, hebben ze specifieke inhoudsbeperkingen en rate limits die gekoppeld zijn aan je Microsoft-account.

In tegenstelling tot de Cursor API is dit een onafhankelijke dienst. Het maakt geen gebruik van Microsoft-infrastructuur. In plaats daarvan biedt het een enkel open-weight large language model dat is geoptimaliseerd voor coding contexten. Dit model is ontworpen om zonder content refusals te antwoorden bij wettelijk volwassen gebruik, wat het een uniek alternatief maakt voor ontwikkelaars die standaard filters beperkend vinden.

Het begrijpen van dit onderscheid is cruciaal. Je bestaande GitHub Copilot API-sleutel werkt niet met het Cursor API endpoint. Je hebt een aparte sleutel nodig die je genereert via je account op cursorapikey.com. Het onderliggende protocol blijft echter hetzelfde, wat betekent dat je code niet aanzienlijk hoeft te veranderen.

Je omgeving configureren

Om de Cursor API te gebruiken, moet je eerst een sleutel genereren. Meld je aan op de Get API key pagina met alleen een e-mailadres en wachtwoord. Er is geen credit card nodig voor het initiële trial credit. Zodra je geregistreerd bent, wordt je sleutel direct weergegeven. Bewaar deze sleutel veilig in je environment variables, meestal als OPENAI_API_KEY of een aangepaste variabele afhankelijk van de vereisten van je agent.

De meeste coding agents, waaronder Cursor en vergelijkbare tools, vertrouwen op de OpenAI SDK standaard. Dit betekent dat je geen custom library nodig hebt. Je hoeft je SDK alleen naar de juiste base URL te wijzen. De base URL voor de Cursor API is https://api.cursorapikey.com/v1. Dit endpoint is volledig OpenAI-compatible en ondersteunt dezelfde request structures die je al kent.

Zorg ervoor dat je omgeving geconfigureerd is om verzoeken naar deze nieuwe base URL te sturen. De model ID die je moet specificeren in je verzoeken is uncensored. Dit vertelt de API welk specifiek model aangeroepen moet worden. Het is een open-weight model dat draait op onze eigen GPU servers, distinct van GPT, Claude of Gemini.

Base URLs wijzigen

Het overschakelen van een github copilot api key naar de Cursor API houdt voornamelijk het wijzigen van de base URL in je client configuratie in. Als je de officiële OpenAI Python of Node.js SDK's gebruikt, is dit een een-regel wijziging. In Python initialiseer je de client bijvoorbeeld met de nieuwe base URL en je nieuwe API-sleutel.

Deze wijziging stuurt je verzoeken van Microsoft's servers naar onze infrastructuur. De voordelen zijn toegang tot een 100.000 token contextvenster en een model dat afgestemd is op minder refusals. Je kunt de verbinding verifiëren door het /v1/models endpoint te controleren, dat de beschikbare modellen moet teruggeven, inclusief uncensored.

Trade-off: Hoewel de syntax identiek is, betaal je nu per token in plaats van via een Microsoft-abonnement. Onze prijzen zijn transparant: $0,25 per 1M input tokens en $1,00 per 1M output tokens. Er zijn geen maandelijkse kosten, alleen prepaid credit dat nooit vervalt. Dit model is ideaal voor variabele workloads waarbij je geen maandelijkse seat cost wilt vastleggen.

Je verbinding testen

Voordat je de API integreert in je main workflow, is het essentieel om te verifiëren dat je omgeving kan communiceren met de Cursor API. Dit kun je doen met een eenvoudige cURL command of een kort script. Deze test zorgt ervoor dat je sleutel geldig is en de base URL correct is.

Voorbeeld cURL-verzoek:

Stuur een POST verzoek naar https://api.cursorapikey.com/v1/chat/completions met het model ingesteld op uncensored. Voeg een eenvoudige prompt toe in de messages array. Een succesvolle response geeft een completion terug in het choices[0].message.content veld.

Als je een 401 fout ontvangt, is je API-sleutel onjuist. Als je een 429 fout krijgt, heb je de rate limit van 300 verzoeken per minuut per sleutel overschreden. Je kunt je sleutel op elk moment regenereren om de oude ongeldig te maken. Deze test bevestigt dat de basis tekst-in, tekst-uit functionaliteit werkt zoals verwacht.

Streaming responses verwerken

Voor coding agents zijn streaming responses cruciaal voor een soepele user experience. De Cursor API ondersteunt Server-Sent Events (SSE) voor streaming. Dit stelt je in staat om tokens te ontvangen zodra ze gegenereerd zijn, in plaats van te wachten op de volledige response.

Bij het gebruik van de OpenAI SDK kun je streaming inschakelen door de stream parameter op true te zetten. De SDK zal chunks van data yielden zodra ze aankomen. Dit is vooral nuttig voor lange code generaties, waar je voortgang aan de gebruiker wilt tonen of tokens naar een live editor wilt sturen.

Houd er rekening mee dat streaming het underlying model of zijn capabilities niet verandert. Het is puur een delivery mechanism. Het uncensored model houdt zich nog steeds aan het 100.000 token contextvenster en dezelfde prijsstructuur. Streaming is een client-side feature die de perceived latency verbetert zonder het modelgedrag te beïnvloeden.

Tool Calling integratie

Moderne AI coding assistants vertrouwen sterk op tool calling (function calling) om te interageren met de buitenwereld, zoals het uitvoeren van shell commands of het toegang krijgen tot bestanden. De Cursor API ondersteunt dit via de standaard OpenAI-compatible format.

Je kunt tools definiëren in je request met de tools parameter. Het model zal reageren met een tool_calls array als het bepaalt dat een tool gebruikt moet worden. Je applicatie moet vervolgens de tool uitvoeren en de resultaten terugsturen naar de API in een volgend bericht.

Dit proces is identiek aan hoe je een github copilot api key zou gebruiken met Microsoft's modellen. Het voordeel hier is consistentie. Als je bestaande code hebt voor tool calling, kun je deze waarschijnlijk met minimale aanpassingen hergebruiken. Zorg er gewoon voor dat je tool definitions overeenkomen met de verwachte schema voor het uncensored model.

Gebruik monitoren

Omdat je per token betaalt, is het monitoren van je gebruik belangrijk om onverwachte kosten te vermijden. De Cursor API biedt een dashboard waar je je credit balance en usage history kunt bekijken. Je kunt zien hoeveel tokens je hebt verbruikt en hoeveel credit er nog over is.

Belangrijke limits om in de gaten te houden:

• Rate limit: 300 verzoeken per minuut per sleutel.
• Request body grootte: Maximaal 8 MB per verzoek.
• Contextvenster: 100.000 tokens totaal (input + output).

Als je de rate limit overschrijdt, ontvang je een 429 fout. Je kunt je gebruik in realtime monitoren om zeker te zijn dat je binnen deze grenzen blijft. Bovendien kun je je API-sleutel regenereren als je vermoedt dat deze gecompromitteerd is, wat de oude sleutel direct ongeldig maakt.

Problemen oplossen

Zelfs met een robuuste API kunnen er problemen ontstaan. Hier zijn enkele veelvoorkomende problemen en hun oplossingen.

401 Unauthorized: Controleer je API-sleutel. Zorg dat deze correct gekopieerd is en geen leading of trailing spaces heeft. Als je je sleutel hebt geregeneerd, zorg er dan voor dat je de nieuwe gebruikt.

429 Too Many Requests: Je hebt de limiet van 300 verzoeken per minuut overschreden. Implementeer exponential backoff in je client of verlaag de frequentie van je verzoeken.

400 Bad Request: Dit geeft meestal aan dat er een malformed JSON payload is of vereiste velden ontbreken. Zorg dat je messages array correct geformatteerd is en de role en content velden bevat. Controleer ook of de model naam exact uncensored is.

Content Blocking: Hoewel het model ongecensureerd is, blokkeert het wel seksuele content met minderjarigen. Als je verzoek geblokkeerd wordt, kan dit door deze specifieke hard limit komen.