Szybki start dla użytkowników Kimicode

Wymagania wstępne

Zanim napiszesz kod, załóż konto na kimicode.cc za pomocą Google lub e-maila. Otrzymasz natychmiast jeden klucz API. Nie wymagamy weryfikacji telefonem ani karty kredytowej. Twoje konto zaczyna się od darmowego kredytu próbnego w wysokości $0.50 ważnego przez siedem dni. Jeśli potrzebujesz większej przepustowości, doładowaj saldo kryptowalutą (USDT w sieci TRC20 lub USDC na Base) od kwoty $10. Kredyt nie wygasa, a błędy lub odrzucenia nie zużywają tokenów.

Upewnij się, że Twoje środowisko programistyczne ma Node.js (v18+) lub Python 3.8+. To API ściśle przestrzega specyfikacji klienta openai, co oznacza, że możesz podmienić nasz endpoint bez zmiany logiki biblioteki. Oferujemy jeden model bez cenzury pod identyfikatorem uncensored.

Zainstaluj SDK

Zainstaluj oficjalne SDK OpenAI dla preferowanego języka. Zapewnia to kompatybilność z naszymi funkcjami strumieniowania, wywoływania funkcji i trybu JSON.

Dla Pythona użyj pip do zainstalowania standardowej biblioteki:

• pip install openai

Dla Node.js zainstaluj pakiet npm:

• npm install openai

Te biblioteki automatycznie obsługują formatowanie HTTP. Nie potrzebujesz klienta specyficznego dla dostawcy. API kimicode przyjmuje standardowe parametry, takie jak temperature, top_p oraz max_tokens.

Zainicjuj klienta

Skonfiguruj obiekt klienta z bazowym URL kimicode i swoim kluczem API. Bazowy URL to https://api.kimicode.cc/v1. Ustaw api_key na wartość otrzymaną po rejestracji. Ta konfiguracja zastępuje domyślny endpoint api.openai.com.

• Bazowy URL: https://api.kimicode.cc/v1
• Model: uncensored
• Autoryzacja: Token Bearer poprzez api_key

Nie mieszaj tego klucza z innymi dostawcami. Działa wyłącznie z endpointem kimicode. Klient zweryfikuje klucz przy pierwszym zapytaniu. Jeśli klucz jest nieprawidłowy, otrzymasz błąd 401 natychmiast.

Wyślij zapytanie

Wyślij standardowe zapytanie o uzupełnienie czatu. ID modelu musi wynosić uncensored. Możesz dostosować max_tokens do 32 000. Jeśli pominięto, domyślna wartość to 2 048. Okno kontekstu wynosi łącznie 100 000 tokenów dla promptu i uzupełnienia.

• Wejście: Wiadomości tekstowe w tablicy messages.
• Wyjście: Odpowiedź tekstowa w choices[0].message.content.

Ten endpoint obsługuje tryb JSON poprzez response_format: {"type": "json_object"}. Nie obsługuje osadzania, obrazów ani audio. Skup się na generowaniu tekstu wysokiej jakości bez odmów treści dla tematów dla dorosłych.

Strumieniowanie odpowiedzi

Włącz strumieniowanie, ustawiając stream: true. API zwraca zdarzenia wysyłane przez serwer (SSE). Każdy fragment zawiera częściowy tekst. Statystyki użycia tokenów są zawarte w ostatnim fragmencie strumienia. Pozwala to na wyświetlanie wyniku w czasie rzeczywistym bez oczekiwania na pełną odpowiedź.

• Flaga strumieniowania: Ustaw na true w ciele żądania.
• Typ zdarzenia: chat.completion.chunk
• Dane: Zawiera delta.content dla części tekstu.

Strumieniowanie nie zmienia zasad rozliczeń. Płacisz za całkowitą liczbę przetworzonych tokenów. Błędy podczas strumieniowania są obsługiwane poprawnie. Jeśli połączenie zostanie zerwane, możesz wznowić zapytanie. Model bez cenzury zachowuje spójność nawet w długich strumieniach w ramach limitu 100k.

Limity, błędy i okno kontekstu

Monitoruj swoje limity: 300 zapytań na minutę na klucz, 8 zapytań równoległych oraz ciało zapytania do 8 MB. Jeśli przekroczysz limit zapytań, otrzymasz błąd 429. Jeśli przedpłacony kredyt zostanie wyczerpany, otrzymasz błąd 402; doładuj saldo kryptowalutą, aby wznowić działanie. Błąd 401 oznacza nieprawidłowy lub brakujący klucz API. Pamiętaj, że nieudane zapytania i odrzucenia nie zużywają tokenów. Twardy limit treści blokuje treści seksualne z udziałem małoletnich. Pozostałe legalne treści dla dorosłych są dozwolone.

Wywoływanie funkcji

Zdefiniuj narzędzia w parametrze tools. Model zwraca wywołania narzędzi w odpowiedzi. Użyj tool_choice, aby wymusić określone zachowanie. Ta funkcja działa identycznie jak w standardzie OpenAI. Przeanalizuj wywołania narzędzi w swoim kodzie i je wykonaj. Wyślij wyniki z powrotem w kolejnych wiadomościach. API kimicode obsługuje definicje narzędzi wydajnie. Upewnij się, że twój schemat JSON jest poprawny. Wywoływanie funkcji nie wymaga dodatkowych kredytów poza zużyciem tokenów. Jest idealne do budowania agentów lub przepływów pracy do ekstrakcji danych strukturalnych.

cURL

Copycurl https://api.kimicode.cc/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

Copyfrom openai import OpenAI

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