PL ▾
Pobierz klucz API

kimiapikey.comPrzewodnik

Klucz API Kimi nie działa: przyczyny, rozwiązania, zapasowy

Jeśli błąd „klucz API Kimi nie działa” zwraca kod 401, 404 lub 429, przyczyną jest prawie zawsze jeden z pięciu problemów: zły adres bazowy, niespójny klucz, brak salda, limit zapytań lub nazwa modelu, której endpoint nie rozpoznaje. Przejrzyj je w tej kolejności.

Zaktualizowano

Klucz pasujący do jednego zamka, podczas gdy zielona ścieżka prowadzi do drugiego otwartego zamka, symbolizująca endpoint API jako fallback
Izometryczna ilustracja edytora kodu połączonego świecącym kablem z serwerem API

Kluczowe punkty

  • Klucz działa tylko wobec dostawcy, który go wydał, więc adres bazowy i klucz muszą pochodzić z tego samego panelu.
  • 401 oznacza odrzucenie klucza, 404 zwykle oznacza złą ścieżkę, 429 oznacza przekroczenie limitu lub zajętość usługi.
  • Wypisz kod statusu i treść odpowiedzi przed zmianą czegokolwiek innego.
  • Zachowaj skonfigurowany drugi endpoint kompatybilny z OpenAI, aby jedna awaria nie zatrzymała Twojej aplikacji.

Najpierw przeczytaj kod statusu

Zanim wygenerujesz ponownie cokolwiek, sprawdź, co naprawdę odpowiedział serwer. Większość klientów w stylu OpenAI ukrywa treść odpowiedzi za ogólnym wyjątkiem. Wypisz zarówno kod statusu, jak i tekst.

curl -i https://api.kimiapikey.com/v1/models \
  -H "Authorization: Bearer $YOUR_KEY"

Pierwsza linia odpowiedzi mówi Ci, gdzie szukać:

KodZnaczenieZacznij od
401Klucz odrzuconyKlucz i adres bazowy z różnych dostawców
404Nie znaleziono ścieżki lub modeluBrak /v1, zduplikowana ścieżka, błędne ID modelu
400Nieprawidłowe ciało zapytaniaNazwy parametrów, format wiadomości, rozmiar ciała
429Przekroczony limit lub zajęta usługaCzęstotliwość zapytań, wywołania równoległe, czas ponownych prób
5xxProblem po stronie serweraPonów próbę z backoff, a następnie przełącz na zapasowy

Jeśli w ogóle nie otrzymasz odpowiedzi HTTP (timeout lub błąd DNS), problemem jest sieć lub literówka w nazwie hosta, a nie klucz.

Adres bazowy i klucz muszą być ze sobą powiązane

To najczęstszy powód awarii świeżego klucza. Klucze są wydawane per dostawca. Klucz z jednego panelu jest po prostu nieznany serwerom innego dostawcy, więc zwraca 401, mimo że klucz jest w pełni ważny w miejscu jego wydania.

Sprawdź te punkty:

  • Klucz i adres bazowy pochodzą z tej samej strony konta. Jeśli skopiowałeś klucz od jednego dostawcy, a w konfiguracji zostawiłeś stary adres bazowy, zapytanie trafi w złe miejsce.
  • Zmienne środowiskowe nie cieniują kodu. SDK OpenAI odczytuje OPENAI_API_KEY i OPENAI_BASE_URL, gdy nie przekażesz ich jawnie, więc przestarzała zmienna powłoki może nadpisać to, co wpisałeś w pliku.
  • Na końcu klucza nie ma spacji ani znaku nowej linii. Śledząca nowa linia po skopiowaniu i wklejeniu to klasyczna przyczyna błędu 401.
  • Nagłówek musi mieć dokładnie postać Authorization: Bearer <key>. Niektóre narzędzia oczekują klucza w innym nagłówku i wymagają włączenia trybu kompatybilnego z OpenAI.

Edytory i interfejsy czatu dodają jeszcze jedną pułapkę. Wiele z nich przechowuje osobne pole dla „adresu bazowego OpenAI” oraz osobny przełącznik go aktywujący. Jeśli przełącznik jest wyłączony, aplikacja cicho kontynuuje wywoływanie domyślnego hosta z Twoim nowym kluczem, co daje błąd 401 wyglądający jak zły klucz. Zapisz ustawienia, zrestartuj aplikację, jeśli buforuje konfigurację, i wyślij krótką wiadomość testową przed testowaniem czegoś bardziej złożonego.

Adres bazowy powinien kończyć się na /v1, a nie na samym hoście ani na /v1/chat/completions. SDK dołącza resztę ścieżki. URL zawierający już pełną ścieżkę prowadzi do zduplikowanej ścieżki i błędu 404.

Dostęp regionalny, proxy i sieci korporacyjne

Czasami klucz jest poprawny, a zapytanie nie dociera do właściwego serwera. Dostępność dostawcy może zależeć od tego, skąd się łączysz, a VPN, proxy korporacyjne lub reguła zapory mogą blokować lub modyfikować ruch. Sprawdź dokumentację lub stronę statusu samego dostawcy pod kątem obsługiwanych regionów i nie zakładaj, że zasady są takie same jak w przypadku innej usługi.

Szybki test izolacji: uruchom to samo polecenie curl z innej sieci, np. z hotspotu telefonu. Jeśli zadziała, klucz jest poprawny, a problemem jest Twoja sieć. Jeśli proxy ustawia HTTPS_PROXY, sprawdź, czy Twoja biblioteka HTTP faktycznie to respektuje; niektóre narzędzia to ignorują i kończą się błędem połączenia.

Saldo, limity i jak wygląda limit zapytań

Klucz może być ważny, a mimo to odrzucać zapytania, jeśli na koncie nie ma już środków lub wyczerpano limit. Sprawdź panel przed debugowaniem kodu. Jeśli nigdy nie doładowałeś konta, pamiętaj, że darmowe limity są zwykle małe i krótkotrwałe.

429 to inna historia. Oznacza, że serwer zwalnia Cię, a nie że klucz jest zły. Na endpointzie opisanym na tej stronie ważny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę, a klucz próbny na 2 równoległe i 60 na minutę. Po ich przekroczeniu API zwraca HTTP 429 z kodem błędu rate_limited (za dużo na minutę) lub concurrency (za dużo naraz). Tymczasowe przeciążenie również zwraca 429 z nagłówkiem Retry-After: 5.

Dwie nawyki naprawiają większość tych problemów. Respektuj Retry-After, gdy jest obecny, i ogranicz liczbę równoległych workerów do limitu współbieżności. Żądanie strumieniowe zajmuje slot do końca strumienia, więc zablokowany strumień liczy się przeciwko Tobie dłużej, niż się spodziewasz.

Nazwa modelu, parametry i rozmiar ciała

Błąd 404 lub 400 przy ważnym kluczu zwykle wskazuje na samo zapytanie. Sprawdź trzy rzeczy:

  1. ID modelu. Każdy dostawca ma własne nazwy modeli. Zapytaj endpoint, jakie modele obsługuje, wysyłając GET /v1/models, i skopiuj ID z odpowiedzi. Na tej stronie ID to uncensored.
  2. Parametry. Nazwy takie jak max_tokens, temperature i response_format są standardowe, ale dostawca może akceptować tylko ich podzbiór. Usuń pola opcjonalne, aż zapytanie przejdzie, a następnie dodawaj je z powrotem po jednym.
  3. Rozmiar. Bardzo duże prompty mogą zawalić się na limitach ciała przed dotarciem do modelu. Tutaj maksymalny rozmiar ciała to 8 MB, a okno kontekstu wynosi 100 000 tokenów łącznie dla promptu i completion.

Strumieniowanie to kolejne miejsce, gdzie działający klucz może wyglądać na zepsuty. Jeśli zapytanie udaje się bez stream: true, a zawala się z nim, przyczyną często jest proxy buforujące lub odcinające zdarzenia wysyłane przez serwer (SSE), a nie sam endpoint. Wyłącz strumieniowanie, aby to potwierdzić, a następnie sprawdź ustawienia proxy.

Jeśli zmieniłeś tylko nazwę modelu i wywołanie się zawaliło, przywróć starą nazwę, aby potwierdzić, że reszta konfiguracji jest poprawna.

Przygotuj endpoint zapasowy

Nawet zdrowy dostawca ma gorsze godziny. Jeśli Twój produkt zależy od jednego klucza, pojedyncza awaria staje się Twoją awarią. Ponieważ format zapytań OpenAI jest wspólny, możesz skonfigurować drugi endpoint i przełączać się kilkoma liniami kodu.

Endpoint na tej stronie jest kompatybilny z OpenAI, więc działa jako drugi dostawca. Jest to niezależny, hostowany model o otwartych wagach, a nie oficjalna usługa Moonshot, więc odpowiedź będzie inna niż w modelu Kimi — przetestuj swoje prompty przed jego użyciem. Oto mały wrapper, który najpierw próbuje głównego dostawcy, a w przypadku błędów przechodzi na rezerwowy:

import os
from openai import OpenAI

primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
                 api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
                  api_key=os.environ["FALLBACK_KEY"])

def ask(messages):
    try:
        r = primary.chat.completions.create(
            model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
    except Exception as e:
        print("primary failed:", e)
        r = fallback.chat.completions.create(
            model="uncensored", messages=messages, timeout=60)
    return r.choices[0].message.content

print(ask([{"role": "user", "content": "Say hi in five words."}]))

Cennik oparty jest na modelu pay-as-you-go: $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych z przedpłaconego kredytu, który nigdy nie wygasa. Nieudane lub odrzucone zapytania nie są rozliczane, więc rezerwowy endpoint, który rzadko się uruchamia, kosztuje grosze. Doładowania zaczynają się od $20; zobacz cennik, aby poznać poziomy bonusów.

Przetestuj alternatywę w dwie minuty

Nowi użytkownicy mogą jednorazowo dołączyć $0,50 kredytu próbnego na stronie klucza API po zalogowaniu się. Nie wymaga karty i jest ważny przez 7 dni, co wystarczy, aby uruchomić swoje prawdziwe prompty przez endpoint raz. Następnie uruchom poniższy test dymny.

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $FALLBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Sprawdź nagłówek odpowiedzi X-Balance-USD, aby zobaczyć pozostały kredyt. Pełna dokumentacja zapytania znajduje się w dokumentacji. Jeśli podłączasz to do edytora, istniejący przewodnik na używaniu klucza API w stylu Kimi w Cursorze pokazuje, gdzie znajduje się pole adresu URL bazowego, a przegląd klucza API Kimi wyjaśnia, jak ten endpoint odnosi się do modelu, którego używałeś.

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ń?
Limitujesz się do 300 zapytań na minutę na klucz. Maksymalny rozmiar ciała 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

Dlaczego nowy klucz od razu zwraca 401?

Najczęstsze przyczyny to klucz wysłany pod inne Base URL dostawcy, przypadkowa spacja lub znak nowej linii w skopiowanym kluczu lub zmienna środowiskowa nadpisująca kod w Twojej aplikacji. Przetestuj to za pomocą curl, aby wykluczyć problem z Twoim SDK.

Czy 429 to to samo co zły klucz?

Nie. 429 oznacza, że przekroczyłeś limit zapytań, limit równoległych zapytań lub chwilowe przeciążenie. Klucz jest ważny. Poczekaj na wartość Retry-After i zmniejsz liczbę równoległych zapytań.

Czy nieudane zapytania kosztują tutaj pieniądze?

Nie. Nieudane lub odrzucone zapytania nie są rozliczane na tym endpointzie, więc ponowna próba nieudanej operacji nie zużywa Twojego kredytu.

Czy mogę użyć tego endpointa jako bezpośredniego zamiennika dla modelu Kimi?

Obsługuje ten sam format zapytań OpenAI, więc zmiana w kodzie sprowadza się do zmiany Base URL, klucza i ID modelu uncensored. Podstawowy model jest inny, więc odpowiedzi nie będą identyczne; przetestuj swoje prompty wcześniej.

Twój klucz jest o jeden formularz stąd

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

Pobierz klucz APICzytaj dokumentację