Ist dies der offizielle Cursor API-Schlüssel?

Nein. Dies ist eine eigenständig gehostete API mit eigenen Schlüsseln. Sie wird nicht vom Cursor-Anbieter hergestellt oder mit diesem verbunden, und ihr Schlüssel funktioniert nur mit der Base URL dieses Dienstes.

Wo finde ich die Base URL-Einstellung in Cursor?

Schau in den Einstellungen unter Modelle nach dem Abschnitt für den OpenAI API-Schlüssel und der Option, die Base URL zu überschreiben. Die Bezeichnungen variieren je nach Version, daher suche in den Einstellungen nach Base URL.

Kann ich mein bestehendes Abonnement behalten und diesen Schlüssel hinzufügen?

Normalerweise ja. Ein benutzerdefinierter Schlüssel ändert nur den Zielort der Chat-Anfragen, wenn du das benutzerdefinierte Modell auswählst. Dein Konto und dein Plan werden separat vom Editor-Anbieter verwaltet.

Was passiert, wenn ich den Schlüssel verliere oder er geleakt wird?

Generiere ihn auf der API-Schlüssel-Seite neu. Der alte Schlüssel funktioniert sofort nicht mehr. Konten, die Prepaid-Guthaben aufgeladen haben, können bis zu 5 Schlüssel speichern, sie beschriften und jeden einzelnen widerrufen.

Cursor AI API-Schlüssel: Platz für eigenen Schlüssel

Die kurze Antwort

Editoren der Cursor-Familie benötigen drei Werte, um mit einem benutzerdefinierten Anbieter zu kommunizieren: eine Base URL, einen API-Schlüssel und einen Modellnamen. Für diesen Dienst sind dies:

Base URL: https://api.cursoraiapikey.com/v1
API-Schlüssel: der Schlüssel von der API-Schlüssel-Seite
Modellname: uncensored

Öffne die Editor-Einstellungen und suche den Modellbereich. Cursor bietet ein Feld für einen OpenAI API-Schlüssel und eine Option zum Überschreiben der OpenAI Base URL, aber Menübezeichnungen ändern sich zwischen Versionen, suche also in den Einstellungen nach "base URL", wenn du sie nicht findest. Füge die URL und den Schlüssel ein, füge ein benutzerdefiniertes Modell namens uncensored hinzu und verwende die Schaltfläche "Überprüfen", falls deine Version diese hat.

Dieser Dienst ist unabhängig von Cursor. Es ist eine separate gehostete API und sie ersetzt nicht das eigene Konto oder Abonnement des Editors. Du verweist den Chat des Editors nur auf einen anderen OpenAI-kompatiblen Server.

Zwei Arten von Schlüsseln, zwei verschiedene Orte

Menschen verwenden dasselbe Wort für zwei unverwandte Dinge, und das Verwechseln ist der häufigste Grund für eine fehlgeschlagene Einrichtung.

Der Konto-Login

Der Editor hat seinen eigenen Login. Dieser identifiziert dich beim Editor-Anbieter und hat nichts mit einem Modellanbieter zu tun. Du fügst keinen Anbieter-Schlüssel in den Login-Bildschirm ein.

Der Anbieter-Schlüssel

Dies ist eine geheime Zeichenfolge, die von einem Unternehmen ausgestellt wird, das ein Modell betreibt. Du fügst sie in die Modelleinstellungen zusammen mit einer Basis-URL ein, und der Editor sendet sie in einem Authorization: Bearer-Header mit jeder Anfrage. Ein Schlüssel von diesem Dienst funktioniert nur gegen die Basis-URL dieses Dienstes, und ein Schlüssel eines anderen Anbieters funktioniert hier nicht.

Wenn du hier gelandet bist, weil du eine Möglichkeit suchst, den eigenen Schlüssel des Editors kostenlos zu erhalten, dann ist dies nicht der richtige Weg. Wenn du ein günstiges Textmodell hinter dem Chat-Panel des Editors möchtest, lies weiter. Das gleiche Muster funktioniert für jeden Editor, der einen OpenAI-kompatiblen Endpunkt akzeptiert, und der Artikel zum Ersetzen eines Claude-Schlüssels behandelt den parallelen Fall für Anthropic-ähnliche Einrichtungen.

Endpunkt testen, bevor du den Editor berührst

Ein zweiminütiger Test außerhalb des Editors sagt dir, ob das Problem der Schlüssel oder der Editor ist. Erstelle ein Konto, beanspruche das Testguthaben auf der Schlüssel-Seite und führe dies aus:

curl https://api.cursoraiapikey.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 ok."}]
  }'

Du solltest einen JSON-Body mit einem choices Array erhalten. Die Antwort-Header enthalten X-Balance-USD, das zeigt, was noch auf deinem Guthaben übrig ist. Der gleiche Aufruf in Python mit dem offiziellen SDK:

from openai import OpenAI

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

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

Wenn beide Aufrufe funktionieren, ist der Schlüssel in Ordnung und jeder spätere Fehler stammt aus den Editor-Einstellungen.

Schritt für Schritt im Editor

Melde dich mit Google oder mit E-Mail und Passwort an, dann beanspruche das $0,50 Testguthaben auf der API-Schlüssel-Seite. Es benötigt keine Karte und ist 7 Tage gültig.
Kopiere den Schlüssel. Behandle ihn wie ein Passwort.
Öffne im Editor die Einstellungen und gehe zum Bereich Modelle. Die Namen unterscheiden sich zwischen Versionen, behandle die Bezeichnungen in dieser Liste also als Richtlinie.
Füge den Schlüssel in das Feld für den OpenAI-API-Schlüssel ein.
Aktiviere die Option zum Überschreiben der OpenAI Base URL und gib https://api.cursoraiapikey.com/v1 ein. Behalte den /v1 bei und füge keinen /chat/completions hinzu; der Client fügt den Rest hinzu.
Füge ein benutzerdefiniertes Modell mit dem exakten Namen uncensored hinzu.
Wähle dieses Modell im Chat-Panels aus und sende eine kurze Nachricht.

Wenn deine Version einen Überprüfungs-Schritt ausführt und dieser fehlschlägt, während curl funktioniert, prüfe, ob du kein Leerzeichen am Ende des Schlüssels hinterlassen hast und ob die Base URL am Ende kein zweites /v1 enthält.

Was deinen Schlüssel nutzt und was nicht

Das Festlegen eines benutzerdefinierten Endpunkts ändert nicht unbedingt jede Funktion. Editoren führen oft einige Funktionen, wie Inline-Vervollständigung oder das Anwenden eines Diffs, auf Modelle aus, die der Anbieter selbst hostet, und diese können deinen Schlüssel ignorieren. Chat- und Agenten-ähnliche Anfragen sind die, die normalerweise an den Endpunkt gesendet werden, den du konfigurierst. Die Dokumentation des Editors ist für deine Version maßgeblich, also prüfe sie, bevor du dich auf eine bestimmte Funktion verlässt.

Noch zwei Dinge, die es wert sind, geprüft zu werden:

Anfragepfad. Je nach Version können Anfragen über Server laufen, die vom Editor-Anbieter betrieben werden, bevor sie deinen Endpunkt erreichen. Wenn dem so ist, wird eine Base URL auf deinem eigenen Laptop nicht funktionieren, während eine öffentliche URL wie diese hier schon. Lies die Datenschutzhinweise des Editors, um zu sehen, was er speichert.
Modellumfang. Dieser Dienst betreibt ein Open-Weight-Modell, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die rechtmäßige Erwachsenennutzung zu antworten. Es ist nur Text. Es generiert keine Bilder, Audio oder Embeddings, daher funktionieren Funktionen, die diese benötigen, nicht durch es.

Das Kontextfenster hat 100.000 Token für Prompt plus Output, was für die meisten Einzeldatei-Arbeiten und viele Mehrdatei-Aufgaben mehr als ausreichend ist. Sehr große Repository-Exporte passen nicht.

Häufige Fehler beheben

Symptom	Wahrscheinliche Ursache	Lösung
401 Unauthorized	Falscher oder widerrufener Schlüssel, zusätzlicher Leerraum, Schlüssel in das falsche Feld eingefügt	Generiere den Schlüssel auf der Schlüssel-Seite neu und füge ihn erneut ein. Der alte Schlüssel funktioniert sofort nicht mehr.
404 Nicht gefunden	Base URL fehlt `/v1`, oder `/v1/v1` verdoppelt	Verwende exakt `https://api.cursoraiapikey.com/v1`.
Modell nicht gefunden	Benutzerdefinierter Modellname anders geschrieben	Der Name ist `uncensored`, kleingeschrieben.
429 mit `concurrency`	Zu viele Anfragen gleichzeitig; Testschlüssel erlauben 2	Warte, bis die laufenden Anfragen abgeschlossen sind, oder wechsle zu einem vollständigen Schlüssel, der 8 erlaubt.
429 mit `rate_limited`	Über dem pro Minute geltenden Limit; 60 im Test, 300 mit einem Voll-Schlüssel	Verlangsame; Agent-Schleifen können Burst-Aktivität erzeugen.
429 mit `Retry-After: 5`	Vorübergehende Überlastung	Warte fünf Sekunden und versuche es erneut.

Agent-Modi können mehrere Anfragen gleichzeitig auslösen, und eine gestreamte Antwort belegt ihren Slot, bis das Streaming endet. Bei einem Testschlüssel wird das Concurrency-Limit daher schnell erreicht. Das ist normal und kein Fehler des Schlüssels.

Was eine Anfrage kostet

Die Abrechnung erfolgt Pay as you go zu $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token vom Prepaid-Guthaben. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet. Ein typischer Chat-Turn in einem Editor sendet die geöffnete Datei und einen Verlauf, sagen wir 20.000 Input-Token, und erhält 1.500 Output-Token zurück:

Eingabe: 20.000 x $0,15 / 1.000.000 = $0,0030
Output: 1.500 x $0,50 / 1.000.000 = $0,00075
Gesamt: $0,00375, ein wenig unter einem halben Cent

Das $0,50 Testguthaben deckt daher etwa 133 solcher Durchgänge ab. Das reicht für einen Nachmittag echtes Testen. Wenn du dich entscheidest, fortzufahren, laufen Aufladungen von $20 bis $500 in ganzen Beträgen, mit einem Bonus von 5 % ab $50, 10 % ab $100 und 15 % ab $200, bezahlt in Krypto (USDT auf TRC20 oder USDC auf Base). Guthaben verfällt nie. Die Preisseite hat die vollständige Tabelle und die Dokumentation listet jeden unterstützten Parameter auf.

Cursor AI API-Schlüssel: Wo du einen benutzerdefinierten Schlüssel einfügst

Zusammenfassung