NL ▾
API-sleutel aanvragen

cursorapikey.com/Handleiding

Cursor API-sleutels werken niet: fixes voor aangepaste endpoint

Wanneer Cursor API-sleutels niet werken, is de oorzaak bijna altijd een van vier dingen: de base URL, de modelnaam, de sleutel zelf, of een limiet op de account. Een enkele curl-opdracht vertelt je welke het is.

Bijgewerkt

Abstract code-editorpaneel met een gloeiende sleutel die wordt ingevoegd, een moersleutel en een loep ernaast
Isometrische tak met paden naar een editor, een server en een terminal, die het kiezen van een alternatief voor Cursor illustreert

Belangrijkste punten

  • Test de sleutel eerst buiten Cursor met curl; als curl werkt, ligt het probleem in de Cursor-instellingen.
  • De base URL moet https://api.cursorapikey.com/v1 zijn en de modelnaam moet exact uncensored zijn.
  • 401 betekent een slechte sleutel, 404 een slechte URL, 429 een rate- of concurrency-limiet, en een modelfout een verkeerde naam.
  • Menu-items wijzigen tussen Cursor-versies, dus match het doel van het veld in plaats van de exacte tekst.

Stap 1: test de sleutel buiten Cursor

Haal Cursor uit de vergelijking. Als een gewoon verzoek werkt, zijn je sleutel en account in orde en ligt de fout in de editorinstellingen. Als het mislukt, geeft de foutbody het probleem aan.

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

De -i-vlag drukt de statusregel en headers af. Een 200-status met een choices-array betekent succes. De X-Balance-USD-header toont je resterende tegoed, wat het eerste is dat je moet controleren bij een autorisatie- of betalingsfout.

Je kunt ook modellen oplijsten, wat de sleutel bevestigt zonder dat er iets wordt uitgegeven:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

De respons moet de model-ID uncensored bevatten.

Stap 2: stel de velden in Cursor in

Open Cursor's instellingen en zoek het Models-gedeelte. Je hebt drie waarden nodig, en een fout in een van hen produceert een fout die lijkt op een kapotte sleutel.

  1. OpenAI API-sleutel: plak je sleutel zonder spaties of regeleinden aan het begin of einde.
  2. OpenAI base URL overschrijven: schakel de override in en voer https://api.cursorapikey.com/v1 in. Behoud de /v1 en laat /chat/completions weg.
  3. Aangepast model: voeg een model toe met de naam uncensored en schakel het in. Schakel modellen uit die je niet gebruikt, zodat Cursor er geen selecteert die het endpoint niet kent.

Na het opslaan, gebruik de verify-optie als je versie die heeft, en kies dan uncensored in het chat model dropdown-menu. Een nieuw chat-tabblad is een goede test, omdat een oud tabblad het model kan blijven gebruiken waarmee het is gestart. De stap-voor-stap handleiding in hoe je de Cursor API gebruikt toont dezelfde setup met meer context.

Koppel de fout aan de oplossing

Wat je zietWaarschijnlijke oorzaakOplossing
401, "ongeldige sleutel", "unauthorized"Sleutel verkeerd getypt, afgekapt of ingetrokkenKopieer hem opnieuw vanaf de sleutelpagina; controleer op spaties aan het einde
404, "not found"Verkeerde URL, ontbrekende /v1, of een verdubbelde pathGebruik exact https://api.cursorapikey.com/v1
"model not found" of vergelijkbaarModelnaam verschilt van uncensoredVoeg het aangepaste model toe met die exacte naam, in kleine letters
429 met rate_limitedOver de requests-per-minute limitVertraag; proefsleutels staan 60 per minuut toe, volledige sleutels 300
429 met concurrencyTe veel verzoeken tegelijkVerminder parallelle agent runs; proefsleutel 2, volledige sleutel 8
429 met Retry-After: 5Tijdelijke overbelastingWacht vijf seconden en probeer het opnieuw
Werkt in curl, mislukt in CursorInstelling niet opgeslagen, verkeerd model in het tabblad, of een functie die geen aangepaste sleutels gebruiktZie de volgende sectie

Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus opnieuw proberen terwijl je debugt kost niets.

Wanneer curl werkt maar Cursor nog steeds faalt

Dit is het meest verwarrende geval, en het heeft een paar gebruikelijke verklaringen.

Het verkeerde model is geselecteerd. Cursor houdt zijn eigen ingebouwde modellen in de lijst. Als er een van geselecteerd is, gaat het verzoek helemaal niet naar je endpoint. Selecteer expliciet uncensored in het dropdown-menu van de chat of composer die je gebruikt.

Niet elke feature gebruikt je sleutel. Features die afhankelijk zijn van Cursor's eigen modellen, zoals inline autocomplete, blijven ze mogelijk gebruiken ongeacht de sleutel die je toevoegt. Aangepaste sleutels zijn van toepassing waar je het model kunt kiezen, wat chat- en edit-modi zijn. Controleer Cursor's huidige documentatie, omdat dit tussen releases verandert.

Concurrency vanuit agent mode. Agent en multi-step runs kunnen meerdere verzoeken tegelijk afvuren. Een proefsleutel staat twee tegelijk toe. Als fouten alleen in agent mode verschijnen, raak je waarschijnlijk de concurrency limiet, en een volledige sleutel verhoogt dit naar acht. Een gestreamd verzoek houdt zijn slot vast tot de stream eindigt, dus lange outputs bezetten slots langer.

Tool calls. De API ondersteunt tool calling, met tool_calls gestreamd en resultaten teruggegeven als role: "tool". De kwaliteit van tool use hangt af van het model, dus als een agent run stopt op een tool stap, probeer dan eerst dezelfde taak in gewone chat.

Controleer de accountkant

Als curl een fout retourneert over balans, is de sleutel geldig maar is het tegoed leeg of is de trial verlopen. De trial is $0,50, geldig voor 7 dagen, geclaimd met één klik op de API-sleutelpagina na aanmelding. Daarna heb je een top-up nodig.

Top-ups zijn elk willekeurig geheel bedrag van $20 tot $500, met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Je kunt betalen met crypto (USDT op TRC20, USDC op Base). De prijzenpagina toont de tabel. Als je nog geen sleutel hebt, haal er dan hier een.

Houd één sleutel per tool. Als je een sleutel in meerdere editors en scripts hebt geplakt, worden rate limits gedeeld over hen, wat eruit kan zien als willekeurige fouten.

Scriptcontrole voor een hardnekkig geval

Als je de oorzaak nog steeds niet kunt vinden, voer dan een kort script uit dat nabootst wat de editor doet. Het gebruikt de OpenAI SDK, waar Cursor-style clients op zijn gemodelleerd, en het print het exacte error object.

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

Als het script tekst streamt, zijn het endpoint, de sleutel en het model correct, en is het resterende probleem een Cursor-instelling. Als het een statuscode print, gebruik dan de tabel hierboven. Houd de X-Request-Id waarde aan als je contact opneemt met support, omdat deze het exacte verzoek identificeert. Volledige parameterdetails staan op de documentatiepagina.

Voorkom dat het weer breekt

Een paar gewoontes voorkomen de meeste terugkerende problemen. Sla de sleutel op in één wachtwoordbeheerder en kopieer van daaruit, in plaats van uit chatlogs of notities waar soms regeleinden sluipen. Noteer de drie waarden (base URL, sleutel, modelnaam) zodat je ze na een editorupdate opnieuw kunt invoeren, omdat updates soms overrides resetten. Stuur na elke update eerst een kort chatbericht voordat je met echt werk begint.

Houd de balans in de gaten. De X-Balance-USD header wordt bij elke response teruggegeven, en je kunt het ook lezen van GET /v1/balance. Credit verloopt nooit, dus een bescheiden opwaarding die op de account staat, is niet verspeeld. Als je de sleutel ook uit scripts gebruikt naast de editor, geef lange batch jobs dan een retry loop die vijf seconden wacht bij een 429 en stopt na een paar pogingen, zodat een script je editor niet van zijn concurrency slots kan beroven.

Een coding chat request met 10.000 tokens van file context en een 700-token antwoord kost 10.000 / 1.000.000 x $0,15 = $0,0015 voor input en 700 / 1.000.000 x $0,50 = $0,00035 voor output, ongeveer $0,00185 in totaal. Tarieven zijn $0,15 per 1M input en $0,50 per 1M output tokens. Het artikel over Cursor API prijzen behandelt maandelijkse schattingen.

Als het verzoek dat mislukte een groot was, onthoud dan het venster: prompt plus completion moeten passen in 100.000 tokens, en de request body is beperkt tot 8 MB. Een hele repository aan een chat hangen kan beide overschrijden. Knip de context terug naar de bestanden die er toe doen en probeer het opnieuw.

01

Vragen en antwoorden

Waarom zegt Cursor dat mijn API-sleutel ongeldig is?

Meestal heeft de sleutel een losse spatie, is hij gedeeltelijk gekopieerd of wijst de base URL nog naar een andere service. Kopieer de sleutel opnieuw en bevestig dat de override URL https://api.cursorapikey.com/v1 is.

Welke modelnaam moet ik invoeren?

Voer uncensored in, in kleine letters. Dit is het enige model ID dat de API aanbiedt.

Gebruikt autocomplete mijn sleutel?

Niet per se. Sommige Cursor-functies gebruiken de eigen modellen van Cursor, en aangepaste sleutels zijn vooral van toepassing op chat- en editmodi waarbij je het model kiest.

Worden mislukte verzoeken in rekening gebracht?

Nee. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus opnieuw proberen terwijl je debugt kost niets.

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.