So verwenden Sie den GitHub Copilot API-Schlüssel mit der Cursor API

Verständnis der API-Schlüssel-Kompatibilität

Wenn Entwickler von einem GitHub Copilot API-Schlüssel sprechen, meinen sie in der Regel ein Token, das im Microsoft GitHub-Ökosystem generiert wurde. Dieser Schlüssel authentifiziert Anfragen an Microsofts Server, die Modelle wie GPT-4o oder spezialisierte, für Code optimierte Varianten ausführen. Während diese Modelle leistungsstark sind, unterliegen sie spezifischen Inhaltsfiltern und Ratenlimits, die mit deinem Microsoft-Konto verknüpft sind.

Im Gegensatz dazu arbeitet die Cursor API als unabhängiger Dienst. Sie nutzt nicht die Infrastruktur von Microsoft. Stattdessen stellt sie ein einzelnes Open-Weight-Modell für große Sprachmodelle bereit, das für Coding-Kontexte optimiert ist. Dieses Modell wurde entwickelt, um ohne Inhaltsablehnungen für die legale erwachsene Nutzung zu antworten, was es zu einer eigenständigen Alternative für Entwickler macht, die Standardfilter als einschränkend empfinden.

Diesen Unterschied zu verstehen, ist entscheidend. Dein bestehender GitHub Copilot API-Schlüssel funktioniert nicht mit dem Cursor API-Endpunkt. Du benötigst einen separaten Schlüssel, den du in deinem cursorapikey.com-Konto generierst. Das zugrunde liegende Protokoll bleibt jedoch gleich, sodass sich an deinem Code nicht viel ändern muss.

Konfiguration deiner Umgebung

Um die Cursor API zu nutzen, musst du zunächst einen Schlüssel generieren. Registriere dich auf der Seite API-Schlüssel erhalten mit nur E-Mail und Passwort. Für das initiale Testguthaben wird keine Kreditkarte benötigt. Nach der Registrierung wird dein Schlüssel sofort angezeigt. Speichere diesen Schlüssel sicher in deinen Umgebungsvariablen, typischerweise als OPENAI_API_KEY oder eine benutzerdefinierte Variable, je nach Anforderungen deines Agenten.

Die meisten Coding-Agenten, einschließlich Cursor und ähnlicher Tools, stützen sich auf den OpenAI-SDK-Standard. Das bedeutet, du benötigst keine benutzerdefinierte Bibliothek. Du musst dein SDK lediglich auf die korrekte Base URL verweisen. Die Base URL für die Cursor API lautet https://api.cursorapikey.com/v1. Dieser Endpunkt ist vollständig OpenAI-kompatibel und unterstützt dieselben Anfragestrukturen, die du bereits kennst.

Stelle sicher, dass deine Umgebung so konfiguriert ist, dass Anfragen an diese neue Base URL gesendet werden. Die Modell-ID, die du in deinen Anfragen angeben musst, ist uncensored. Dies teilt der API mit, welches spezifische Modell aufgerufen werden soll. Es handelt sich um ein Open-Weight-Modell, das auf unseren eigenen GPU-Servern läuft, distinct von GPT, Claude oder Gemini.

Ändern der Base URLs

Der Wechsel von einem GitHub Copilot API-Schlüssel zur Cursor API umfasst hauptsächlich das Ändern der Base URL in deiner Client-Konfiguration. Wenn du die offiziellen OpenAI Python- oder Node.js-SDKs verwendest, ist dies eine Ein-Zeilen-Änderung. In Python würdest du den Client beispielsweise mit der neuen Base URL und deinem neuen API-Schlüssel initialisieren.

Diese Änderung leitet deine Anfragen von Microsofts Servern zu unserer Infrastruktur um. Die Vorteile umfassen den Zugriff auf ein 100.000-Token-Kontextfenster und ein Modell, das auf weniger Verweigerungen abgestimmt ist. Du kannst die Verbindung überprüfen, indem du den /v1/models-Endpunkt prüfst, der die verfügbaren Modelle zurückgeben sollte, einschließlich uncensored.

Abwägung: Obwohl die Syntax identisch ist, zahlst du nun pro Token statt über ein Microsoft-Abonnement. Unsere Preise sind transparent: $0,25 pro 1 Mio. Input-Token und $1,00 pro 1 Mio. Output-Token. Es gibt keine monatlichen Gebühren, nur Prepaid-Guthaben, das verfällt nie. Dieses Modell ist ideal für variable Arbeitslasten, bei denen du keine monatlichen Sitzungskosten fest einkalkulieren möchtest.

Testen deiner Verbindung

Bevor du die API in deinen Hauptarbeitsablauf integrierst, ist es wichtig zu überprüfen, ob deine Umgebung mit der Cursor API kommunizieren kann. Dies kannst du mit einem einfachen cURL-Befehl oder einem kurzen Skript tun. Dieser Test stellt sicher, dass dein Schlüssel gültig ist und die Base URL korrekt ist.

Beispiel cURL-Anfrage:

Sende eine POST-Anfrage an https://api.cursorapikey.com/v1/chat/completions mit dem Modell auf uncensored. Füge einen einfachen Prompt im messages-Array ein. Eine erfolgreiche Antwort gibt eine Completion im Feld choices[0].message.content zurück.

Wenn du einen 401-Fehler erhältst, ist dein API-Schlüssel falsch. Wenn du einen 429-Fehler erhältst, hast du das Ratenlimit von 300 Anfragen pro Minute pro Schlüssel überschritten. Du kannst deinen Schlüssel jederzeit neu generieren, um den alten ungültig zu machen. Dieser Test bestätigt, dass die grundlegende Text-in, Text-out-Funktionalität wie erwartet funktioniert.

Verarbeitung von Streaming-Antworten

Für Coding-Agenten sind Streaming-Antworten entscheidend, um eine reibungslose Benutzererfahrung zu gewährleisten. Die Cursor API unterstützt Server-Sent Events (SSE) für Streaming. Dies ermöglicht es dir, Token zu empfangen, sobald sie generiert werden, anstatt auf die vollständige Antwort zu warten.

Wenn du die OpenAI SDK nutzt, aktivierst du das Streaming, indem du den Parameter stream auf true setzt. Die SDK sendet Datenchunks bei Ankunft. Das ist ideal für lange Codegenerierungen, um Fortschritt anzuzeigen oder Token in einen Live-Editor zu speisen.

Beachte, dass Streaming das zugrunde liegende Modell oder seine Fähigkeiten nicht verändert. Es ist rein ein Übertragungsmechanismus. Das uncensored-Modell hält sich weiterhin an das 100.000-Token-Kontextfenster und dieselbe Preisstruktur. Streaming ist eine Client-seitige Funktion, die die wahrgenommene Latenz verbessert, ohne das Verhalten des Modells zu beeinflussen.

Integration von Tool Calling

Moderne KI-Coding-Assistenten verlassen sich stark auf Tool Calling (Function Calling), um mit der Außenwelt zu interagieren, z. B. Shell-Befehle auszuführen oder auf Dateien zuzugreifen. Die Cursor API unterstützt dies über das Standard-OpenAI-kompatible Format.

Du kannst Tools in deiner Anfrage über den tools-Parameter definieren. Das Modell antwortet mit einem tool_calls-Array, wenn es feststellt, dass ein Tool verwendet werden sollte. Deine Anwendung muss das Tool dann ausführen und die Ergebnisse in einer nachfolgenden Nachricht an die API senden.

Dieser Prozess ist identisch mit der Verwendung eines GitHub Copilot API-Schlüssels mit Microsofts Modellen. Der Vorteil hier ist Konsistenz. Wenn du vorhandenen Code für Tool Calling hast, kannst du ihn wahrscheinlich mit minimalen Anpassungen wiederverwenden. Stelle sicher, dass deine Tool-Definitionen mit dem erwarteten Schema für das uncensored-Modell übereinstimmen.

Überwachung der Nutzung

Da du pro Token zahlst, ist die Überwachung deiner Nutzung wichtig, um unerwartete Kosten zu vermeiden. Die Cursor API bietet ein Dashboard, in dem du deinen Guthabenstand und deine Nutzungshistorie einsehen kannst. Du siehst, wie viele Token du verbraucht hast und wie viel Guthaben noch übrig ist.

Wichtige Limits, auf die du achten solltest:

• Ratenlimit: 300 Anfragen pro Minute pro Schlüssel.
• Anfragekörpergröße: Maximal 8 MB pro Anfrage.
• Kontextfenster: 100.000 Token insgesamt (Input + Output).

Wenn du das Ratenlimit überschreitest, erhältst du einen 429-Fehler. Du kannst deine Nutzung in Echtzeit überwachen, um sicherzustellen, dass du innerhalb dieser Grenzen bleibst. Zusätzlich kannst du deinen API-Schlüssel neu generieren, wenn du vermutest, dass er kompromittiert wurde, wodurch der alte Schlüssel sofort ungültig wird.

Fehlerbehebung bei häufigen Problemen

Auch bei einer robusten API können Probleme auftreten. Hier sind einige häufige Probleme und deren Lösungen.

401 Unauthorized: Überprüfe deinen API-Schlüssel. Stelle sicher, dass er korrekt kopiert wurde und keine führenden oder nachgestellten Leerzeichen enthält. Wenn du deinen Schlüssel neu generiert hast, stelle sicher, dass du den neuen verwendest.

429 Too Many Requests: Du hast das Limit von 300 Anfragen pro Minute überschritten. Implementiere Exponential Backoff in deinem Client oder reduziere die Häufigkeit deiner Anfragen.

400 Bad Request: Dies deutet normalerweise auf ein fehlerhaftes JSON-Payload oder fehlende erforderliche Felder hin. Stelle sicher, dass dein messages-Array korrekt formatiert ist und die Felder role und content enthält. Überprüfe außerdem, ob der Modellname exakt uncensored lautet.

Inhaltsblockierung: Obwohl das Modell unzensiert ist, blockiert es sexuelle Inhalte, die Minderjährige betreffen. Wenn deine Anfrage blockiert wird, kann dies an dieser spezifischen harten Grenze liegen.