Kimicode api-documentatie

Basis-URL en authenticatie

Maak verbinding met de API via de meegeleverde basis-URL en een voorbetaald token. U maakt authenticatie door uw API-sleutel mee te sturen in de request header, zodat alleen uw account toegang heeft tot uw credits. Meld u aan via Google of e-mail om uw sleutel direct te ontvangen zonder telefoonverificatie.

Copycurl 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?"}]
  }'

Uw verzoeken richten zich op het standaard OpenAI-compatible endpoint. Dit ontwerp stelt u in staat onze service te gebruiken zonder uw bestaande clientcode te herschrijven, mits u de basis-URL en referenties bijwerkt.

Chat Completions Endpoint

Stuur berichten naar het model met behulp van de POST /v1/chat/completions endpoint. Je moet de model-ID specificeren als uncensored toegang tot het geoptimaliseerde grote taalmodel dat op onze servers draait. Het systeem accepteert standaard berichtrollen zoals user of assistant voor multi-turn gesprekken.

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

Dit endpoint behandelt tekstinput en retourneert gegenereerde tekst. Het ondersteunt geen embeddings, afbeeldingen of audio. Concentreer je op de structuur van je prompt om de beste resultaten van het ongecensureerde model te krijgen.

Streaming-responsen (SSE)

Activeer realtime tokenlevering door de stream-parameter op true in te stellen in je request. De API retourneert Server-Sent Events (SSE) chunks, waardoor je applicatie tekst kan weergeven terwijl deze wordt gegenereerd. De laatste chunk bevat de volledige tokenverbruiksstatistieken voor facturatie.

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)

Streaming vermindert de waargenomen latentie voor eindgebruikers. Je kunt elke token verwerken zodra deze aankomt, wat ideaal is voor chatinterfaces. Onthoud dat streaming het onderliggende modelgedrag of de tokenprijzen niet verandert.

Function Calling en tools

Definieer tools in je request om het model gestructureerde functieaanroepen te laten uitvoeren. De API ondersteunt tool_choice-parameters, waardoor je het model kunt forceren een specifieke tool te gebruiken of autonoom kunt laten beslissen. Deze functie werkt met standaard OpenAI-toolformaten, wat de integratie eenvoudig maakt.

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

Gebruik function calling om gegevens te extraheren of acties uit te voeren in uw applicaties. Het model interpreteert de tooldefinities en retourneert JSON-objecten met de benodigde argumenten. Deze mogelijkheid breidt de API uit voorbij eenvoudige tekstgeneratie.

JSON-modus en parameters

Forceer strikte JSON-uitvoer door response_format naar {"type": "json_object"}. Dit zorgt ervoor dat het model geldige JSON retourneert, wat cruciaal is voor programmatische parsing. Je kunt ook parameters aanpassen zoals temperatuur, top_p en stop-reeksen om creativiteit en uitvoerlengte te beïnvloeden.

Het model ondersteunt een contextvenster van 100.000 tokens. Dit stelt je in staat grote hoeveelheden context in één verzoek te verstrekken. De maximale output is 16.000 tokens per verzoek, of 2.048 als je max_tokens niet opgeeft.

Limieten, fouten en context

Blijf uw aanvragenlimieten bewaken om onderbrekingen in de service te voorkomen. De API staat 300 aanvragen per minuut per sleutel toe en maximaal 8 gelijktijdige aanvragen. Uw aanvraagbody moet kleiner blijven dan 8 MB. Als u deze limieten overschrijdt, ontvangt u een 429-fout voor limietoverschrijding.

Authenticatiefouten retourneren een 401-fout als de sleutel ongeldig is. Een 402-fout geeft onvoldoende vooruitbetaald tegoed aan. Fouten tijdens het genereren verbruiken geen tokens. De contextvenster omvat zowel prompt- als completion-tokens. Niet gebruikt tegoed vervalt nooit, zodat uw vooruitbetaalde saldo beschikbaar blijft voor toekomstige projecten.