Documentație API: Endpoints compatibile OpenAI

Autentificare & URL de Bază

Accesează API-ul setând cheia ta unică și URL-ul de bază în variabilele de mediu. Punctul final este disponibil la https://api.apikeykimi.com/v1. Trebuie să incluzi header-ul Authorization: Bearer YOUR_API_KEY cu fiecare solicitare. Această cheie este generată instantaneu la înregistrare prin Google sau email. Este singura acreditare necesară pentru autentificare. Nu trebuie configurate scope-uri sau permisiuni.

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

Endpoint Completări Chat

Trimite mesaje către model folosind standardul /v1/chat/completions endpoint. Specifică ID-ul modelului ca uncensored în corpul solicitării. API returnează textul generat pe baza istoricului de prompturi. Puteți ajusta parametri precum temperatura și top_p pentru a controla creativitatea. Modelul suportă apelarea de funcții și modul JSON pentru ieșiri structurate.

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)

Răspunsuri în streaming (SSE)

Activează livrarea de token-uri în timp real setând stream: true în cererea ta. Serverul returnează un flux de Evenimente trimise de server. Fiecare fragment conține text parțial până la finalizarea răspunsului. Acest lucru este ideal pentru interfețele de chat și afișajele de codare live. Detaliile privind utilizarea tokenilor apar în fragmentul final al fluxului.

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)

Apelarea funcțiilor & Mod JSON

Definește instrumente sau forțează ieșirea JSON folosind response_format parametru. Setează json_object pentru a vă asigura de răspunsuri JSON valide. De asemenea, puteți transmite definiții de tool-uri pentru apelarea de funcții. Modelul respectă strict aceste constrângeri. Acest lucru permite o integrare fiabilă cu servicii externe. Utilizați tool_choice pentru a controla modul în care sunt invocate instrumentele.

Limite Token & Constrângeri

Fereastra de context suportă până la 100.000 de tokeni pentru input și output combinate. Ieșirea maximă per solicitare este de 16.000 de tokeni. Dacă nu setați max_tokens, limita implică 2.048 de tokeni. Cererile sunt limitate la 8 MB în dimensiunea corpului. Ești limitat la 300 de cereri pe minut. Doar 8 cereri pot r simultan per cheie.

Gestionarea erorilor & Limite de utilizare

Gestionați erorile verificând codul de stare HTTP. Un 401 indică o cheie API invalidă sau expirată. O eroare 402 înseamnă că creditul preplătit s-a epuizat. Un răspuns 429 semnalează că ați depășit limita de rată de 300 de cereri pe minut. Erorile și refuzurile nu consumă tokeni. Verificați-vă soldul pe panou pentru a evita întreruperile.

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