Cursor

Mit „Override OpenAI Base URL“ von Cursor GPT-Modelle aus dem OneProvider-Katalog in Ask und Agent betreiben.

Cursor, KI-Code-Editor

Was funktioniert

Ask- und Agent-Anfragen für die von Ihnen hinzugefügten GPT-Modell-IDs laufen über OneProvider, auch gestreamte ApplyPatch-Anfragen. Cursor sendet diese Anfragen von seinen eigenen Servern, daher funktioniert nur der öffentliche Endpoint; die Agent-Laufzeit und spezialisierte gehostete Funktionen steuert weiterhin Cursor.

Einschränkung des Clients

Erfordert einen kostenpflichtigen Cursor-Tarif (Pro oder höher): Seit Januar 2026 ignoriert Cursor im Free-Tarif Ihre eigenen Schlüssel. Der Override gilt global – solange er an ist, geht jedes Modell außer denen von Anthropic und Google an OneProvider, auch Cursors eigene GPT-, Composer- und Grok-Modelle; schalten Sie ihn aus, um Cursors Modelle wieder zu nutzen. Eingebaute Anthropic-/Claude- und Google-IDs nutzen den Override nie, und Tab-Vervollständigung und von Cursor gehostete Funktionen behalten ihr übliches Routing.

Einrichtung

1. Cursor aktualisieren und eigenen Schlüssel vorbereiten

   Nutzen Sie die neueste stabile Version von Cursor in einem Pro-Tarif oder höher. Erstellen Sie einen eigenen OneProvider-Schlüssel, begrenzen Sie dessen Modelle und Ausgaben und laden Sie das Guthaben vor der Prüfung auf.

2. OpenAI API Key einschalten

   Öffnen Sie Cursor Settings → Models → API Keys, fügen Sie den eigenen OneProvider-Schlüssel in OpenAI API Key ein und schalten Sie den zugehörigen Schalter ein – das bloße Einfügen des Schlüssels aktiviert ihn nicht.

   OpenAI API Key: sk-your-key-here

3. OpenAI base URL überschreiben

   Schalten Sie Override OpenAI Base URL (OpenAI-Base-URL überschreiben) ein und tragen Sie exakt https://api.oneprovider.dev/v1 ein – mit /v1 und ohne /chat/completions; Cursor hängt den Pfad selbst an. Cursor verlangt eine kompatible OpenAI-Modell-ID; wählen Sie die ID eines GPT-Textmodells aus dem Modellkatalog (ein Bildmodell funktioniert im Chat nicht).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. Speichern und ein kompatibles Modell wählen

   Speichern Sie den OpenAI-Schlüssel und die base URL. Fügen Sie die gewählte kompatible Modell-ID als Custom Model hinzu, falls sie nicht aufgelistet ist, und senden Sie dann eine neue Ask- oder Agent-Anfrage. Claude- und Google-Modell-IDs laufen nicht über diesen Override. Deaktivieren Sie den Override, wenn Sie wieder das normale OpenAI-Routing von Cursor wollen.

Verbindung prüfen

Anfrage im Dashboard bestätigen

Die Anfrage sollte gpt-6.1-terra, den OpenAI-kompatiblen Endpoint, den Token-Verbrauch und den abgebuchten Betrag zeigen. Zeigt Cursor stattdessen einen Fehler:

"does not work with your current plan or api key" → Free-Tarif oder der Schalter OpenAI API Key ist aus
"Model name is not valid" → Schalter OpenAI API Key einschalten, neuen Chat starten
404 / "Invalid URL" → die base URL muss exakt https://api.oneprovider.dev/v1 lauten
401 → falscher, widerrufener oder nicht aufgeladener OneProvider-Schlüssel
"model … is not available" → die Modell-ID steht nicht im OneProvider-Katalog
Cursors eigene Modelle schlagen fehl → Override OpenAI Base URL ausschalten, solange Sie sie nutzen

Verbindungsdaten

Protokoll

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Schlüsselsicherheit

Cursor baut Anfragen über seinen eigenen Dienst zusammen, beschränken Sie den Schlüssel daher nicht auf die IP Ihres Arbeitsrechners. Besser ist ein eigener Schlüssel mit Beschränkungen für Modell, Rate, Ausgaben, Ablaufdatum und Umfang.

Welches Modell wählen

Der Override transportiert nur Modell-IDs im OpenAI-Stil, wählen Sie also ein GPT-Textmodell. gpt-6.1-terra ist der ausgewogene Standard für Ask und Agent. gpt-6.1-sol ist die Frontier-Stufe für schwierige Aufgaben über mehrere Dateien, gpt-5.6-luna die günstige Stufe für schnelle Fragen. Fügen Sie die gewählte ID als Custom Model hinzu, genau wie im Katalog geschrieben. Claude-IDs laufen nie über diesen Override: Um Claude zu nutzen, betreiben Sie Claude Code neben Cursor.

Häufige Fehler und Lösungen

„Model name is not valid“

Der Schalter OpenAI API Key ist aus oder das Modell wurde vor dem Einschalten hinzugefügt. Schalten Sie ihn ein, speichern Sie und starten Sie einen neuen Chat.

„Does not work with your current plan or api key“

Sie nutzen den Free-Tarif, oder der Schalter ist aus. Cursor ignoriert im Free-Tarif Ihre eigenen Schlüssel; erforderlich ist Pro oder höher.

404 oder „Invalid URL“

Tragen Sie https://api.oneprovider.dev/v1 exakt ein: mit /v1, ohne /chat/completions. Cursor hängt den Pfad selbst an.

401

Der Schlüssel ist falsch oder widerrufen, oder das Guthaben ist leer. Fügen Sie den ganzen Schlüssel ohne Leerzeichen ein und laden Sie das Konto auf.

Cursors eigene Modelle schlagen fehl, solange der Override aktiv ist

Der Override gilt global: Jedes Modell, das nicht von Anthropic oder Google stammt, geht an OneProvider. Schalten Sie Override OpenAI Base URL aus, um wieder die Modelle von Cursor zu nutzen.

Anfragen erscheinen nicht in meinem Dashboard

Das verwendete Modell ist ein Claude- oder Google-Modell, oder der Override ist aus. Wählen Sie die hinzugefügte GPT-ID und senden Sie eine neue Ask- oder Agent-Anfrage.

FAQ

Ist die Tab-Vervollständigung betroffen?

Nein. Tab und von Cursor gehostete Funktionen behalten ihr übliches Routing.

Kann ich den Schlüssel auf meine IP beschränken?

Nein. Cursor sendet Anfragen von seinen eigenen Servern, eine IP-Allowlist würde sie daher blockieren. Nutzen Sie stattdessen Modell-, Rate- und Ausgabenlimits.

Kann ich Claude-Modelle in Cursor über OneProvider nutzen?

Nicht über diesen Override. Für Claude nutzen Sie Claude Code oder Cline .

Wie wechsle ich zurück?

Schalten Sie Override OpenAI Base URL aus. Ihre anderen Einstellungen bleiben erhalten.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .