NL ▾
API-sleutel aanvragen

cursorapikey.com/Handleiding

Hoe je Cursor API-sleutels gebruikt met een aangepast endpoint

Zo gebruik je Cursor API-instellingen met je eigen endpoint: plak een sleutel, overschrijf de OpenAI base URL en voeg de modelnaam uncensored toe. De onderstaande stappen duren ongeveer vijf minuten en omvatten een curl-check die je eerst kunt uitvoeren.

Bijgewerkt

Isometrische code-editor verbonden met een serverblok via een gloeiende kabel, ter illustratie van een aangepast API-endpoint

Belangrijkste punten

  • Cursor stelt je in de OpenAI base URL en sleutel te overschrijven, zodat elk OpenAI-compatibel endpoint verzoeken kan afhandelen.
  • Gebruik de base URL https://api.cursorapikey.com/v1 en het model ID uncensored.
  • Test de sleutel met curl voordat je de editor aanraakt, zodat je weet van welke kant een fout komt.
  • Een prompt van 20.000 tokens met een antwoord van 1.000 tokens kost $0,0035.

Wat deze gids behandelt

Mensen die zoeken naar hoe ze Cursor API moeten gebruiken, bedoelen meestal een van twee dingen. Ofwel willen ze een Cursor-service aanroepen vanuit code, ofwel willen ze dat de Cursor-editor zijn modelverzoeken naar een endpoint stuurt dat zij kiezen. Deze gids gaat over het tweede geval. Deze site is een onafhankelijke gehoste API die het OpenAI chat-completions protocol spreekt, dus Cursor kan erop aansluiten op dezelfde manier als op elke OpenAI-achtige server.

Het model erachter is een enkel open-weight model, gerund door een onafhankelijke provider en afgestemd om te antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen. Het is geen officieel Cursor-model en het is geen router tussen leveranciers. Het verwerkt alleen tekst. Voor coderen is dat meestal genoeg: je stuurt code en instructies, je krijgt code en uitleg terug.

Je hebt drie dingen nodig: een API-sleutel, de base URL https://api.cursorapikey.com/v1 en het model ID uncensored. De rest is een kwestie van de juiste velden in de editor vinden.

Stap 1: haal een sleutel op en controleer deze met curl

Meld je aan met Google of e-mail en wachtwoord, en open vervolgens de API-sleutelpagina. Nieuwe accounts kunnen daar met één klik $0,50 aan proeftegoed claimen. Er is geen kaart nodig en het blijft 7 dagen geldig. De proefsleutel is beperkt tot 2 gelijktijdige verzoeken en 60 verzoeken per minuut, wat genoeg is voor een eerste sessie in de editor.

Voordat je Cursor opent, bevestig dan dat de sleutel werkt. Voer dit uit in een terminal, met je sleutel in een omgevingsvariabele:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

De eerste aanroep toont het model. De tweede retourneert een normale chat-completie. Als beide slagen, is elke latere fout in de editor een instellingsprobleem en geen sleutelprobleem. Die scheiding bespaart veel raden.

Stap 2: stel de base URL en sleutel in in Cursor

Open de instellingen van Cursor en ga naar de sectie modellen. Menu-namen en lay-out veranderen tussen releases, dus behandel de labels hieronder als een kaart en controleer de eigen documentatie van Cursor als iets verplaatst is.

  1. Zoek het veld voor een OpenAI API-sleutel en plak je sleutel van deze site.
  2. Schakel de optie in om de OpenAI base URL te overschrijven en voer https://api.cursorapikey.com/v1 in. Houd de /v1 aan het einde en voeg geen /chat/completions toe; de client voegt het pad zelf toe.
  3. Voeg een aangepast model toe en typ uncensored exact, in kleine letters.
  4. Gebruik de knop voor verifiëren of opslaan als de editor die aanbiedt, en selecteer vervolgens het nieuwe model in het chatpaneel.

Stuur een kort bericht zoals "leg deze functie uit" met een bestand open. Een gestreamd antwoord betekent dat de route van begin tot eind werkt. Cursor stuurt het verzoek, het endpoint streamt tokens terug via SSE en de editor rendert ze naarmate ze aankomen.

Twee waarschuwingen. Sommige editorfuncties, zoals inline tab-aanvulling, kunnen draaien op modellen die Cursor beheert en kunnen je sleutel negeren, dus controleer welke functies het aangepaste model daadwerkelijk gebruiken. En omdat Cursor verkeer met een aangepaste sleutel mogelijk via zijn eigen servers routeert, lees de huidige documentatie als je precies wilt weten waar je code naartoe gaat. De quickstart op deze site geeft de API-kant van de overeenkomst weer.

Test hetzelfde endpoint vanuit code

De makkelijkste manier om een probleem te isoleren is het aanroepen van het endpoint met de officiële OpenAI SDK. Als dat werkt, is het endpoint in orde en zit het resterende probleem in de editorconfiguratie.

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Hetzelfde in Node:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

Streaming-responses bevatten aan het einde gebruiksinformatie, zodat je precies kunt loggen hoeveel tokens een verzoek gebruikte. Elke response bevat ook een X-Balance-USD-header met je resterende tegoed en een X-Request-Id die je kunt opgeven als er iets niet klopt.

Wat werkt in een coderingsworkflow

De API ondersteunt streaming, JSON-modus en tool calling (tools, tool_choice, gestreamde tool_calls en resultaten teruggestuurd als role: "tool"). Sampling-instellingen zoals temperature, top_p, stop, seed en de straffen worden doorgegeven. Het contextvenster is 100.000 tokens, gedeeld tussen de prompt en de completion, en max_tokens is optioneel.

Die 100.000 tokens zijn een royaal budget voor code. Een bronbestand van een paar honderd regels is een paar duizend tokens, dus je kunt meerdere bestanden plus een lange instructie opnemen en toch ruimte overlaten voor het antwoord. De maximale request body is 8 MB, wat je met tekst niet zult bereiken.

Sommige gewoontes die een aangepast model prettig maken in een editor:

  • Houd een lage temperature voor code-aanpassingen. Waarden rond 0,2 geven stabielere output; verhoog het alleen voor brainstormsessies.
  • Voeg alleen de bestanden die er echt toe doen. Elk token die je stuurt wordt als input gefactureerd en het hele gesprek wordt bij elke beurt opnieuw verzonden.
  • Vraag om diffs of de gewijzigde functie, niet het hele bestand, als het bestand lang is. Output tokens kosten meer dan input tokens.
  • Gebruik het model voor taken waarbij weigeringen in de weg staan, zoals het schrijven van exploit proof-of-concepts voor je eigen lab, het analyseren van malwaresamples die je geautoriseerd bent te bestuderen, of het genereren van testdata die onaangename echte content imiteert. Alles moet legaal zijn.

De ene harde limiet die de moeite waard is om te herhalen: geen seksuele content waarbij minderjarigen betrokken zijn, onder welke noemer dan ook.

Veelgemaakte fouten oplossen

SymptoomWaarschijnlijke oorzaakOplossing
401 of "ongeldige sleutel"Sleutel geplakt met een spatie, of een oude sleutelKopieer opnieuw van de sleutelpagina; test met curl
404 of "model niet gevonden"Modelnaam anders getyptGebruik uncensored, lowercase, zonder suffix
404 op het padBase URL bevat /chat/completionsEindig de base URL bij /v1
429 met concurrencyTe veel verzoeken tegelijkWacht tot streams klaar zijn; een volledige sleutel staat 8 toe, een proefsleutel 2
429 met rate_limitedMeer dan 300 verzoeken per minuut (60 tijdens de proefperiode)Vertraag, of probeer opnieuw na een pauze
429 met Retry-After: 5Tijdelijke overbelastingProbeer het opnieuw na vijf seconden

Een gestreamd verzoek houdt zijn concurrency slot vast tot de stream eindigt. Als je meerdere chats in Cursor start en ze laat genereren, kun je snel de concurrency limiet op een proefsleutel raken. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus opnieuw proberen kost niets extra.

Wat een codeersessie kost

Prijzen zijn $0,15 per 1M invoertokens en $0,50 per 1M outputtokens, betaald uit prepaid tegoed zonder abonnement. Een typische editor-verzoek heeft een grote prompt (je bestanden) en een kort antwoord. Neem 20.000 invoertokens en 1.000 outputtokens:

  • Input: 20.000 x $0,15 / 1.000.000 = $0,0030
  • Output: 1.000 x $0,50 / 1.000.000 = $0,0005
  • Totaal: $0,0035 per verzoek

Bij 100 verzoeken in een werkdag kost dat $0,35. Het proeftegoed van $0,50 dekt ongeveer 140 dergelijke verzoeken. Na de proefperiode kun je een geheel bedrag van $20 tot $500 opwaarderen, met +5% bonus tegoed vanaf $50, +10% vanaf $100 en +15% vanaf $200. Betaal met crypto (USDT op TRC20, USDC op Base). Je tegoed vervalt nooit, dus een tegoed dat je langzaam gebruikt, is niet verspild. De prijzenpagina heeft de volledige tabel, en de pagina over het alternatief voor Cursor en Copilot legt uit waar dit past naast abonnementseditors.

Prompts worden niet gebruikt voor training.

01

Vragen en antwoorden

Werkt dit met de Cursor-agent en tool calling?

De API ondersteunt function calling met tools, tool_choice en gestreamde tool_calls. Of een specifieke Cursor-functie je aangepaste model gebruikt, hangt af van de editor. Test elke functie na de installatie.

Welke modelnaam moet ik invoeren?

Voer uncensored in, in kleine letters. Dit is het enige model ID en staat vermeld in GET /v1/models.

Is dit de officiële Cursor API?

Nee. Het is een onafhankelijke, OpenAI-compatibele API voor één open-weight model. Cursor stelt je eenvoudig in staat om de OpenAI-instellingen te laten wijzen naar een ander endpoint.

Heb ik een creditcard nodig om het te proberen?

Nee. Het proeftegoed van $0,50 claim je met één klik op de API-sleutelpagina na het inloggen. Er is geen creditcard nodig en het tegoed is 7 dagen geldig.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.