How do I start using the kimicode API?

Create an account via Google or email to receive your API key. Then, point your OpenAI-compatible SDK to the base URL and pass your key in the header. Your first request will validate the connection and consume tokens from your prepaid balance.

What is the context window size?

The model supports a 100,000 token context window for both prompt and completion combined. Each request can output up to 16,000 tokens. If you do not set max_tokens, the default limit is 2,048 tokens.

Why do I get a 402 error?

A 402 error means your prepaid credit is exhausted. You must top up using crypto (USDT or USDC) to continue making requests. Credits are charged per token used, and errors do not consume your balance.

API-Dokumentation

Basis-URL und Authentifizierung

Verbinden Sie sich mit der API über die angegebene Basis-URL und einen Prepaid-Token-Schlüssel. Sie authentifizieren sich, indem Sie Ihren API-Schlüssel im Anfrage-Header übergeben, sodass nur Ihr Konto auf Ihre Credits zugreifen kann. Melden Sie sich über Google oder E-Mail an, um Ihren Schlüssel sofort ohne Telefonverifizierung zu erhalten.

curl https://api.kimicodeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current rate limit for free tier users?"}]
  }'

Ihre Anfragen zielen auf den Standard-OpenAI-kompatiblen Endpunkt ab. Dieses Design ermöglicht es Ihnen, unseren Dienst einzufügen, ohne Ihren bestehenden Client-Code ändern zu müssen, vorausgesetzt, Sie aktualisieren die Basis-URL und die Anmeldedaten.

Chat-Vervollständigungs-Endpunkt

Senden Sie Nachrichten an das Modell mit dem POST /v1/chat/completions Endpunkt. Du musst die Modell-ID als uncensored auf das optimierte Large Language Model zugreifen, das auf unseren Servern läuft. Das System akzeptiert Standard-Nachrichtenrollen wie Benutzer oder Assistent für Mehrfachgespräche.

from openai import OpenAI

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

Dieser Endpunkt verarbeitet Texteingaben und gibt generierten Text zurück. Er unterstützt keine Embeddings, Bilder oder Audio. Konzentrieren Sie sich auf die Struktur Ihrer Eingabeaufforderung, um die besten Ergebnisse vom unzensierten Modell zu erhalten.

Streaming-Antworten (SSE)

Aktivieren Sie die Echtzeit-Token-Zustellung, indem Sie den Parameter stream in Ihrer Anfrage auf true setzen. Die API gibt Server-Sent Events (SSE)-Chunks zurück, sodass Ihre Anwendung Text während der Generierung anzeigen kann. Der letzte Chunk enthält die vollständigen Token-Nutzungsstatistiken für die Abrechnung.

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

Streaming reduziert die wahrgenommene Latenz für Endbenutzer. Sie können jeden Token verarbeiten, sobald er eingeht, was ideal für Chat-Schnittstellen ist. Denken Sie daran, dass Streaming das zugrunde liegende Modellverhalten oder die Token-Preise nicht ändert.

Function Calling und Tools

Definieren Sie Tools in Ihrer Anfrage, um das Modell strukturierte Funktionsaufrufe zurückgeben zu lassen. Die API unterstützt tool_choice-Parameter, sodass Sie das Modell dazu zwingen können, ein bestimmtes Tool zu verwenden, oder es autonom entscheiden lassen. Dieses Feature funktioniert mit Standard-OpenAI-Tool-Formaten, was die Integration einfach macht.

import OpenAI from "openai";

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

Nutze Function Calling, um Daten zu extrahieren oder Aktionen in deinen Anwendungen auszulösen. Das Modell interpretiert die Tool-Definitionen und gibt JSON-Objekte mit den erforderlichen Argumenten zurück. Diese Fähigkeit erweitert die API über einfache Textgenerierung hinaus.

JSON-Modus und Parameter

Erzwingen Sie strenge JSON-Ausgabe durch Festlegen response_format zu {"type": "json_object"}. Dies stellt sicher, dass das Modell gültiges JSON zurückgibt, was für das programmgesteuerte Parsen entscheidend ist. Sie können auch Parameter wie Temperatur, top_p und Stop-Sequenzen anpassen, um Kreativität und Ausgabelänge zu steuern.

Das Modell unterstützt einen 100.000-Token-Context-Window. Dies ermöglicht es Ihnen, große Mengen an Kontext in einer einzigen Anfrage zu übergeben. Die maximale Ausgabe beträgt 16.000 Tokens pro Anfrage oder 2.048, wenn Sie max_tokens nicht angeben.

Limits, Fehler und Kontext

Überwachen Sie Ihre Anfrage Limits, um Serviceunterbrechungen zu vermeiden. Die API erlaubt 300 Anfragen pro Minute pro Schlüssel und bis zu 8 gleichzeitige Anfragen. Ihr Anfragekörper muss unter 8 MB bleiben. Wenn Sie diese Limits überschreiten, erhalten Sie einen 429-Rate-Limit-Fehler.

Authentifizierungsfehler geben einen 401-Fehler zurück, wenn der Schlüssel ungültig ist. Ein 402-Fehler zeigt unzureichendes vorausbezahltes Guthaben an. Fehler während der Generierung verbrauchen keine Tokens. Der Kontextfenster umfasst sowohl Prompt- als auch Completion-Tokens. Nicht verwendetes Guthaben verfällt nie, sodass Ihr vorausbezahltes Guthaben für zukünftige Projekte verfügbar bleibt.

Kimicode API-Dokumentation