Skrócony przewodnik Kimi api

Wymagania wstępne: Instalacja SDK

Zainstaluj oficjalne SDK dla preferowanego języka, aby automatycznie obsługiwać uwierzytelnianie i serializację. Nasze API jest zgodne ze standardem OpenAI, więc dowolna kompatybilna biblioteka klienta działa przy minimalnych zmianach konfiguracji.

Dla Python zainstaluj bibliotekę przez pip. Dla Node.js użyj npm lub yarn. Narzędzia te zarządzają klientem HTTP i parsowaniem JSON za Ciebie.

Uwierzytelnianie: Ustawianie klucza API kimi

Obtain your key from the dashboard and pass it as the Authorization Nagłówek. Użyj adresu bazowego https://api.apikimi.cc/v1 dla wszystkich żądań.

Przechowuj klucz bezpiecznie w zmiennych środowiskowych lub plikach konfiguracyjnych. Format nagłówka to Bearer YOUR_API_KEY.

Wysyłanie pierwszej prośby

Wyślij żądanie POST do /v1/chat/completions z Twoim ID modelu uncensored. Odpowiedź zwraca bezpośrednio wygenerowany tekst.

Upewnij się, że ustawisz model pole poprawnie. API zwraca surowy wynik bez odrzuceń treści dla tematów prawnych.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream: true w ciele żądania. Zwraca fragmenty jako zdarzenia wysyłane serwerowo (SSE).

Przeanalizuj strumień SSE, aby wyświetlać tokeny w czasie rzeczywistym. Ostatni fragment zawiera statystyki zużycia tokenów do rozliczeń.

Konfiguracja wywoływania funkcji

Zdefiniuj narzędzia w tools tablicę w swoim żądaniu. Model zwraca wywołania narzędzi zamiast bezpośredniego tekstu, gdy jest to odpowiednie.

Obsłuż wywołania narzędzi w logice swojej aplikacji i wyślij wyniki z powrotem do API do dalszego przetwarzania. Wsparcie dla tool_choice pozwala na ścisłe egzekwowanie.

Obsługa błędów i limity

Obsługuj standardowe błędy HTTP: 401 dla nieprawidłowych kluczy, 402 dla niewystarczających środków oraz 429 dla limitów szybkości. Okno kontekstowe obsługuje łącznie 100,000 tokenów.

Maks. wyjście to 16,000 tokenów na żądanie. Błędy nie zużywają kredytu. Dostosuj swoją logikę ponawiania w zależności od kodu błędu.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikimi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikimi.cc/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

Copystream = 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)