Base URL og autentificering
Forbind til API'et ved hjælp af den angivne base-URL og en forudbetalt token-nøgle. Du autentificerer ved at sende din API-nøgle i request-headeren, hvilket sikrer, at det kun er din konto, der har adgang til dine kreditter. Tilmeld dig via Google eller e-mail for at modtage din nøgle øjeblikkeligt uden telefonverifikation.
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?"}]
}'Dine anmodninger retter sig mod det standard OpenAI-kompatible endpoint. Denne design gør det muligt at skifte til vores service uden at omskrive din eksisterende klientkode, forudsat at du opdaterer base-URL'en og legitimationsoplysningerne.
Chat Completions Endpoint
Send beskeder til modellen ved hjælp af POST /v1/chat/completions endpoint. Du skal angive model-ID'et som uncensored til at få adgang til den optimerede store sprogmodel, der kører på vores servere. Systemet accepterer standard beskedroller som bruger eller assistent til flerturns-samtaler.
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)Dette endpoint håndterer tekstinput og returnerer genereret tekst. Det understøtter ikke embeddings, billeder eller lyd. Fokuser på din prompt-struktur for at få de bedste resultater fra den uncensored-model.
Streaming-svar (SSE)
Aktivér realtidslevering af tokens ved at indstille stream-parameteren til true i din request. API'et returnerer Server-Sent Events (SSE) chunks, hvilket giver din applikation mulighed for at vise tekst, mens den genereres. Den sidste chunk indeholder de fulde tokenforbrugsstatistikker til fakturering.
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 reducerer opfattet latens for slutbrugere. Du kan behandle hvert token, når det ankommer, hvilket er ideelt til chatgrænseflader. Husk, at streaming ikke ændrer den underliggende modeladfærd eller tokenprissætning.
Function Calling og værktøjer
Definer værktøjer i din request for at lade modellen returnere strukturerede funktionskald. API'et understøtter tool_choice-parametre, hvilket giver dig mulighed for at tvinge modellen til at bruge et specifikt værktøj eller lade den afgøre autonomt. Denne funktion fungerer med standard OpenAI-værktøjsformater, hvilket gør integrationen enkel.
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);Brug funktionssamtale til at udtrække data eller udløse handlinger i dine applikationer. Modellen fortolker værktøjsdefinitionerne og returnerer JSON-objekter, der indeholder de nødvendige argumenter. Denne funktion udvider API'et ud over simpel tekstgenerering.
JSON-tilstand og parametre
Tving streng JSON-output ved at indstille response_format til {"type": "json_object"}. Dette sikrer, at modellen returnerer gyldig JSON, hvilket er afgørende for programmatisk parsing. Du kan også justere parametre som temperatur, top_p og stopsekvenser for at kontrollere kreativitet og outputlængde.
Modellen understøtter et kontekstvindue på 100.000 tokens. Dette giver dig mulighed for at sende store mængder kontekst i en enkelt anmodning. Max output er 16.000 tokens pr. anmodning, eller 2.048, hvis du ikke angiver max_tokens.
Begrænsninger, fejl og kontekst
Overvåg dine anmodningsgrænser for at undgå tjenesteafbrydelser. API'et tillader 300 anmodninger i minuttet per nøgle og op til 8 samtidige anmodninger. Din anmodningskrop skal holdes under 8 MB. Hvis du overskrider disse grænser, modtager du en 429-hastighedsbegrænsningsfejl.
Autentificeringsfejl returnerer en 401-fejl, hvis nøglen er ugyldig. En 402-fejl indikerer utilstrækkelig forudbetalt kredit. Fejl under generering forbruger ikke dine tokens. Context-vinduet inkluderer både prompt- og completion-tokens. Ubbrugt kredit udløber aldrig, hvilket sikrer, at din forudbetalte saldo forbliver tilgængelig til fremtidige projekter.