API-documentatie: OpenAI-compatible eindpunten

Authenticatie & basis-URL

Toegang tot de API door je unieke sleutel en de basis-URL in je omgevingsvariabelen in te stellen. Het endpoint bevindt zich op https://api.apikeykimi.com/v1. Je moet de header Authorization: Bearer YOUR_API_KEY bij elke request. Deze sleutel wordt direct gegenereerd bij aanmelding via Google of e-mail. Het is het enige credential dat nodig is voor authenticatie. Geen scopes of rechten hoeven geconfigureerd te worden.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Chat Completions Endpoint

Stuur berichten naar het model met behulp van de standaard /v1/chat/completions endpoint. Geef de model-ID op als uncensored in de request body. De API retourneert gegenereerde tekst op basis van uw promptgeschiedenis. U kunt parameters zoals temperatuur en top_p aanpassen om creativiteit te sturen. Het model ondersteunt function calling en JSON-modus voor gestructureerde outputs.

Copyfrom openai import OpenAI

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

Streaming-responsen (SSE)

Real-time tokenlevering inschakelen door stream: true in je verzoek. De server retourneert een stream van Server-Sent Events. Elke chunk bevat gedeeltelijke tekst totdat het antwoord compleet is. Dit is ideaal voor chatinterfaces en live coderingsweergaven. Gegevens over tokengebruik verschijnen in de laatste chunk van de stream.

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)

Functiedaanroep & JSON-modus

Definieer tools of forceer JSON-uitvoer met behulp van de response_format parameter. Stel json_object om ervoor te zorgen dat de respons geldige JSON is. U kunt ook tooldefinities doorgeven voor function calling. De model houdt zich strikt aan deze beperkingen. Dit maakt betrouwbare integratie met externe diensten mogelijk. Gebruik tool_choice om te regelen hoe tools worden aangeroepen.

Tokenlimieten & beperkingen

Het contextvenster ondersteunt tot 100.000 tokens voor input en output samen. De maximale uitvoer per verzoek is 16.000 tokens. Als je niet instelt max_tokens, de limiet is standaard 2.048 tokens. Requests zijn beperkt tot 8 MB in body-grootte. Je bent beperkt tot 300 verzoeken per minuut. Slechts 8 verzoeken kunnen gelijktijdig per sleutel draaien.

Fouthantering & Gebruikslimieten

Verwerk fouten door de HTTP-statuscode te controleren. Een 401 geeft een ongeldige of verlopen API-sleutel aan. Een 402-fout betekent dat je vooruitbetaalde tegoed op is. Een 429-respons signaleert dat je de snelheidslimiet van 300 requests per minuut hebt overschreden. Fouten en weigeringen kosten geen tokens. Controleer je saldo op het dashboard om onderbrekingen te voorkomen.

Node.js

Copyimport OpenAI from "openai";

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