Dokumentacja API - KimiCode

Bazowy URL i autoryzacja

Połącz swój kod z naszym API, aktualizując adres bazowy i podając swój klucz w nagłówku. Obsługujemy standardowe uwierzytelnianie, więc istniejący klienci SDK OpenAI działają natychmiast bez złożonej konfiguracji. Twój klucz API pojawia się natychmiast po rejestracji za pomocą Google lub e-mail, bez wymogu numeru telefonu.

Każde konto posiada jeden aktywny klucz w danym momencie; wygenerowanie nowego klucza zastępuje stary. Żądania są uwierzytelniane za pomocą nagłówka Authorization, zapewniając bezpieczny dostęp do Twojego z góry opłaconego kredytu.

Pierwsze żądanie

Wyślij pierwszą wiadomość używając standardowego endpointu chat completions z prostym żądaniem POST. Potwierdza to, że integracja działa, zanim przejdziesz do zaawansowanych funkcji lub danych strumieniowych. Odpowiedź zwraca tekst wyjściowy z modelu uncensored.

• Zamień YOUR_API_KEY na swój klucz z panelu.
• Ustaw model na 'uncensored' dla naszego konkretnego modelu open-weight.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Integracja SDK Python

Użyj oficjalnej biblioteki Pythona OpenAI do interakcji z naszym API, wskazując go na nasz base URL. To podejście wykorzystuje znaną składnię, pozwalając na zmianę dostawcy bez przepisywania całej logiki aplikacji. Biblioteka automatycznie zajmuje się tokenizacją i formatowaniem żądań.

• Zainstaluj pakiet openai za pomocą pip.
• Skonfiguruj podstawowy adres URL tak, aby wskazywał na nasz serwis.

Copyfrom openai import OpenAI

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

Integracja SDK Node

Zintegruj nasze API ze swoimi aplikacjami JavaScript lub TypeScript za pomocą SDK Node. Zapewnia to spójne zachowanie w środowiskach frontendowych i backendowych. Możesz przekazywać wiadomości i odbierać odpowiedzi tak samo, jak w przypadku dowolnej usługi kompatybilnej z OpenAI.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicodepricing.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 i zużycie tokenów

Włącz strumieniowanie, aby otrzymywać generowanie tokenów w czasie rzeczywistym za pomocą Server-Sent Events (SSE). Zmniejsza to postrzeganą latencję dla użytkowników i pozwala na natychmiastowe wyświetlanie częściowych wyników. Dane dotyczące użycia tokenów, w tym liczniki wejścia i wyjścia, są osadzone w ostatniej cząstce strumienia.

Ta metoda jest idealna dla interfejsów czatu, gdzie liczy się natychmiastowa informacja zwrotna. Możesz parsować strumień, aby aktualizować UI progresywnie, bez czekania na całą odpowiedź.

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)

Limity, Błędy i Kontekst

Zarządzaj użytkowaniem, rozumiejąc limity szybkości i typowe kody błędów. API obsługuje okno kontekstowe o rozmiarze 100,000 tokenów, umożliwiając głęboką historię rozmów. Jesteś ograniczony do 300 żądań na minutę i 8 równoległych żądań na klucz.

• 401 oznacza nieprawidłowy lub brakujący klucz API.
• 402 sygnalizuje, że Twój kredyt prepay został wyczerpany.
• 429 oznacza, że przekroczyłeś limit szybkości.

Błędy nie zużywają Twojego kredytu, więc możesz ponowić nieudane żądania bez kary.