Cursor mit einem API-Key für alle Modelle
Fügen Sie den RelaySwitch-Key in das Feld OpenAI API Key von Cursor ein, überschreiben Sie die Base URL mit https://api.relayswitch.io/v1, und fügen Sie die Modell-IDs hinzu, die Sie nutzen möchten. Jedes Chat-Modell dieses Keys lässt sich in die Modellauswahl aufnehmen, und sowohl der Agent- als auch der Ask-Modus laufen.
01So funktioniert es, und wo die Einstellungen liegen
Cursor sendet Requests im OpenAI-Format, und jedes Chat-Modell in der Modellliste beantwortet dieses Format. Ein Key deckt also Claude, GPT, Gemini und DeepSeek in derselben Modellauswahl ab, jedes zu seinem aktuellen Preis pro Token, abgerechnet vom Prepaid-Guthaben.
Die Einstellungen liegen in den Cursor Settings (Cmd/Ctrl + ,), Abschnitt Models. Die Felder für Key und Base URL stehen unter der Modellliste.
02Die Schritte in den Cursor Settings
- Aktivieren Sie OpenAI API Key und fügen Sie den vollständigen Key aus der Console ein.
- Aktivieren Sie Override OpenAI Base URL und tragen Sie https://api.relayswitch.io/v1 ein, mit
/v1am Ende. - Klicken Sie auf Save. Ältere Cursor-Versionen nennen diesen Button Verify.
- Fügen Sie unter Models jede gewünschte ID einzeln hinzu, genau so, wie sie in der Modellliste steht; Claude-IDs gehen ebenfalls. Wählen Sie dann eine davon im Chat-Panel aus.
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03Wozu jedes Feld dient
| OpenAI API Key | Die Zugangsdaten, die Cursor mit jedem Request sendet. Fügen Sie den vollständigen Key aus der Console ein. |
| Override OpenAI Base URL | Sendet diese Requests an https://api.relayswitch.io/v1 statt an OpenAI. |
| Models | Die Liste, die die Modellauswahl anbietet. Fügen Sie jede gewünschte ID genau so hinzu, wie sie in der Modellliste steht, nicht den Anzeigenamen. |
04Ein Modell für Cursor wählen
Ein Agent-Request enthält die Unterhaltung, die Dateien, die Cursor gelesen hat, und die Tool-Ergebnisse; die Input-Token machen also den größten Teil der Rechnung aus. Modelle mit niedrigem Input-Preis ergeben die geringsten Kosten pro Request. Die folgende Tabelle zeigt die Spitzenmodelle in USD pro Million Token; jede Modellseite nennt die Preise für Input, Cached Input und Output.
| Modell | Entwickler | Input | Output | Kontext |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425 | $1.164 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873 | $0.1455 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625 | $0.20 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80 | $2.40 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105 | $0.42 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60 | $1.80 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90 | $4.50 | 1,048,576 |
USD pro Million Token
05Agent-Modus und GPT-Modelle
Ist die überschriebene Base URL aktiv, sendet der Agent-Modus von Cursor bei GPT-Modellen einen Request-Body im Format der Responses API an den Pfad von Chat Completions. Cursor führt das in seinem Forum als Known Issue.
Das Gateway liest diesen Body als den Chat-Completions-Request, der gemeint ist, und antwortet im Format von Chat Completions, mit oder ohne Streaming. GPT-IDs laufen im Agent- wie im Ask-Modus zum selben Preis. Wenn Sie lieber einen Agent im Terminal nutzen, siehe die Codex-Seite und die Claude-Code-Seite.
06Die Verbindung prüfen
Schicken Sie einen Request, wie Cursor ihn sendet, vom selben Rechner. Senden Sie danach in Cursor eine Nachricht mit einer Ihrer IDs als gewähltem Modell; der Request erscheint auf der Usage-Seite der Console mit Token und Kosten.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'07Abrechnung, Cache und häufige Fehler
Wie Sie einen Key erstellen und ein Budget pro Key setzen, steht auf der Seite zum Claude API Key. Was Sie zur Abrechnung wissen sollten, und danach die vier häufigsten Fehler:
- Requests werden pro Token zum Preis des Modells abgerechnet, von Ihrem Prepaid-Guthaben.
- Meldet die Antwort Cached-Input-Token, werden diese zum Preis für Cached Input des Modells abgerechnet, nicht zum Input-Preis. Eine lange Unterhaltung, die denselben Anfang wiederholt, ist pro Turn günstiger als eine neue.
- In den Cursor-Tarifen Teams und Enterprise zählt Cursor Requests mit eigenem Key zur Nutzung und berechnet zusätzlich eine eigene Gebühr pro Token. Diese Gebühr rechnet Cursor ab, sie fällt nicht hier an. Laut der Cursor-Dokumentation zu API-Keys werden Einzeltarife nicht gezählt.
401 invalid_api_key | Der Key ist falsch oder wurde widerrufen. Kopieren Sie ihn erneut aus der Console. |
404 model_not_found | Die ID in der Modellauswahl steht nicht in der Modellliste. Prüfen Sie auf Tippfehler oder einen Anzeigenamen an Stelle der ID. |
402 insufficient_balance | Laden Sie in der Console auf; der Key funktioniert sofort wieder. |
| Verify schlägt fehl | Die häufigste Ursache ist eine Base URL ohne /v1. Führen Sie den curl-Befehl aus dem vorigen Abschnitt vom selben Rechner aus. |
Häufige Fragen
- Braucht die Base URL in Cursor das /v1?
- Ja. Tragen Sie in Override OpenAI Base URL https://api.relayswitch.io/v1 ein, Cursor hängt /chat/completions an. Die häufigste Ursache für ein fehlgeschlagenes Verify ist ein fehlendes /v1.
- Lassen sich Claude-Modelle in Cursor AI mit diesem Key nutzen?
- Ja. Jedes Chat-Modell in der Modellliste beantwortet das OpenAI-Format, das Cursor sendet; die IDs von Claude, GPT, Gemini und DeepSeek lassen sich also mit einem Key in dieselbe Modellauswahl aufnehmen.
- Läuft der Agent-Modus mit eigenem API-Key?
- Ja, Agent-Modus und Ask-Modus laufen beide. Bei GPT-Modellen sendet der Agent-Modus einen Request-Body im Responses-Format an den Pfad von Chat Completions; das Gateway liest ihn als Chat-Completions-Request und antwortet in diesem Format, zum selben Preis.
- Muss Streaming aktiviert werden?
- Nein. Cursor nutzt Streaming standardmäßig und hat keinen Schalter dafür. Alle Modelle unterstützen Streaming.
- Berechnet Cursor eine zusätzliche Gebühr für eigene Keys?
- Laut der Cursor-Dokumentation zu API-Keys zählen in den Tarifen Teams und Enterprise Requests mit eigenem Key zur Cursor-Nutzung und kosten eine Gebühr pro Token, die Cursor abrechnet. Einzeltarife werden nicht gezählt. Hier werden Requests pro Token zum Preis des Modells vom Prepaid-Guthaben abgerechnet.
- Wie lade ich Guthaben für die Nutzung in Cursor auf?
- Laden Sie in der Console per Karte, auch über Apple Pay und Google Pay, oder mit USDT, USDC, BTC, ETH, SOL auf, ab $10. Das Guthaben wird in US-Dollar geführt, verfällt nicht, und es gibt kein Abo.
Alle Modelle in der Modellauswahl von Cursor
Ein Key, Prepaid-Guthaben, Zahlung per Karte oder Krypto.