KimiCode: pierwsze zapytanie w pięć minut

Bazowy adres URL i uwierzytelnianie

Zacznij od wskazania klienta na nasz bazowy adres URL: https://api.kimicode.top/v1. Do każdego zapytania potrzebujesz klucza API. Wygeneruj go, klikając Pobierz klucz API na stronie. Zaloguj się przez Google lub użyj adresu e-mail i hasła. Nie jest wymagany numer telefonu. Klucz jest wyświetlany natychmiast po utworzeniu. Zachowaj go w sekrecie; na konto przypisany jest jeden aktywny klucz. Jeśli wygenerujesz nowy klucz, stary przestanie działać. Przekazuj klucz w nagłówku Authorization jako token Bearer.

Pierwsze zapytanie

Wyślij swój pierwszy prompt do endpointu ukończenia czatu. Użyj identyfikatora modelu uncensored. API akceptuje standardowe formaty kompatybilne z OpenAI. Dane wejściowe wchodzą, tekst wychodzi. Błędy i odmowy są darmowe, więc płacisz tylko za pomyślne użycie tokenów. Przetestuj łączność prostym promptem.

Kopiujcurl https://api.kimicode.top/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."}]
  }'

Jeśli klucz jest nieprawidłowy, otrzymasz błąd 401. Jeśli brakuje kredytu, otrzymasz błąd 402. Sprawdź saldo konta, jeśli zapytania zawiodą w nieoczekiwany sposób.

Integracja z Python SDK

Użyj oficjalnego Python SDK OpenAI. Ustaw bazowy adres URL na nasz endpoint. Przekaż swój klucz API. Klient automatycznie obsługuje format zapytania. Działa to dla dowolnego języka obsługującego klientów kompatybilnych z OpenAI. Zainstaluj bibliotekę przez pip. Skonfiguruj klienta, podając bazowy adres URL i klucz. Wyślij wiadomość, używając endpointu ukończenia czatu. Odpowiedź zawiera wygenerowany tekst. Możesz bezpośrednio przeanalizować zawartość z obiektu odpowiedzi.

Kopiujfrom openai import OpenAI

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

Upewnij się, że Twój kod obsługuje wyjątki w sposób elegancki. Problemy z siecią lub limity zapytań mogą wymagać ponownych prób.

Użycie Node SDK

Node.js SDK działa identycznie. Zaimportuj klienta. Skonfiguruj bazowy adres URL i klucz API. Wywołaj metodę ukończenia czatu. Przekaż identyfikator modelu i tablicę wiadomości. Struktura odpowiedzi odpowiada formatowi OpenAI. Wyodrębnij treść wiadomości asystenta. To podejście działa do generacji po stronie serwera lub funkcji krawędziowych. Nie jest wymagana dodatkowa konfiguracja poza zmianą bazowego adresu URL.

Kopiujimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicode.top/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);

Obsługuj błędy, sprawdzając kod stanu. Limity zapytań zwracają 429. Niewystarczające środki zwracają 402.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream: true. API zwraca zdarzenia wysyłane przez serwer (SSE). Każdy fragment zawiera częściową zawartość. Szczegóły użycia tokenów pojawiają się w ostatnim fragmencie. Zmniejsza to postrzeganą opóźnienie dla długich wyjść. Prawidłowo obsłuż zakończenie strumienia. Zamknij połączenie, gdy strumień się zakończy lub wystąpi błąd. Strumieniowanie działa ze wszystkimi standardowymi klientami obsługującymi SSE.

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

Upewnij się, że Twój klient poprawnie buforuje fragmenty. Połącz zawartość, aby utworzyć ostateczną odpowiedź.

Limity, błędy i okno kontekstu

Okno kontekstu wynosi łącznie 100 000 tokenów. Maksymalne wyjście to 32 000 tokenów na zapytanie. Ustaw 2048, jeśli max_tokens nie jest ustawione. Limit zapytań to 300 zapytań na minutę na klucz. Limit współbieżności to 8 jednoczesnych zapytań. Maksymalny rozmiar ciała zapytania to 8 MB. Błędy obejmują 401 za nieprawidłowe klucze, 402 za brak kredytu i 429 za limity zapytań. Kredyt nigdy nie wygasa. Błędy są darmowe. Bez pułapek subskrypcyjnych.