PL ▾
Pobierz klucz API

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

Izometryczny edytor kodu połączony świecącym kablem z serwerem, ilustrujący niestandardowy endpoint API

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.

  1. Znajdź pole dla klucza API OpenAI i wklej swój klucz z tej strony.
  2. Włącz opcję nadpisania base URL OpenAI i wpisz https://api.cursorapikey.com/v1. Zostaw /v1 na końcu i nie dodawaj /chat/completions; klient dodaje ścieżkę sam.
  3. Dodaj niestandardowy model i wpisz dokładnie uncensored, małymi literami.
  4. 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ść temperature przy 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

ObjawPrawdopodobna przyczynaNaprawa
401 lub "nieprawidłowy klucz"Klucz wklejony ze spacją lub stary kluczSkopiuj ponownie ze strony klucza; przetestuj za pomocą curl
404 lub "model nie znaleziony"Nazwa modelu wpisana inaczejUżyj uncensored, małymi literami, bez przyrostka
404 na ścieżceBase URL zawiera /chat/completionsZakończ base URL na /v1
429 z concurrencyZbyt wiele zapytań narazPoczekaj, aż strumienie się zakończą; pełny klucz pozwala na 8, klucz próbny na 2
429 z rate_limitedPowyżej 300 zapytań na minutę (60 w wersji próbnej)Zwolnij lub spróbuj ponownie po przerwie
429 z Retry-After: 5Tymczasowe przeciążeniePonó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.

01

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.