kimiapikey.comDokumentacja
API Kimi: Pierwsze zapytanie w pięć minut
Pierwszą odpowiedź otrzymasz w mniej niż pięć minut, korzystając ze standardowego interfejsu kompatybilnego z OpenAI. Przewodnik obejmuje konfigurację, uwierzytelnianie i podstawowe użycie modelu bez cenzury.
Wymagania wstępne
Aby zacząć, potrzebujesz klucza API od kimiapikey.com. Zarejestruj się, podając tylko e-mail i hasło; do próby nie jest wymagana karta kredytowa. Potrzebujesz również środowiska językowego z zainstalowanym oficjalnym lub kompatybilnym SDK. Nasze API jest zgodne z formatem chat-completions OpenAI, więc istniejący kod dla GPT-3.5/4 często działa po minimalnych zmianach. Upewnij się, że wersja Twojego SDK jest wystarczająco nowa, aby obsługiwać parametr base_url.
Adres bazowy i uwierzytelnianie
Nasz endpoint API znajduje się pod adresem https://api.kimiapikey.com/v1. Autoryzacja jest realizowana za pomocą standardowego nagłówka Authorization. Przekaż swój klucz jako token Bearer. Działa to z każdym klientem, który obsługuje endpointy kompatybilne z OpenAI. Jeśli korzystasz z proxy lub niestandardowego klienta, upewnij się, że poprawnie przekazuje nagłówek Authorization. ID modelu, o który będziesz prosić, to uncensored.
Pierwsze zapytanie
Wyślij proste uzupełnienie czatu, aby zweryfikować konfigurację. Użyj poniższego polecenia curl, zastępując YOUR_API_KEY swoim właściwym kluczem. To zapytanie wysyła krótki prompt do modelu uncensored. Po sukcesie otrzymasz odpowiedź JSON zawierającą odpowiedź modelu. Sprawdź tablicę choices pod kątem wygenerowanego tekstu. Jeśli otrzymasz błąd 401, Twój klucz jest nieprawidłowy lub wygasł.
SDK Python
Użyj oficjalnej biblioteki Pythona OpenAI dla najłatwiejszej integracji. Ustaw base_url na nasz endpoint i podaj swój klucz. Ten przykład pokazuje podstawowe wywołanie generowania tekstu. Możesz dostosować parametr model, jeśli jest to konieczne, choć uncensored jest domyślny. To podejście zapewnia przenośność kodu między różnymi usługami kompatybilnymi z OpenAI.
SDK Node.js
W projektach JavaScript/TypeScript użyj pakietu npm openai. Skonfiguruj klienta, podając nasz bazowy URL i klucz API. Pozwala to na wysyłanie zapytań bezpośrednio z środowiska Node. Składnia odzwierciedla SDK Pythona, zapewniając spójność przy zmianie języka. Pamiętaj o poprawnym obsłużeniu odpowiedzi asynchronicznych za pomocą await.
Odpowiedzi strumieniowe
Dla wyjścia w czasie rzeczywistym włącz strumieniowanie w swoim SDK. Wysyła ono fragmenty tekstu w miarę ich generowania, co zmniejsza postrzeganą latencję. Użyj flagi stream w swoim zapytaniu. SDK będzie zwracać częściowe odpowiedzi, pozwalając na stopniową aktualizację interfejsu użytkownika. Jest to idealne dla interfejsów czatu lub generowania długich treści, gdzie natychmiastowa informacja zwrotna jest cenna.
Limity i błędy
Każdy klucz jest ograniczony do 300 zapytań na minutę. Jeśli przekroczysz ten limit, otrzymasz błąd 429. Ciało Twojego zapytania nie może przekraczać 8 MB. Okno kontekstu 100 000 tokenów dotyczy sumy promptu i uzupełnienia. Typowe błędy to 401 (nieprawidłowy klucz) i 402 (niewystarczający kredyt). Doładuj konto przez panel, aby kontynuować korzystanie z API. Kredyty nigdy nie wygasają, a nie ma miesięcznych opłat.
cURL
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": "Write a blunt product review of a cheap VPN."}]
}'Python
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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Strumieniowanie
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Pytania i odpowiedzi
Czy API obsługuje wywoływanie funkcji?
Tak, endpoint obsługuje wywoływanie narzędzi/funkcji w standardowym formacie OpenAI. Możesz zdefiniować narzędzia w zapytaniu, a model zwróci strukturyzowane argumenty.
Co się stanie, jeśli przekroczę limit zapytań?
Otrzymasz błąd 429 Too Many Requests. Poczekaj i spróbuj ponownie lub zwiększ poziom przedpłaconego kredytu, aby utrzymać wyższy przepływ.
Czy model jest trenowany na moich danych?
Nie. Prompty wysłane do API nie są używane do trenowania. Twoje dane pozostają prywatne i nie są używane do ulepszania modelu bazowego.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień adres bazowy. To cała konfiguracja.
Specyfikacja techniczna
Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.
| Element | Wartość |
|---|---|
| Format API | zgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz |
| ID modelu | uncensored |
| Uwierzytelnianie | Authorization: Bearer YOUR_KEY |
| Endpointy | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Maks. odpowiedź | do reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu) |
| Parametry | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Wywoływanie funkcji | tak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool |
| Strumieniowanie | tak — server-sent events; ostatni fragment zawiera zużycie tokenów |
| Okno kontekstu | 100 000 tokenów (wejście + odpowiedź) |
| Tryb JSON | response_format: {"type": "json_object"} |
| Równoległe zapytania | do 8 jednocześnie na klucz |
| Limit zapytań | 300 zapytań na minutę na klucz |
| Nagłówki odpowiedzi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Rozmiar zapytania | do 8 MB |
| Cena | $0,15 za 1 mln tokenów wejścia · $0,50 za 1 mln tokenów wyjścia |
| Rozliczenie | przedpłacony kredyt według rzeczywistego zużycia; błędy i odmowy są darmowe |
| Bonus | +5% od $50, +10% od $100, +15% od $200 |
| Ważność | opłacony kredyt nie wygasa, bez subskrypcji |
| Doładowanie | USDT (TRC20) lub USDC (Base), dowolna pełna kwota od $20 do $500 |
| Darmowy kredyt | $0,50 na 7 dni, bez karty · Klucz próbny: 2 równoległe żądania, 60 na minutę; pełne limity (8 i 300) po pierwszym doładowaniu |
| Klucze | jeden aktywny klucz na konto; nowy zastępuje stary |
| Logowanie | Google albo e-mail i hasło |
| Treści | treści dla dorosłych dozwolone; treści seksualne z udziałem nieletnich są odrzucane |
Kody błędów
Błędy wracają jako JSON ze stałym type; nieudane i odrzucone zapytania są bezpłatne.
| Kod | Typ | Znaczenie |
|---|---|---|
400 | bad_request | błędny JSON, puste wiadomości, zły parametr lub za długi kontekst |
401 | missing_key · invalid_key · key_revoked | brak klucza, zły klucz lub klucz zastąpiony nowym |
402 | no_credit | brak kredytu — doładuj, działa od razu |
403 | content_blocked | treści seksualne z nieletnimi — odmowa, bez opłaty |
404 | not_found | nieznany endpoint |
413 | request_too_large | treść większa niż 8 MB |
429 | rate_limited · concurrency | ponad 300/min lub 8 równolegle — odczekaj i ponów |
503 | upstream_busy | model zajęty — ponów za kilka sekund |