kimiapikey.comPrzewodnik
Użyj klucza API w stylu Kimi w Cursor: Przewodnik konfiguracji
Cursor może komunikować się z każdym endpointem kompatybilnym z OpenAI, więc połączenie z tym API wymaga czterech pól i około dwóch minut. Ten przewodnik zawiera dokładne wartości, test potwierdzający działanie klucza oraz błędy, z którymi najprawdopodobniej się spotkasz.
Zaktualizowano

Kluczowe punkty
- Cursor potrzebuje trzech wartości: Twojego klucza, base URL https://api.kimiapikey.com/v1 oraz nazwy modelu
uncensored. - Przetestuj klucz najpierw za pomocą curl, aby łatwo odróżnić problem po stronie Cursora od problemu po stronie API.
- Edycje w stylu agenta wysyłają duże prompty, więc zwracaj uwagę na tokeny wejściowe: $0,15 za 1 mln wejściowych, $0,50 za 1 mln wyjściowych.
- Klucz próbny pozwala na 2 równoległe zapytania, które agent Cursora może przekroczyć. Pełny klucz pozwala na 8.
Krótka odpowiedź
Jeśli szukasz jak użyć klucza API kimi w cursor, pierwszą rzeczą do zapamiętania jest to, że klucz wydany przez innego dostawcę działa tylko z jego własnym endpointem. Klucz z tej strony działa z endpointem tej strony, a Cursor akceptuje go, ponieważ endpoint obsługuje format OpenAI chat completions. Wklejasz klucz, wskazujesz Cursorowi inny base URL i dodajesz jedną nazwę niestandardowego modelu.
Cała konfiguracja w kolejności:
- Utwórz konto i skopiuj swój klucz ze strony klucz API.
- Otwórz Cursor, przejdź do Ustawień, a następnie do Modeli.
- Wklej klucz w polu klucza API OpenAI.
- Włącz nadpisanie base URL i wpisz
https://api.kimiapikey.com/v1. - Dodaj niestandardowy model o nazwie
uncensoredi wybierz go w czacie.
Reszta tego artykułu wyjaśnia każdy krok, daje Ci sposób na przetestowanie połączenia poza edytorem oraz wymienia to, co zwykle idzie nie tak.
Czym jest ten klucz, a czym nie
Ta strona sprzedaje dostęp do jednego modelu o otwartych wagach, uruchamianego przez niezależnego dostawcę i dostrojonego do odpowiadania bez odmów dotyczących treści, do legalnego użytku przez dorosłych. Nie jest to oficjalne API Moonshot, Kimi ani żadnego innego dostawcy, ani router przesyłający Twoje zapytania do modelu innego dostawcy. Nazwa strony odzwierciedla to, czego ludzie szukają, a nie to, kto obsługuje usługę. Jeśli posiadasz już klucz od innego dostawcy, kontynuuj jego używanie z endpointem tego dostawcy. Te dwa klucze nie są wymienne.
Otrzymujesz zwykłe API w stylu OpenAI: POST /v1/chat/completions i GET /v1/models, uwierzytelnianie tokenem bearer, okno kontekstu 100 000 tokenów, strumieniowanie, wywoływanie funkcji i tryb JSON. Obsługuje tylko tekst. Nie ma generowania obrazów, embeddingów ani dostrajania, co ma znaczenie w edytorze, ponieważ funkcje Cursora zależne od tych funkcji nie będą korzystać z tego endpointu. Wyjaśnienie klucza API Kimi omawia nazewnictwo i alternatywy w większych szczegółach.
W przypadku programowania „uncensored” ma praktyczne znaczenie. Model nie przerwie zadania w połowie, ponieważ nazwa zmiennej lub fixture testowy wygląda na wrażliwy. Narzędzia bezpieczeństwa dla systemów, które posiadasz, parsery logów pełne brzydkich ciągów, skrypty scrapujące, generatory fikcji i zestawy testów moderacji to rodzaje pracy, które powodują odmowy w innych miejscach. Twarde ograniczenie pozostaje w mocy: nigdy nie ma treści seksualnych z udziałem nieletnich.
Konfiguracja krok po kroku w Cursor
1. Pobierz klucz i kredyt próbny
Zarejestruj się za pomocą Google lub e-maila i hasła. Na stronie klucza API możesz jednym kliknięciem odebrać $0,50 kredytu próbnego. Nie wymaga karty, trwa 7 dni i jest jeden na osobę. To wystarczy na kilka setek normalnych zapytań czatowych, więc ukończysz cały ten przewodnik przed wydaniem czegokolwiek.
2. Otwórz ustawienia modeli
W Cursorze otwórz Ustawienia i znajdź sekcję Modele. Etykiety menu zmieniają się między wersjami, więc szukaj pola dotyczącego klucza API OpenAI oraz przełącznika lub pola dotyczącego nadpisywania base URL OpenAI. To są dwa ważne ustawienia.
3. Wypełnij trzy wartości
| Pole Cursora | Wartość |
|---|---|
| Klucz API OpenAI | Twój klucz z dashboardu |
| Nadpisz base URL OpenAI | https://api.kimiapikey.com/v1 |
| Niestandardowa nazwa modelu | uncensored |
Wpisz base URL dokładnie tak, jak pokazano. Kończy się na /v1, bez ukośnika końcowego i bez /chat/completions, ponieważ klient dodaje ścieżkę samodzielnie. Wklejony URL z pełną ścieżką powoduje błąd 404, a komunikat o błędzie rzadko mówi, dlaczego.
4. Wybierz model i wyślij wiadomość
Otwórz panel czatu, wybierz uncensored z listy modeli i zapytaj o coś małego, np. „napisz funkcję, która parsuje daty ISO”. Jeśli odpowiedź strumieniuje, jesteś gotowy. Jeśli Cursor wyświetli błąd, nie zmieniaj ustawień losowo. Przejdź do następnej sekcji i przetestuj endpoint bezpośrednio.
5. Znaj efekt uboczny nadpisania
Nadpisanie base URL zazwyczaj dotyczy każdego modelu w stylu OpenAI, którego używasz w Cursorze, a nie tylko niestandardowego. Jeśli później przełączysz się na standardowy model OpenAI, wyłącz najpierw nadpisanie, w przeciwnym razie Twoje zapytanie trafi na ten endpoint z nazwą modelu, którego nie obsługuje.
Przetestuj klucz, zanim obwinisz edytor
Dwie minuty z terminalem oszczędzają godzinę zgadywania. To zapytanie robi to samo, co Cursor: wysyła uzupełnienie czatu z tokenem bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Body JSON z tablicą choices oznacza, że klucz, URL i nazwa modelu są poprawne. Sprawdź też nagłówki odpowiedzi. X-Balance-USD pokazuje Twój pozostały kredyt, a X-Request-Id jest wart zachowania, jeśli kiedykolwiek będziesz potrzebować śledzić zapytanie.
Ta sama kontrola w Pythonie z oficjalnym SDK OpenAI:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Możesz również wylistować modele za pomocą GET /v1/models. Cursor i podobni klienci czasem wywołują to po naciśnięciu przycisku weryfikacji, więc działające wywołanie modeli jest dobrym znakiem. Jeśli curl działa, a Cursor nie, problem jest w ustawieniach edytora, a tabela błędów poniżej pokrywa typowe przypadki.
Co się zmienia, gdy model pisze kod w Twoim edytorze
Czat w panelu bocznym jest tani. Krótkie pytanie z kilkuset tokenami kontekstu kosztuje ułamek centa. Funkcje edytora, które dołączają pliki, wyniki wyszukiwania i historię konwersacji kosztują więcej, ponieważ każde zapytanie zawiera wszystko ponownie. Model ma okno 100 000 tokenów dzielone między prompt a odpowiedź, a Cursor chętnie wypełni dużo tego okna, jeśli dołączysz duży folder.
Oto rzeczywiste obliczenie. Załóżmy, że zapytanie zawiera 40 000 tokenów wejściowych, a model zwraca 1 500 tokenów:
- Wejście: 40 000 / 1 000 000 x $0,15 = $0,006
- Wyjście: 1 500 / 1 000 000 x $0,50 = $0,00075
- Razem: $0,00675 za zapytanie, więc 100 takich zapytań kosztuje $0,675
To znacznie mniej niż dolar za ciężkie popołudnie, ale dominuje strona wejściowa, więc nawykiem, który oszczędza pieniądze, jest dołączanie mniejszej liczby plików, a nie zadawanie krótszych pytań. Rozpocznij nowy czat, gdy temat się zmieni, ponieważ stara historia jest opłacana ponownie w każdej turze.
Wywoływanie funkcji jest obsługiwane przez API, na którym polegają funkcje edytora w stylu agenta. Model decyduje się wywołać narzędzie, Twój klient je uruchamia i zwraca wynik jako wiadomość role: "tool". To, jak dobrze dowolny model prowadzi agenta wieloetapowego, zależy od modelu, więc przetestuj to na małym zadaniu, zanim powierzysz mu refaktoryzację. Jeden model o otwartych wagach za API oznacza, że otrzymujesz jedno zachowanie, a nie menu do wyboru.
Funkcje Cursora działające na własnych modelach Cursora, takie jak uzupełnianie Tab, generalnie nie są przełączane przez niestandardowy klucz. Sprawdź aktualną dokumentację Cursora, które funkcje akceptują niestandardowy endpoint w stylu OpenAI, ponieważ ta lista zmienia się między wydaniami.
Typowe błędy i jak je naprawić
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 404 lub "nie znaleziono" | Base URL zawiera ścieżkę endpointu lub brakuje /v1 | Użyj dokładnie https://api.kimiapikey.com/v1 |
| 401 nieautoryzowany | Dodatkowa spacja lub znak nowej linii w wklejonym kluczu albo przestarzały klucz | Skopiuj ponownie klucz z panelu i wklej go ponownie |
| Model nie znaleziony | Nazwa modelu wpisana inaczej | Użyj uncensored, małymi literami, niczego więcej |
429 z kodem concurrency | Zbyt wiele zapytań jednocześnie dla Twojego klucza | Poczekaj, aż bieżące zapytania się zakończą, albo użyj pełnego klucza (8 równoległych) |
429 z kodem rate_limited | Więcej niż dozwolona liczba zapytań na minutę | Zwolnij; klucze próbne pozwalają na 60 zapytań na minutę, pełne klucze na 300 |
429 z nagłówkiem Retry-After: 5 | Tymczasowe przeciążenie | Ponów próbę po pięciu sekundach |
| Przycisk weryfikacji nie działa, curl działa | Edytor testuje z nazwą modelu, którą zna | Pomiń krok weryfikacji i wyślij prawdziwą wiadomość czatu |
Błąd równoległości zasługuje na uwagę, ponieważ zaskakuje użytkowników kluczy próbnych. Klucz próbny pozwala na 2 równoległe zapytania, a agent, który uruchamia kilka operacji jednocześnie, może ten limit przekroczyć bez Twojego udziału. Strumieniowana odpowiedź również zajmuje slot do końca strumienia, więc długa odpowiedź blokuje jeden slot przez cały czas. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę, co jest komfortowe dla jednego programisty.
Nieudane i odrzucone zapytania nie są rozliczane, więc ponowna próba po błędzie nie kosztuje nic dodatkowego. Pełne limity znajdziesz na stronie dokumentacji.
Płacenie za nie po wyczerpaniu kredytu próbnego
Nie ma subskrypcji. Doładowujesz przedpłacony kredyt dowolną kwotą całkowitą od $20 do $500, a zapytania pobierają go w cenie $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych. Kredyt nie wygasa, więc miesiąc bez kodowania nic nie kosztuje. Doładowania od $50 wzwyż oferują bonus: +5% od $50, +10% od $100 i +15% od $200. Możesz zapłacić kryptowalutami (USDT na TRC20, USDC na Base). Aktualne stawki znajdziesz na stronie cenowej.
Przy zapytaniu z 40 000 tokenami wejściowymi i 1 500 wyjściowymi wspomnianym wcześniej, doładowanie za $20 pokrywa około 2 960 takich zapytań ($20 / $0,00675). Większość zapytań w edytorze jest mniejsza, więc rzeczywista liczba jest wyższa. Twoje prompty nie są używane do trenowania, co ma znaczenie, gdy kod, który wklejasz, należy do klienta.
Po zakończeniu konfiguracji rozsądnym pierwszym zadaniem jest małe zadanie, które możesz szybko przejrzeć: test jednostkowy dla istniejącej funkcji, wyrażenie regularne z długim komentarzem lub przepisanie jednego zaszumionego pliku. Jeśli wyniki pasują do Twojego przepływu pracy, doładuj kredyt. Jeśli nie, wydałeś kilka centów kredytu próbnego, aby się przekonać.
Więcej przewodników
- Ceny klucza API Kimi: Ile kosztuje ta alternatywa
- Integracja klucza API Kimi z SDK OpenAI i LangChain
- Klucz API Kimi: Jak działa i jakie są alternatywy
Najczęściej zadawane pytania
Czy model jest taki sam jak oficjalny Kimi od Moonshot?
Nie, hostujemy model o otwartych wagach, który jest dostrojony tak, aby był bez cenzury. Nie jest to GPT, Claude, Gemini, Grok, DeepSeek ani żaden inny model dostawcy. To odrębny model uruchamiany na naszych własnych serwerach.
Czy trenujecie na moich danych?
Nie. Twoje prompty i uzupełnienia nie są używane do trenowania. Ceniemy prywatność i przejrzystość, więc Twoje dane pozostają Twoje.
Jakie są limity zapytań?
Obowiązuje Cię limit 300 zapytań na minutę na klucz. Maksymalny rozmiar body zapytania wynosi 8 MB. Limity te mają na celu zapewnienie stabilnej wydajności dla wszystkich użytkowników.
Jaka jest polityka treści?
Model jest bez cenzury w zakresie treści dla dorosłych, kontrowersyjnych i twórczych. Blokujemy jednak treści seksualne z udziałem małoletnich. Jest to ścisły limit, który zawsze obowiązuje, niezależnie od poziomu subskrypcji.
Pytania i odpowiedzi
Czy mogę wkleić klucz Moonshot lub Kimi do Cursora z tym Base URL?
Nie. Klucz działa tylko z endpointem dostawcy, który go wydał. Użyj tutaj klucza z Twojego panelu lub zachowaj inny klucz z adresem URL innego dostawcy.
Jaka nazwa modelu jest wymagana w Cursorze?
Wpisz uncensored, małymi literami. To jedyny model ID obsługiwany przez to API, a inna nazwa zwróci błąd „model nie znaleziony”.
Czy działa w trybie agenta Cursora?
API obsługuje wywoływanie funkcji, czego wymagają funkcje agentów. To, jak niezawodnie model wykonuje długie, wieloetapowe zadania, różni się, więc przetestuj go na małym zadaniu przed dużym.
Dlaczego otrzymuję błąd 429 przy kluczu próbnym?
Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę. Pełny klucz pozwala na 8 równoległych i 300 na minutę, a nagłówek Retry-After: 5 oznacza krótkie przeciążenie, które można ponowić.
Czy mój kod jest używany do trenowania?
Nie. Prompty wysłane do API nie są używane do trenowania modeli.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień base URL. To cała konfiguracja.