cursorapikey.com/Przewodnik
Jak używać kluczy API Cursor z własnym endpointem
Oto jak używać ustawień API Cursor z własnym endpointem: wklej klucz, nadpisz base URL OpenAI i dodaj nazwę modelu uncensored. Poniższe kroki zajmują około pięciu minut i obejmują test curl, który możesz uruchomić najpierw.
Zaktualizowano

Kluczowe punkty
- Cursor pozwala nadpisać base URL i klucz OpenAI, więc dowolny endpoint zgodny z OpenAI może obsługiwać zapytania.
- Użyj base URL https://api.cursorapikey.com/v1 i identyfikatora modelu
uncensored. - Przetestuj klucz za pomocą curl przed dotknięciem edytora, więc wiesz, po której stronie pochodzi błąd.
- Prompt o długości 20 000 tokenów z odpowiedzią 1 000 tokenów kosztuje $0,0035.
Co obejmuje ten przewodnik
Ludzie szukający informacji o tym, jak używać API Cursor, zwykle mają na myśli jedną z dwóch rzeczy. Albo chcą wywołać usługę Cursor z kodu, albo chcą, aby edytor Cursor wysyłał zapytania do modelu na wybrany przez siebie endpoint. Ten przewodnik dotyczy drugiego przypadku. Ta strona to niezależne hostowane API, które mówi w protokole uzupełnień czatu OpenAI, więc Cursor może z nim rozmawiać tak samo, jak rozmawia z dowolnym serwerem w stylu OpenAI.
Za tym stoi pojedynczy model o otwartych wagach, obsługiwany przez niezależnego dostawcę i dostrojony do dostarczania odpowiedzi bez odrzuceń treści do zgodnego z prawem użytku przez dorosłych. Nie jest to oficjalny model Cursora i nie jest to router między dostawcami. Obsługuje tylko tekst. Do programowania zwykle wystarczy: wysyłasz kod i instrukcje, otrzymujesz kod i wyjaśnienia.
Potrzebujesz trzech rzeczy: klucza API, base URL https://api.cursorapikey.com/v1 i identyfikatora modelu uncensored. Wszystko inne to kwestia znalezienia odpowiednich pól w edytorze.
Krok 1: uzyskaj klucz i sprawdź go za pomocą curl
Zarejestruj się przez Google lub e-mail z hasłem, a następnie otwórz stronę klucza API. Nowe konta mogą odebrać $0,50 kredytu próbnego jednym kliknięciem. Nie wymaga karty i jest ważny przez 7 dni. Klucz próbny jest ograniczony do 2 równoległych zapytań i 60 zapytań na minutę, co wystarcza na pierwszą sesję w edytorze.
Zanim otworzysz Cursor, potwierdź, że klucz działa. Uruchom to w terminalu, z kluczem w zmiennej środowiskowej:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
Pierwsze wywołanie wyświetla model. Drugie zwraca normalne uzupełnienie czatu. Jeśli oba się powiodą, każdy późniejszy błąd w edytorze to problem ustawień, a nie klucza. Ten podział oszczędza dużo zgadywania.
Krok 2: ustaw base URL i klucz w Cursor
Otwórz ustawienia Cursora i przejdź do sekcji modeli. Nazwy menu i układ zmieniają się między wydaniami, więc traktuj poniższe etykiety jako mapę i sprawdź dokumentację Cursora, jeśli coś się przemieściło.
- Znajdź pole dla klucza API OpenAI i wklej swój klucz z tej strony.
- Włącz opcję nadpisania base URL OpenAI i wpisz
https://api.cursorapikey.com/v1. Zostaw/v1na końcu i nie dodawaj/chat/completions; klient dodaje ścieżkę sam. - Dodaj niestandardowy model i wpisz dokładnie
uncensored, małymi literami. - Użyj przycisku weryfikacji lub zapisu, jeśli edytor go oferuje, a następnie wybierz nowy model w panelu czatu.
Wyślij krótką wiadomość, np. „wyjaśnij tę funkcję”, przy otwartym pliku. Strumieniowana odpowiedź oznacza, że połączenie działa w całości. Cursor wysyła zapytanie, endpoint strumieniuje tokeny z powrotem przez SSE, a edytor renderuje je w miarę ich napływu.
Dwa zastrzeżenia. Niektóre funkcje edytora, takie jak uzupełnianie inline klawiszem Tab, mogą korzystać z modeli kontrolowanych przez Cursora i mogą ignorować Twój klucz, dlatego sprawdź, które funkcje faktycznie używają niestandardowego modelu. Ponieważ Cursor może kierować ruchem z niestandardowym kluczem przez swoje serwery, przeczytaj jego aktualną dokumentację, jeśli chcesz wiedzieć dokładnie, dokąd trafia Twój kod. Szybki start na tej stronie opisuje stronę API.
Przetestuj ten sam endpoint z kodu
Najłatwiejszym sposobem na izolację problemu jest wywołanie endpointu za pomocą oficjalnego SDK OpenAI. Jeśli to zadziała, endpoint jest w porządku, a pozostały problem leży w konfiguracji edytora.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
To samo w Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
Strumieniowane odpowiedzi zawierają zużycie na końcu, więc możesz dokładnie zalogować, ile tokenów zużyło zapytanie. Każda odpowiedź zawiera również nagłówek X-Balance-USD z Twoim pozostałym kredytem oraz X-Request-Id, który możesz podać, jeśli coś wygląda źle.
Co działa w przepływie pracy kodowania
API obsługuje strumieniowanie, tryb JSON i wywoływanie funkcji (tools, tool_choice, strumieniowane tool_calls oraz wyniki zwracane jako role: "tool"). Ustawienia próbkowania, takie jak temperature, top_p, stop, seed oraz kary, są przekazywane dalej. Okno kontekstu wynosi 100 000 tokenów, dzielonych między prompt a completion, a max_tokens jest opcjonalne.
Te 100 000 tokenów to hojny budżet na kod. Plik źródłowy liczący kilka setek linii to kilka tysięcy tokenów, więc możesz dołączyć kilka plików plus długą instrukcję i nadal zostawić miejsce na odpowiedź. Maksymalny rozmiar treści zapytania to 8 MB, czego nie osiągniesz przy tekście.
Niektóre nawyki, które sprawiają, że niestandardowy model jest przyjemny w edytorze:
- Ustaw niską wartość
temperatureprzy edycji kodu. Wartości około 0,2 dają stabilniejszy wynik; podnoś ją tylko podczas burzy mózgów. - Dołączaj tylko pliki, które mają znaczenie. Każdy wysłany token jest rozliczany jako wejście, a cała rozmowa jest wysyłana ponownie w każdej turze.
- Pytaj o diffy lub zmienioną funkcję, a nie cały plik, gdy plik jest długi. Tokeny wyjścia kosztują więcej niż tokeny wejścia.
- Użyj modelu do zadań, w których odrzucenia treści przeszkadzają, np. pisania exploit proof-of-concept dla własnego laboratorium, analizy próbek złośliwego oprogramowania, które masz uprawnienia badać, lub generowania danych testowych imitujących nieprzyjemną zawartość z rzeczywistego świata. Wszystko musi być zgodne z prawem.
Jedna twarda granica warta powtórzenia: żadna zawartość seksualna z udziałem nieletnich, w żadnej formie.
Naprawianie typowych błędów
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 401 lub "nieprawidłowy klucz" | Klucz wklejony ze spacją lub stary klucz | Skopiuj ponownie ze strony klucza; przetestuj za pomocą curl |
| 404 lub "model nie znaleziony" | Nazwa modelu wpisana inaczej | Użyj uncensored, małymi literami, bez przyrostka |
| 404 na ścieżce | Base URL zawiera /chat/completions | Zakończ base URL na /v1 |
429 z concurrency | Zbyt wiele zapytań naraz | Poczekaj, aż strumienie się zakończą; pełny klucz pozwala na 8, klucz próbny na 2 |
429 z rate_limited | Powyżej 300 zapytań na minutę (60 w wersji próbnej) | Zwolnij lub spróbuj ponownie po przerwie |
429 z Retry-After: 5 | Tymczasowe przeciążenie | Ponów próbę po pięciu sekundach |
Zapytanie strumieniowe trzyma slot równoległości do końca strumienia. Jeśli uruchomisz kilka rozmów w Cursorze i zostawisz je generować, szybko wyczerpiesz limit równoległości na kluczu próbnym. Nieudane lub odrzucone zapytania nie są rozliczane, więc ponowna próba nie kosztuje ekstra.
Ile kosztuje sesja kodowania
Ceny to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, płatne z przedpłaconego kredytu bez subskrypcji. Typowe zapytanie edytora ma duży prompt (Twoje pliki) i krótką odpowiedź. Weźmy 20 000 tokenów wejściowych i 1 000 tokenów wyjściowych:
- Wejście: 20 000 x $0,15 / 1 000 000 = $0,0030
- Wyjście: 1000 x $0,50 / 1 000 000 = $0,0005
- Razem: $0,0035 na zapytanie
Przy 100 zapytaniach w ciągu dnia roboczego koszt to $0,35. Kredyt próbny $0,50 pokrywa około 140 takich zapytań. Po zakończeniu okresu próbnego możesz doładować dowolną kwotę całkowitą od $20 do $500, z bonusem +5% przy kwocie od $50, +10% od $100 i +15% od $200. Płać kryptowalutami (USDT na TRC20, USDC na Base). Kredyt nie wygasa, więc doładowanie, którego używasz powoli, nie marnuje się. Na stronie z cenami znajdziesz pełną tabelę, a strona o alternatywie dla Cursora i Copilota wyjaśnia, gdzie to rozwiązanie pasuje do edytorów subskrypcyjnych.
Prompty nie są używane do trenowania.
Więcej przewodników
Pytania i odpowiedzi
Czy to działa z agentem Cursor i wywoływaniem narzędzi?
API obsługuje wywoływanie funkcji z użyciem narzędzi, tool_choice i strumieniowania tool_calls. To, czy dana funkcja Cursora używa Twojego niestandardowego modelu, zależy od edytora, więc przetestuj każdą funkcję po konfiguracji.
Jaką nazwę modelu wpisać?
Wpisz uncensored, małymi literami. To jedyny identyfikator modelu, a GET /v1/models go wyświetla.
Czy to oficjalne API Cursor?
Nie. To niezależne API kompatybilne z OpenAI, stojące przed jednym modelem o otwartych wagach. Cursor po prostu pozwala skierować jego ustawienia OpenAI na inny endpoint.
Czy potrzebuję karty, żeby spróbować?
Nie. Kredyt próbny za $0,50 odbiera się jednym kliknięciem na stronie klucza API po zalogowaniu, nie wymaga karty i jest ważny przez 7 dni.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień base URL. To cała konfiguracja.