kimiapikey.comPrzewodnik
Podstawowy URL API Moonshot: skieruj kod w inne miejsce
Podstawowy URL API Moonshot to tylko jeden ciąg znaków w Twoim kliencie w stylu OpenAI, a jego zmiana pozwala skierować ten sam kod do innego dostawcy. Ta strona pokazuje, gdzie znajduje się ten ciąg w Pythonie, Node, curl i popularnych narzędziach oraz jak skierować go na alternatywny endpoint.
Zaktualizowano


Kluczowe punkty
- Podstawowy URL to pojedyncze ustawienie; ciało zapytania pozostaje w formacie czatu OpenAI.
- Zmień trzy rzeczy przy przełączaniu: podstawowy URL, klucz API, identyfikator modelu.
- Nasz endpoint to https://api.kimiapikey.com/v1, a identyfikator modelu to uncensored.
- To niezależny model hostowany, nie oficjalna usługa Moonshot, więc ponownie sprawdź swoje prompty.
Co właściwie robi podstawowy URL
Klienci kompatybilni z OpenAI budują każde zapytanie z dwóch części: podstawowego URL i ścieżki. SDK łączy je, więc wywołanie chat.completions.create staje się POST do <base_url>/chat/completions. Dostawcy przestrzegający tego formatu, w tym Moonshot, publikują swój podstawowy URL w dokumentacji. Sprawdź go tam, a nie kopiuj z posta na forum, bo to jedyna wartość, której nie zgadniesz.
Przełączenie dostawcy wymaga więc trzech edycji i niczego więcej:
- Podstawowy URL, który decyduje, dokąd trafi zapytanie.
- Klucz API, który jest wydawany dla każdego dostawcy i działa tylko na serwerach tego dostawcy.
- Identyfikator modelu, ponieważ każdy dostawca nazywa swoje modele inaczej.
Wiadomości, role, strumieniowanie, narzędzia i tryb JSON zachowują ten sam kształt, dlatego migracja jest krótka. Wszystko, co zależy od funkcji specyficznych dla dostawcy, np. wbudowanego narzędzia do wyszukiwania w sieci, wymaga osobnej obsługi.
Pomocne jest również trzymanie trzech wartości razem w jednym bloku konfiguracyjnym lub jednym pliku środowiskowym na dostawcę. Gdy podstawowy URL, klucz i identyfikator modelu są obok siebie, powrót to zmiana jednej linii, a unikasz stanu częściowej migracji, w którym nowy klucz jest sparowany ze starym adresem.
Python: pakiet openai
W Pythonie ustawiasz podstawowy URL podczas tworzenia klienta. Ten przykład łączy się z endpointem na tej stronie:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Jeśli wolisz mieć kod wolny od ustawień, użyj środowiska. SDK odczytuje OPENAI_BASE_URL i OPENAI_API_KEY przy wywołaniu OpenAI() bez argumentów, więc wdrożenie może przełączać dostawców bez zmiany kodu. Pamiętaj, że oznacza to również, że zaległa zmienna w powłoce może nadpisać wartość wpisaną w pliku.
Node i curl
Oficjalny pakiet JavaScript używa tej samej nazwy opcji, zapisanej w camel case:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
Bez żadnego SDK podstawowy URL to po prostu początek adresu:
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":"Hello"}]}'
Ten sam endpoint akceptuje również POST /v1/responses, a GET /v1/models wyświetla, co oferuje. Autoryzacja to token bearer w nagłówku Authorization w każdym przypadku.
Edytory i interfejsy czatu
Narzędzia GUI eksponują podstawowy URL pod różnymi etykietami: „API base”, „Override OpenAI Base URL”, „Custom endpoint” lub „Provider URL”. Wklejany ciąg to ten sam co w kodzie powyżej, kończący się na /v1. Nie wklejaj pełnego adresu /chat/completions, chyba że narzędzie wymaga pełnego URL.
Po zapisaniu dodaj identyfikator modelu ręcznie, jeśli narzędzie nie pobiera listy. Niektóre edytory walidują klucz względem ustalonego dostawcy i odrzucają wartości niestandardowe; w takim przypadku najpierw znajdź ustawienie włączające tryb niestandardowy lub kompatybilny z OpenAI. Artykuł na używaniu klucza API w stylu Kimi w Cursor szczegółowo omawia jedno z takich narzędzi.
Co się zmienia przy przełączaniu dostawców
Dopasowanie formatu nie oznacza dopasowania zachowania. Przed przeniesieniem ruchu produkcyjnego sprawdź te punkty jeden po drugim:
- Styl wyjściowy. Inny model pisze inaczej. Uruchom swoje prawdziwe prompty, a nie przykład demonstracyjny.
- Rozmiar kontekstu. Ten endpoint ma okno kontekstu o pojemności 100 000 tokenów dla promptu plus completion. Jeśli obecna konfiguracja wysyła dłuższe prompty, najpierw je skróć.
- Limity. Pełny klucz pozwala na 8 równoległych zapytań i 300 na minutę. Przekroczenie któregokolwiek limitu zwraca HTTP 429 z kodem
rate_limitedlubconcurrency. - Funkcje. Strumieniowanie przez SSE, wywoływanie narzędzi i tryb JSON są obsługiwane. Generowanie obrazów, audio i wideo, embeddingi oraz fine-tuning nie są; jest to API tylko tekstowe.
- Nazewnictwo. Usługa obsługuje jeden model o otwartych wagach wybrany do odpowiadania bez odrzucania treści dla prawnego użytku przez osoby dorosłe. Nie jest to oficjalne API Moonshot ani router między dostawcami.
neutralnym sposobem porównania jest zalogowanie tych samych dziesięciu promptów przez oba endpointy i odczytanie odpowiedzi obok siebie. Zajmuje to kilka minut i oszczędza zgadywania.
Błędy w podstawowym URL i jak je rozpoznać
Większość niepowodzeń po przełączeniu wynika z adresu, a nie klucza. Oto jak objawia się każdy błąd i jak go naprawić.
| Błąd | Objaw | Naprawa |
|---|---|---|
Tylko host, bez /v1 | 404 przy każdym wywołaniu | Dodaj /v1 na koniec |
| Wklejona pełna ścieżka | 404 z podwojoną ścieżką w błędzie | Skróć adres do /v1 |
| Końcowy slash plus ręczne łączenie ścieżek | Podwójny slash w URL | Pozwól SDK łączyć ścieżkę |
| Stary klucz, nowy URL | 401 | Użyj klucza wydawanego przez nowego dostawcę |
| Stary URL, nowy klucz | 401 od starego dostawcy | Przeszukaj repo i powłokę pod kątem starego adresu |
http:// zamiast https:// | Błąd przekierowania lub połączenia | Używaj https wszędzie |
Szybki sposób na znalezienie resztek to przeszukanie projektu i ustawień wdrożenia pod starą nazwę hosta. Sprawdź pliki .env, zmienne CI, pliki Docker compose i ustawienia edytorów, ponieważ jedna zapomniona kopia wystarczy, by wysłać ruch do starego dostawcy.
Strumieniowanie i narzędzia po przełączeniu
Ustaw stream: true, a odpowiedź przybędzie jako zdarzenia wysyłane przez serwer, z raportem użycia tokenów na końcu. Wywoływanie narzędzi wykorzystuje standardowe pola tools i tool_choice, strumieniowane tool_calls oraz wyniki wysyłane z powrotem jako wiadomości z role: "tool". Jeśli Twój kod już je obsługuje dla poprzedniego dostawcy, powinien działać dalej; potwierdź to, wykonując jedno strumieniowane zapytanie i jedno z wywoływaniem narzędzi przed pełnym przełączeniem. Pamiętaj, że zapytanie strumieniowe zajmuje slot współbieżności do momentu zakończenia strumienia.
Sprawdź koszt przed przełączeniem
Rozliczanie tutaj jest za tokeny: $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, z przedpłaconego kredytu, bez subskrypcji. Nieudane lub odrzucone zapytania nie są rozliczane, a kredyt nie wygasa. Sprawdź aktualną stronę cenową innego dostawcy, ponieważ ceny się zmieniają.
Przykład krok po kroku. Załóżmy, że zapytanie ma 2 000 tokenów wejściowych i 500 tokenów wyjściowych:
- Wejście: 2 000 / 1 000 000 x $0,15 = $0,0003
- Wyjście: 500 / 1 000 000 x $0,50 = $0,00025
- Razem: $0,00055 za zapytanie, więc 1 000 zapytań kosztuje $0,55
Najmniejsze doładowanie to $20, a większe dodają bonus: +5% od $50, +10% od $100 i +15% od $200. Akceptowane są tylko kryptowaluty (USDT na TRC20, USDC na Base). Pełne szczegóły są na stronie cenowej, a szczegółowy opis dla Kimi znajduje się w cenniku klucza API Kimi.
Pobierz klucz i wykonaj pierwsze zapytanie
Zarejestruj się za pomocą Google lub e-maila i hasła, a następnie otwórz stronę klucza API. Nowi użytkownicy mogą jednym kliknięciem odebrać $0,50 kredytu próbnego — jeden na osobę, ważny przez 7 dni, bez konieczności podania karty. Klucze próbne są ograniczone do 2 równoległych żądań i 60 na minutę, co w zupełności wystarcza do przeprowadzenia testu.
Wklej klucz do powyższego fragmentu kodu w Pythonie, uruchom go i upewnij się, że otrzymujesz tekst. Dokumentacja zawiera opis wszystkich parametrów, a nagłówki odpowiedzi X-Request-Id i X-Balance-USD pomagają w debugowaniu i śledzeniu salda. Prompty wysłane do usługi nie są używane do trenowania modeli.
Więcej przewodników
- Klucz API Kimi nie działa: Przyczyny, Rozwiązania, Alternatywy
- Użyj klucza API w stylu Kimi w Cursor: przewodnik konfiguracji
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ł pozbawiony 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ń?
Limit wynosi 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 niecenzurowany w zakresie tematów 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 Twojego poziomu subskrypcji.
Pytania i odpowiedzi
Czy muszę zmieniać kod po zmianie adresu bazowego?
Zazwyczaj tylko trzy wartości: adres bazowy, klucz API i ID modelu. Format wiadomości, strumieniowanie i wywoływanie narzędzi pozostają takie same, o ile nowy dostawca je obsługuje.
Czy adres bazowy powinien kończyć się na /v1?
Tak dla tego endpointu: https://api.kimiapikey.com/v1. SDK dodaje /chat/completions samo, więc nie należy go dołączać.
Czy to oficjalne API Moonshot?
Nie. To niezależnie hostowany model o otwartych wagach za pośrednictwem API kompatybilnego z OpenAI. Nie jest to usługa Moonshot ani router między dostawcami.
Gdzie znajdę ID modelu?
Wywołaj GET /v1/models swoim kluczem. Na tym endpointzie ID modelu to uncensored.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.