Kimicode: Erste Anfrage in fünf Minuten

Basis-URL und Authentifizierung

Richte deinen Client zunächst auf unsere Basis-URL ein: https://api.kimicode.top/v1. Für jede Anfrage benötigst du einen API-Schlüssel. Erstelle einen, indem du auf API-Schlüssel erhalten auf der Website klickst. Melde dich mit Google oder per E-Mail und Passwort an. Eine Telefonnummer ist nicht erforderlich. Der Schlüssel wird sofort nach der Erstellung angezeigt. Bewahre ihn sicher auf; pro Konto ist nur ein Schlüssel aktiv. Wenn du einen neuen Schlüssel erstellst, funktioniert der alte nicht mehr. Übergebe den Schlüssel im Authorization-Header als Bearer-Token.

Erste Anfrage

Sende deinen ersten Prompt an den Chat-Completions-Endpunkt. Verwende die Modell-ID uncensored. Die API akzeptiert Standardformate im OpenAI-kompatiblen Format. Eingabe rein, Text raus. Fehler und Ablehnungen kosten nichts, also zahlst du nur für erfolgreiche Token-Nutzung. Teste die Konnektivität mit einem einfachen Prompt.

Kopierencurl 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."}]
  }'

Wenn der Schlüssel ungültig ist, erhältst du einen 401-Fehler. Wenn du kein Guthaben hast, erhältst du einen 402. Prüfe dein Kontostand, wenn Anfragen unerwartet fehlschlagen.

Python SDK-Integration

Verwende das offizielle OpenAI Python SDK. Setze die Base URL auf unseren Endpunkt. Übergebe deinen API-Schlüssel. Der Client verarbeitet das Anfrageformat automatisch. Dies funktioniert für jede Sprache, die OpenAI-kompatible Clients unterstützt. Installiere die Bibliothek über pip. Konfiguriere den Client mit deiner Base URL und deinem Schlüssel. Sende eine Nachricht über den Chat-Vervollständigungs-Endpunkt. Die Antwort enthält den generierten Text. Du kannst den Inhalt direkt aus dem Antwortobjekt parsen.

Kopierenfrom 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)

Stelle sicher, dass dein Code Ausnahmen ordnungsgemäß behandelt. Netzwerkprobleme oder Ratenlimits können Wiederholungen erfordern.

Node SDK-Nutzung

Das Node.js SDK funktioniert identisch. Importiere den Client. Konfiguriere die Basis-URL und den API-Schlüssel. Rufe die Chat-Completions-Methode auf. Übergebe die Modell-ID und das Nachrichten-Array. Die Antwortstruktur entspricht dem OpenAI-Format. Extrahiere den Inhalt der Assistenten-Nachricht. Dieser Ansatz funktioniert für serverseitige Generierung oder Edge Functions. Es ist keine zusätzliche Konfiguration erforderlich, außer der Änderung der Basis-URL.

Kopierenimport 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);

Behandle Fehler durch Überprüfung des Statuscodes. Ratenlimits geben 429 zurück. Unzureichende Mittel geben 402 zurück.

Streaming-Antworten

Aktiviere Streaming, indem du stream: true setzt. Die API gibt Server-Sent Events (SSE) zurück. Jeder Chunk enthält teilweise Inhalte. Token-Nutzungsdetails erscheinen im letzten Chunk. Dies reduziert die wahrgenommene Latenz für lange Ausgaben. Behandle Stream-Beendigung ordnungsgemäß. Schließe die Verbindung, wenn der Stream endet oder ein Fehler auftritt. Streaming funktioniert mit allen Standardclients, die SSE unterstützen.

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

Stelle sicher, dass dein Client Chunks korrekt puffert. Verkette den Inhalt, um die endgültige Antwort zu bilden.

Grenzen, Fehler und Kontext

Das Kontextfenster umfasst insgesamt 100.000 Token. Es gibt keine separate Ausgabeobergrenze. Wenn max_tokens nicht festgelegt ist, kann die Antwort bis zum Ende des Fensters reichen. Das Ratenlimit beträgt 300 Anfragen pro Minute pro Schlüssel. Das Concurrency-Limit beträgt 8 gleichzeitige Anfragen. Der maximale Request-Body beträgt 8 MB. Fehler umfassen 401 für ungültige Schlüssel, 402 für kein Guthaben und 429 für Ratenlimits. Guthaben verfällt nie. Fehler kosten nichts. Keine Abo-Fallen.