Documentație API Kimicode

URL de bază și autentificare

Conectează-te la API folosind URL-ul de bază furnizat și o cheie de token preplătită. Te autentifici trecând cheia API în antetul cererii, asigurând că doar contul tău accesează creditele tale. Înregistrează-te prin Google sau email pentru a primi cheia imediat, fără verificare prin telefon.

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

Cererea dumneavoastră vizează endpoint-ul standard compatibil cu OpenAI. Acest design vă permite să înlocuiți serviciul nostru fără a rescrie codul clientului existent, cu condiția să actualizați URL-ul de bază și acreditările.

Endpoint Completări Chat

Trimite mesaje către model folosind POST /v1/chat/completions endpoint. Trebuie să specificați ID-ul modelului ca uncensored pentru a accesa modelul de limbaj mare optimizat care rulează pe serverele noastre. Sistemul acceptă roluri standard de mesaje, cum ar fi user sau assistant, pentru conversații cu mai multe ture.

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)

Acest endpoint gestionează input text și returnează text generat. Nu suportă embedding-uri, imagini sau audio. Concentrați-vă asupra structurii promptului pentru a obține cele mai bune rezultate de la modelul fără cenzură.

Răspunsuri în streaming (SSE)

Activați livrarea tokenilor în timp real setând parametrul stream la true în cerere. API-ul returnează fragmente Evenimente trimise de server (SSE), permițând aplicației dvs. să afișeze textul pe măsură ce este generat. Ultimul fragment conține statistici complete de utilizare a tokenilor pentru facturare.

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-ul reduce latența percepută pentru utilizatorii finali. Poți procesa fiecare token pe măsură ce ajunge, ceea ce este ideal pentru interfețele de chat. Ține cont că streaming-ul nu modifică comportamentul modelului subiacent sau prețul pe token.

Apelarea funcțiilor și instrumentele

Definește instrumentele în cerere pentru a permite modelului să genereze apeluri de funcții structurate. API-ul suportă parametrii tool_choice, permițându-ți să forțezi modelul să folosească un instrument specific sau să decidă autonom. Această funcție funcționează cu formatele standard de instrumente OpenAI, făcând integrarea simplă.

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

Utilizează apelarea de funcții pentru a extrage date sau a declanșa acțiuni în aplicațiile tale. Modelul interpretează definițiile instrumentelor și returnează obiecte JSON care conțin argumentele necesare. Această capacitate extinde API-ul dincolo de simpla generare de text.

Mod JSON și Parametri

Imposibilitarea ieșirii JSON stricte prin setarea response_format pentru {"type": "json_object"}. Acest lucru asigură că modelul returnează JSON, ceea ce este crucial pentru analiza programatică. Poți ajusta, de asemenea, parametri precum temperatura, top_p și secvențele de oprire pentru a controla creativitatea și lungimea output-ului.

Modelul acceptă o fereastră de context de 100.000 de tokeni. Acest lucru îți permite să transmiți cantități mari de context într-o singură solicitare. Output-ul maxim este de 16.000 de tokeni per solicitare, sau 2.048 dacă nu specifici max_tokens.

Limitări, Erori și Context

Monitorați-vă limitele de solicitări pentru a evita întreruperile serviciului. API-ul permite 300 de solicitări pe minut per cheie și până la 8 solicitări concurente. Corpul solicitării trebuie să rămână sub 8 MB. Dacă depășiți aceste limite, veți primi o eroare de limitare a ratei 429.

Eșecurile de autentificare returnează o eroare 401 dacă cheia este invalidă. O eroare 402 indică credit preplata insuficient. Erorile în timpul generării nu consumă tokenurile. Fereastra de context include atât tokenurile prompt, cât și cele de completari. Creditul neutilizat nu expiră niciodată, asigurând că soldul preplătit rămâne disponibil pentru proiecte viitoare.