Cursor

Użyj Override OpenAI Base URL w Cursor, żeby uruchamiać modele GPT z katalogu OneProvider w Ask i Agent.

Edytor kodu AI Cursor

Co działa

Zapytania Ask i Agent dla dodanych ID modeli GPT przechodzą przez OneProvider, w tym strumieniowane zapytania ApplyPatch. Cursor wysyła je ze swoich serwerów, więc działa tylko publiczny endpoint; Cursor nadal kontroluje własne środowisko agenta i wyspecjalizowane funkcje hostowane.

Ograniczenie klienta

Wymaga płatnego planu Cursor (Pro lub wyższy): od stycznia 2026 Cursor ignoruje twoje własne klucze na planie Free. Override jest globalny — gdy jest włączony, każdy model poza Anthropic i Google, także własne modele GPT, Composer i Grok z Cursor, trafia do OneProvider, więc wyłącz go, żeby znów używać modeli Cursor. Wbudowane ID Anthropic/Claude i Google nigdy nie używają override, a uzupełnianie Tab i funkcje hostowane przez Cursor zachowują normalne kierowanie.

Konfiguracja

1. Zaktualizuj Cursor i przygotuj dedykowany klucz

   Użyj najnowszej stabilnej wersji Cursor na planie Pro lub wyższym. Utwórz dedykowany klucz OneProvider, ogranicz jego modele i wydatki oraz doładuj saldo przed weryfikacją.

2. Włącz OpenAI API Key

   Otwórz Cursor Settings → Models → API Keys, wklej dedykowany klucz OneProvider w polu OpenAI API Key i włącz jego przełącznik — samo wklejenie klucza go nie aktywuje.

   OpenAI API Key: sk-your-key-here

3. Zmień base URL OpenAI

   Włącz Override OpenAI Base URL i wpisz dokładnie https://api.oneprovider.dev/v1 — z /v1 i bez /chat/completions; Cursor sam dopisuje ścieżkę. Cursor wymaga zgodnego ID modelu OpenAI; wybierz ID tekstowego modelu GPT z katalogu modeli (model obrazów nie zadziała w czacie).

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

4. Zapisz i wybierz zgodny model

   Zapisz klucz OpenAI i base URL. Jeśli wybranego zgodnego ID modelu nie ma na liście, dodaj je jako model niestandardowy, a potem wyślij nowe zapytanie w Ask lub Agent. ID modeli Claude i Google nie przechodzą przez ten override. Wyłącz override, gdy chcesz wrócić do normalnego kierowania OpenAI w Cursor.

Sprawdź połączenie

Potwierdź zapytanie w Panelu

Zapytanie powinno pokazywać gpt-6.1-terra, endpoint zgodny z OpenAI, zużycie tokenów i rozliczoną opłatę. Jeśli Cursor pokaże błąd:

"does not work with your current plan or api key" → plan Free albo wyłączony przełącznik OpenAI API Key
"Model name is not valid" → włącz przełącznik OpenAI API Key, rozpocznij nowy czat
404 / "Invalid URL" → base URL musi być dokładnie https://api.oneprovider.dev/v1
401 → błędny, odwołany lub niedoładowany klucz OneProvider
"model … is not available" → ID modelu nie ma w katalogu OneProvider
Własne modele Cursor nie działają → wyłącz Override OpenAI Base URL na czas ich używania

Dane połączenia

Protokół

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Bezpieczeństwo klucza

Cursor składa zapytania przez własną usługę, więc nie ograniczaj klucza do IP swojego komputera. Lepszy jest dedykowany klucz z ograniczeniami modeli, liczby zapytań, wydatków, ważności i zakresu.

Jaki model wybrać

Override przenosi tylko ID modeli w stylu OpenAI, więc wybierz tekstowy model GPT. gpt-6.1-terra to zrównoważony wybór domyślny dla Ask i Agent. gpt-6.1-sol to poziom frontier do trudnych zadań obejmujących wiele plików, a gpt-5.6-luna to tani poziom do szybkich pytań. Dodaj wybrane ID jako model niestandardowy, dokładnie tak, jak jest zapisane w katalogu . ID Claude nigdy nie przechodzą przez ten override: żeby używać Claude, uruchom Claude Code obok Cursor.

Częste błędy i rozwiązania

„Model name is not valid”

Przełącznik OpenAI API Key jest wyłączony albo model dodano, zanim go włączono. Włącz przełącznik, zapisz i rozpocznij nowy czat.

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

Masz plan Free albo przełącznik jest wyłączony. Na planie Free Cursor ignoruje twoje własne klucze; wymagany jest Pro lub wyższy.

404 lub „Invalid URL”

Wpisz dokładnie https://api.oneprovider.dev/v1: z /v1, bez /chat/completions. Ścieżkę dopisuje Cursor.

401

Klucz jest błędny, odwołany albo saldo jest puste. Wklej cały klucz bez spacji i doładuj saldo w Panelu.

Własne modele Cursor nie działają, gdy override jest włączony

Override jest globalny: każdy model inny niż Anthropic i Google trafia do OneProvider. Wyłącz Override OpenAI Base URL, żeby znów używać modeli Cursor.

Zapytania nie pojawiają się w moim Panelu

Użyty model to Claude lub Google albo override jest wyłączony. Wybierz dodane ID GPT i wyślij nowe zapytanie w Ask lub Agent.

FAQ

Czy to wpływa na uzupełnianie Tab?

Nie. Tab i funkcje hostowane przez Cursor zachowują normalne kierowanie.

Czy mogę ograniczyć klucz do mojego IP?

Nie. Cursor wysyła zapytania ze swoich serwerów, więc lista dozwolonych adresów IP by je zablokowała. Użyj zamiast tego limitów modeli, zapytań i wydatków.

Czy mogę używać modeli Claude w Cursor przez OneProvider?

Nie przez ten override. Do Claude użyj Claude Code lub Cline .

Jak wrócić do poprzednich ustawień?

Wyłącz Override OpenAI Base URL. Pozostałe ustawienia zostają.

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .