PL ▾
Pobierz klucz API

cursorapikey.com/Przewodnik

Klucze API Cursor nie działają: naprawa niestandardowego endpointu

Gdy klucze API Cursor nie działają, przyczyną jest prawie zawsze jedna z czterech rzeczy: base URL, nazwa modelu, sam klucz lub limit na koncie. Jedno polecenie curl pokaże Ci, która z nich.

Zaktualizowano

Abstrakcyjny panel edytora kodu z świecącym się kluczem włożonym do gniazda, kluczem francuskim i lupą obok
Izometryczny widok z gałęziami prowadzącymi do edytora, serwera i terminala, ilustrujący wybór alternatywy dla Cursor

Kluczowe punkty

  • Przetestuj klucz poza Cursor najpierw za pomocą curl; jeśli curl działa, problem jest w ustawieniach Cursora.
  • Base URL musi wynosić https://api.cursorapikey.com/v1, a nazwa modelu musi być dokładnie uncensored.
  • 401 oznacza zły klucz, 404 zły URL, 429 limit zapytań lub concurrency, a błąd modelu to zła nazwa.
  • Etykiety menu zmieniają się między wersjami Cursora, więc dopasuj przeznaczenie pola, a nie dokładny tekst.

Krok 1: przetestuj klucz poza Cursor

Wyłącz Cursor z równania. Jeśli zwykłe zapytanie działa, Twój klucz i konto są w porządku, a wina leży w ustawieniach edytora. Jeśli nie, w ciele błędu podana jest przyczyna.

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

Flaga -i wypisuje linię statusu i nagłówki. Status 200 z tablicą choices oznacza sukces. Nagłówek X-Balance-USD pokazuje Twój pozostały kredyt, co jest pierwszą rzeczą do sprawdzenia przy błędzie autoryzacji lub płatności.

Możesz też wypisać modele, co potwierdzi klucz bez wydawania niczego:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

W odpowiedzi powinien znaleźć się ID modelu uncensored.

Krok 2: ustaw pola w Cursor

Otwórz ustawienia Cursora i znajdź sekcję Models. Potrzebujesz trzech wartości, a błąd w którejkolwiek z nich spowoduje awarię wyglądającą jak uszkodzony klucz.

  1. Klucz OpenAI API: wklej swój klucz bez spacji ani łamania wierszy na końcach.
  2. Zmień bazowy URL OpenAI: włącz nadpisanie i wpisz https://api.cursorapikey.com/v1. Zachowaj /v1, usuń /chat/completions.
  3. Niestandardowy model: dodaj model o nazwie uncensored i włącz go. Wyłącz modele, z których nie korzystasz, aby Cursor nie wybrał takiego, którego endpoint nie zna.

Po zapisaniu użyj opcji verify, jeśli Twoja wersja ją ma, a następnie wybierz uncensored w rozwijanej liście modelu czatu. Nowa karta czatu to dobry test, ponieważ stara karta może utrzymywać model, z którego została uruchomiona. Przewodnik krok po kroku w jak używać API Cursor pokazuje tę samą konfigurację z większym kontekstem.

Dopasuj błąd do rozwiązania

Co widziszPrawdopodobna przyczynaNaprawa
401, „nieprawidłowy klucz”, „nieautoryzowany”Klucz wpisany błędnie, ucięty lub unieważnionySkopiuj go ponownie ze strony klucza; sprawdź końcowe spacje
404, „nie znaleziono"Zły URL, brak /v1 lub podwojona ścieżkaUżyj dokładnie https://api.cursorapikey.com/v1
„model nie znaleziony” lub podobneNazwa modelu różni się od uncensoredDodaj niestandardowy model o tej dokładnej nazwie, małymi literami
429 z rate_limitedPrzekroczenie limitu zapytań na minutęZwolnij; klucze próbne pozwalają na 60 na minutę, pełne klucze na 300
429 z concurrencyZbyt wiele zapytań narazZmniejsz równoległe uruchomienia agenta; klucz próbny 2, pełny klucz 8
429 z Retry-After: 5Tymczasowe przeciążeniePoczekaj pięć sekund i wyślij ponownie
Działa w curl, nie działa w CursorUstawienie nie zostało zapisane, zły model w karcie lub funkcja, która nie używa niestandardowych kluczyZobacz następny rozdział

Nieudane lub odrzucone żądania nie są rozliczane, więc ponawianie podczas debugowania nie kosztuje nic.

Gdy curl działa, ale Cursor nadal nie działa

To najbardziej mylący przypadek, który ma kilka typowych wyjaśnień.

Wybrany jest zły model. Cursor trzyma swoje wbudowane modele na liście. Jeśli któryś z nich jest wybrany, zapytanie w ogóle nie idzie do Twojego endpointu. Wybierz uncensored wyraźnie w rozwijanej liście czatu lub kompozera, którego używasz.

Nie każda funkcja używa twojego klucza. Funkcje, które polegają na własnych modelach Cursora, takich jak autouzupełnianie w linii, mogą nadal ich używać niezależnie od dodanego klucza. Własne klucze są stosowane tam, gdzie możesz wybrać model, czyli w trybach czatu i edycji. Sprawdź aktualną dokumentację Cursora, ponieważ zmienia się ona między wydaniemiami.

Concurrency z trybu agenta. Agent i wieloetapowe uruchomienia mogą wysyłać wiele zapytań naraz. Klucz próbny pozwala na dwa jednocześnie. Jeśli błędy pojawiają się tylko w trybie agenta, prawdopodobnie trafasz w limit concurrency, a pełny klucz podnosi go do ośmiu. Żądanie strumieniowe trzyma swój slot do końca strumienia, więc długie wyjścia zajmują sloty dłużej.

Wywołania narzędzi. API obsługuje wywoływanie narzędzi, z tool_calls strumieniowanym i wynikami zwracanymi jako role: "tool". Jakość używania narzędzi zależy od modelu, więc jeśli uruchomienie agenta utnie się na kroku narzędzia, spróbuj najpierw tego samego zadania w zwykłym czacie.

Sprawdź stronę konta

Jeśli curl zwróci błąd dotyczący salda, klucz jest ważny, ale kredyt się wyczerpał lub okres próbny się zakończył. Kredyt próbny to $0,50 ważny przez 7 dni, który aktywujesz jednym kliknięciem na stronie klucza API po zalogowaniu się. Po tym czasie musisz doładować konto.

Doładowania to dowolna pełna kwota od $20 do $500, z bonusem +5% od $50, +10% od $100 i +15% od $200. Możesz płacić kryptowalutami (USDT w sieci TRC20, USDC w sieci Base). Strona z cennikiem pokazuje tabelę. Jeśli nie masz jeszcze klucza, zdobądź go tutaj.

Trzymaj jeden klucz na narzędzie. Jeśli wkleiłeś klucz do kilku edytorów i skryptów, limity zapytań są dzielone między nimi, co może wyglądać jak losowe awarie.

Sprawdzenie skryptem dla upartego przypadku

Jeśli nadal nie możesz znaleźć przyczyny, uruchom krótki skrypt, który odzwierciedla to, co robi edytor. Używa on SDK OpenAI, na którym oparte są klienci w stylu Cursor, i wypisuje dokładny obiekt błędu.

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

Jeśli skrypt strumieniuje tekst, endpoint, klucz i model są poprawne, a pozostały problem to ustawienie Cursora. Jeśli wypisuje kod statusu, użyj powyższej tabeli. Zachowaj wartość X-Request-Id przy kontakcie z supportem, ponieważ identyfikuje ona dokładne zapytanie. Pełne szczegóły parametrów są na stronie dokumentacji.

Zapobiegaj ponownym awariom

Kilka nawyków zapobiega większości powtarzających się problemów. Przechowuj klucz w jednym wpisie menedżera haseł i kopiuj stamtąd, zamiast z logów czatu lub notatek, gdzie wkradają się łamanie wierszy. Zapisz trzy wartości (base URL, klucz, nazwa modelu), aby móc je ponownie wpisać po aktualizacji edytora, ponieważ aktualizacje czasem resetują nadpisanie. Po każdej aktualizacji wyślij krótką wiadomość czatu przed rozpoczęciem prawdziwej pracy.

Śledź saldo. Nagłówek X-Balance-USD jest zwracany w każdej odpowiedzi, a Ty możesz go też odczytać z GET /v1/balance. Kredyt nigdy nie wygasa, więc skromne doładowanie leżące na koncie nie jest zmarnowane. Jeśli używasz klucza ze skryptów oraz z edytora, daj długim zadaniom batch pętlę ponownych prób, która czeka pięć sekund na 429 i przerywa po kilku próbach, aby skrypt nie zagłodził Twojego edytora z slotów równoległych zapytań.

Zapytanie czatu kodowania z 10 000 tokenami kontekstu pliku i odpowiedzią 700-tokenową kosztuje 10 000 / 1 000 000 x $0,15 = $0,0015 za input i 700 / 1 000 000 x $0,50 = $0,00035 za output, około $0,00185 łącznie. Stawki to $0,15 za 1M input i $0,50 za 1M output tokenów. Artykuł na cenach API Cursor obejmuje szacunki miesięczne.

Jeśli żądanie, które nie powiodło się, było duże, pamiętaj o oknie: prompt plus completion musi zmieścić się w 100 000 tokenów, a ciało żądania jest ograniczone do 8 MB. Dołączenie całego repozytorium do czatu może przekroczyć oba. Ogranicz kontekst do plików, które mają znaczenie, i spróbuj ponownie.

01

Pytania i odpowiedzi

Dlaczego Cursor zgłasza, że mój klucz API jest nieprawidłowy?

Zazwyczaj klucz zawiera zbędny spację lub został skopiowany niekompletnie, albo base URL nadal wskazuje na inną usługę. Skopiuj klucz ponownie, a następnie potwierdź, że URL nadpisanie to https://api.cursorapikey.com/v1.

Jaką nazwę modelu wpisać?

Wpisz uncensored, małymi literami. To jedyny model ID oferowany przez API.

Czy autouzupełnianie używa mojego klucza?

Niekoniecznie. Niektóre funkcje Cursora używają własnych modeli Cursora, a własne klucze API dotyczą głównie trybów czatu i edycji, w których wybierasz model.

Czy nieudane zapytania są rozliczane?

Nie. Nieudane lub odrzucone żądania nie są rozliczane, więc ponawianie prób podczas debugowania nic nie kosztuje.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.