DE ▾
API-Schlüssel erhalten

cursorapikey.com/Anleitung

Cursor API-Schlüssel funktionieren nicht: Lösungen für benutzerdefinierte Endpunkte

Wenn Cursor API-Schlüssel nicht funktionieren, liegt die Ursache fast immer an einem von vier Dingen: der Base URL, dem Modellnamen, dem Schlüssel selbst oder einem Limit auf dem Konto. Ein einzelner curl-Befehl zeigt dir, woran es liegt.

Aktualisiert

Abstrakte Code-Editor-Panels mit einem leuchtenden Schlüssel, der eingefügt wird, sowie einem Schraubenschlüssel und einer Lupe daneben
Isometrische Gabelung mit Pfaden zu einem Editor, einem Server und einem Terminal, die die Wahl einer Alternative zu Cursor veranschaulicht

Wichtige Punkte

  • Teste den Schlüssel zuerst außerhalb von Cursor mit curl; wenn curl funktioniert, liegt das Problem in den Cursor-Einstellungen.
  • Die Base URL muss https://api.cursorapikey.com/v1 sein und der Modellname muss exakt uncensored lauten.
  • 401 bedeutet einen falschen Schlüssel, 404 eine falsche URL, 429 ein Raten- oder Concurrency-Limit und ein Modellfehler einen falschen Namen.
  • Menübeschriftungen ändern sich zwischen Cursor-Versionen, also passe die Feldfunktion an und nicht unbedingt die genaue Bezeichnung.

Schritt 1: Teste den Schlüssel außerhalb von Cursor

Schalte Cursor aus dem Bild. Wenn eine einfache Anfrage funktioniert, sind dein Schlüssel und dein Konto in Ordnung und der Fehler liegt in den Editor-Einstellungen. Wenn sie fehlschlägt, nennt der Fehlerkörper das Problem.

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."}]}'

Der Flag -i gibt die Statuszeile und die Header aus. Ein Status von 200 mit einem choices-Array bedeutet Erfolg. Der Header X-Balance-USD zeigt dein verbleibendes Guthaben an, was das Erste ist, das du bei einem Autorisierungs- oder Zahlungsfehler prüfen solltest.

Du kannst auch Modelle auflisten, was den Schlüssel bestätigt, ohne etwas auszugeben:

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

Die Antwort sollte die Modell-ID uncensored enthalten.

Schritt 2: Setze die Felder in Cursor

Öffne die Cursor-Einstellungen und suche den Abschnitt Modelle. Du benötigst drei Werte, und ein Fehler in einem von ihnen führt zu einem Fehler, der wie ein defekter Schlüssel aussieht.

  1. OpenAI API key: Füge deinen Schlüssel ohne Leerzeichen oder Zeilenumbrüche an den Enden ein.
  2. Override OpenAI base URL: Aktiviere das Override und gib https://api.cursorapikey.com/v1 ein. Behalte das /v1 bei und entferne /chat/completions.
  3. Custom model: Füge ein Modell namens uncensored hinzu und aktiviere es. Deaktiviere Modelle, die du nicht nutzt, damit Cursor nicht eines auswählt, das der Endpunkt nicht kennt.

Speichere die Einstellungen und nutze die Verify-Option, falls deine Version eine hat, und wähle dann uncensored im Dropdown-Menü des Chat-Modells. Ein neuer Chat-Tab ist ein guter Test, da ein alter Tab möglicherweise das Modell behält, mit dem er gestartet wurde. Die Schritt-für-Schritt-Anleitung in so nutzt du die Cursor API zeigt dieselbe Einrichtung mit mehr Kontext.

Ordne den Fehler der Lösung zu

Was du siehstWahrscheinliche UrsacheLösung
401, "ungültiger Schlüssel", "nicht autorisiert"Schlüssel falsch eingegeben, abgeschnitten oder widerrufenKopiere ihn erneut von der Schlüssel-Seite; prüfe auf nachgestellte Leerzeichen
404, "nicht gefunden"Falsche URL, fehlendes /v1 oder ein doppelter PfadNutze exakt https://api.cursorapikey.com/v1
"Modell nicht gefunden" oder ähnlichModellname unterscheidet sich von uncensoredFüge das benutzerdefinierte Modell mit diesem exakten Namen, kleingeschrieben, hinzu
429 mit rate_limitedRatenlimit für Anfragen pro Minute überschrittenVerlangsamen; Test-Schlüssel erlauben 60 Anfragen pro Minute, Voll-Schlüssel 300 Anfragen pro Minute
429 mit concurrencyZu viele Anfragen gleichzeitigReduziere parallele Agent-Ausführungen; Test-Schlüssel 2 parallele Anfragen, Voll-Schlüssel 8 parallele Anfragen
429 mit Retry-After: 5Vorübergehende ÜberlastungFünf Sekunden warten und erneut versuchen
Funktioniert in curl, fehlschlägt in CursorEinstellung nicht gespeichert, falsches Modell im Tab oder Funktion, die keine benutzerdefinierten Schlüssel nutztSiehe den nächsten Abschnitt

Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also kostet es nichts, beim Debuggen erneut zu versuchen.

Wenn curl funktioniert, Cursor aber trotzdem fehlschlägt

Dies ist der verwirrendste Fall und hat einige übliche Erklärungen.

Das falsche Modell ist ausgewählt. Cursor behält seine eigenen eingebauten Modelle in der Liste. Wenn eines davon ausgewählt ist, geht die Anfrage überhaupt nicht zu deinem Endpunkt. Wähle uncensored explizit im Dropdown-Menü des Chats oder Composers, den du nutzt.

Nicht jede Funktion nutzt deinen Schlüssel. Funktionen, die auf den eigenen Modellen von Cursor basieren, wie die Inline-Vervollständigung, nutzen diese möglicherweise weiterhin, unabhängig vom hinzugefügten Schlüssel. Benutzerdefinierte Schlüssel gelten dort, wo du das Modell auswählen kannst, also in den Modi Chat und Edit. Prüfe die aktuellen Dokumentationen von Cursor, da sich dies zwischen den Releases ändert.

Parallele Anfragen aus dem Agentenmodus. Agenten und Multi-Schritt-Ausführungen können mehrere Anfragen gleichzeitig auslösen. Ein Testguthaben erlaubt zwei parallele Anfragen gleichzeitig. Tritt der Fehler nur im Agentenmodus auf, überschreitest du das concurrency-Limit, und ein Voll-Schlüssel erhöht es auf acht. Eine gestreamte Anfrage belegt ihren Slot bis zum Ende des Streams, daher belegen lange Ausgaben die Slots länger.

Function Calling. Die API unterstützt Function Calling, wobei tool_calls gestreamt und Ergebnisse als role: "tool" zurückgegeben werden. Die Qualität der Function-Calling-Nutzung hängt vom Modell ab, also versuche bei einem Stau eines Agenten-Laufs auf einem Function-Calling-Schritt zuerst dieselbe Aufgabe im normalen Chat.

Prüfe die Konto-Seite

Wenn curl einen Fehler bezüglich des Guthabens zurückgibt, ist der Schlüssel gültig, aber das Guthaben ist leer oder das kostenlose Testguthaben ist abgelaufen. Das kostenlose Testguthaben beträgt 0,50 $, ist 7 Tage gültig und wird mit einem Klick auf der API-Schlüssel-Seite nach der Anmeldung beansprucht. Danach benötigst du eine Aufladung.

Aufladungen sind beliebige ganze Beträge von $20 bis $500, mit +5 % ab $50, +10 % ab $100 und +15 % ab $200. Du kannst mit Krypto (USDT auf TRC20, USDC auf Base) bezahlen. Die Preisseite zeigt die Tabelle. Falls du noch keinen Schlüssel hast, hol dir hier einen.

Halte einen Schlüssel pro Tool. Wenn du einen Schlüssel in mehrere Editoren und Skripte eingefügt hast, werden die Ratenlimits über diese hinweg geteilt, was wie zufällige Fehler aussehen kann.

Skript-Check für einen hartnäckigen Fall

Wenn du die Ursache immer noch nicht findest, führe ein kurzes Skript aus, das das Verhalten des Editors nachahmt. Es nutzt das OpenAI SDK, an dem sich Cursor-ähnliche Clients orientieren, und gibt das genaue Fehlerobjekt aus.

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)

Wenn das Skript Text streamt, sind Endpunkt, Schlüssel und Modell korrekt, und das verbleibende Problem ist eine Cursor-Einstellung. Wenn es einen Statuscode ausgibt, nutze die Tabelle oben. Behalte den X-Request-Id-Wert, wenn du den Support kontaktierst, da er die genaue Anfrage identifiziert. Vollständige Parameterdetails findest du auf der Dokumentationsseite.

Verhindere, dass es wieder passiert

Einige Gewohnheiten verhindern die meisten wiederkehrenden Probleme. Speichere den Schlüssel in einem einzigen Passwortmanager-Eintrag und kopiere ihn von dort, statt aus Chat-Protokollen oder Notizen, wo Zeilenumbrüche einschleichen. Schreibe die drei Werte (Base URL, Schlüssel, Modellname) auf, damit du sie nach einem Editor-Update erneut eingeben kannst, da Updates Overrides manchmal zurücksetzen. Sende nach jedem Update eine kurze Chat-Nachricht, bevor du mit der eigentlichen Arbeit beginnst.

Behalte das Guthaben im Auge. Der Header X-Balance-USD wird bei jeder Antwort zurückgegeben, und du kannst ihn auch über GET /v1/balance auslesen. Guthaben verfällt nie, also ist eine moderate Aufladung auf dem Konto nicht verschwendet. Wenn du den Schlüssel sowohl in Skripten als auch im Editor nutzt, gib langen Batch-Jobs eine Retry-Schleife, die bei einem 429 fünf Sekunden wartet und nach einigen Versuchen stoppt, damit ein Skript deinen Editor nicht von seinen parallelen Anfragen-Slots aushungert.

Eine Coding-Chat-Anfrage mit 10.000 Token Dateikontext und einer 700-Token-Antwort kostet 10.000 / 1.000.000 × $0,15 = $0,0015 für Input-Token und 700 / 1.000.000 × $0,50 = $0,00035 für Output-Token, insgesamt etwa $0,00185. Die Preise liegen bei $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token. Der Artikel über Cursor API-Preise deckt monatliche Schätzungen ab.

Wenn die fehlgeschlagene Anfrage eine große war, denke an das Fenster: Prompt plus Completion müssen in 100.000 Token passen, und der Request Body ist auf 8 MB begrenzt. Das Anhängen eines ganzen Repositorys an einen Chat kann beides überschreiten. Kürze den Kontext auf die relevanten Dateien und versuche es erneut.

01

Fragen und Antworten

Warum sagt Cursor, mein API-Schlüssel sei ungültig?

Normalerweise hat der Schlüssel ein fehlbares Leerzeichen oder wurde teilweise kopiert, oder die Basis-URL zeigt noch auf einen anderen Dienst. Kopiere den Schlüssel erneut und bestätige dann, dass die Override-URL https://api.cursorapikey.com/v1 ist.

Welchen Modellnamen gebe ich ein?

Gib uncensored in Kleinbuchstaben ein. Dies ist die einzige Modell-ID, die die API anbietet.

Nutzt die Autovervollständigung meinen Schlüssel?

Nicht unbedingt. Einige Cursor-Funktionen verwenden Curors eigene Modelle, und benutzerdefinierte Schlüssel gelten hauptsächlich für Chat- und Edit-Modi, in denen du das Modell wählst.

Werden fehlgeschlagene Anfragen abgerechnet?

Nein. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, sodass das Wiederholen beim Debuggen nichts kostet.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.