PL ▾
Pobierz klucz API

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.

Pobierz klucz API

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.

Pobierz klucz APICzytaj dokumentację

Specyfikacja techniczna

Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.

ElementWartość
Format APIzgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz
ID modeluuncensored
UwierzytelnianieAuthorization: Bearer YOUR_KEY
EndpointyPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Maks. odpowiedźdo reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu)
Parametrytemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Wywoływanie funkcjitak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool
Strumieniowanietak — server-sent events; ostatni fragment zawiera zużycie tokenów
Okno kontekstu100 000 tokenów (wejście + odpowiedź)
Tryb JSONresponse_format: {"type": "json_object"}
Równoległe zapytaniado 8 jednocześnie na klucz
Limit zapytań300 zapytań na minutę na klucz
Nagłówki odpowiedziX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Rozmiar zapytaniado 8 MB
Cena$0,15 za 1 mln tokenów wejścia · $0,50 za 1 mln tokenów wyjścia
Rozliczenieprzedpł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ładowanieUSDT (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
Kluczejeden aktywny klucz na konto; nowy zastępuje stary
LogowanieGoogle albo e-mail i hasło
Treścitreś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.

KodTypZnaczenie
400bad_requestbłędny JSON, puste wiadomości, zły parametr lub za długi kontekst
401missing_key · invalid_key · key_revokedbrak klucza, zły klucz lub klucz zastąpiony nowym
402no_creditbrak kredytu — doładuj, działa od razu
403content_blockedtreści seksualne z nieletnimi — odmowa, bez opłaty
404not_foundnieznany endpoint
413request_too_largetreść większa niż 8 MB
429rate_limited · concurrencyponad 300/min lub 8 równolegle — odczekaj i ponów
503upstream_busymodel zajęty — ponów za kilka sekund