Documentație API

Autentificare

Trimite cheia ta API în Authorization header ca un token Bearer. Primești această cheie imediat după înregistrare cu Google sau email pe Obține cheie API pagina. Dacă generezi una nouă, aceasta înlocuiește pe cea veche instantaneu. Erorile precum cheile invalide returnează un 401 status. Greșelile, cum ar fi dubla facturare, sunt rezolvate prin pagina de Suport.

Endpoint Completări Chat

Trimiteți JSON la POST /v1/chat/completions obținerea răspunsurilor text. Acesta este singurul endpoint pentru generarea de text. Nu suportă embeddings, imagini sau audio.

Stabilește model câmp pentru "uncensored". Modelul răspunde fără refuzuri de conținut pentru utilizarea adultă legală. Este un model cu greutate deschisă, optimizat pentru output nelimitat. Nu este GPT, Claude sau niciun alt model de la un alt furnizor.

Endpoint Modele

Apel GET /v1/models pentru a lista modelele disponibile. Răspunsul include uncensored ID-ul modelului. Folosește acest lucru pentru a verifica conectivitatea sau pentru a depana probleme de configurare în clientul tău.

Endpoint-ul returnează metadate în formatul standard OpenAI. Acest lucru te ajută să confirmi că URL-ul de bază și autentificarea funcționez corect înainte de a trimite payload-uri grele.

Parametri & Opțiuni

Suportă parametrii standard precum temperature, top_p, stop, seed, presence_penalty, și frequency_penalty. Setează max_tokens pentru a controla lungimea outputului. Valoarea implicită este de 2.048 de tokeni dacă omiți acest câmp.

Fereastra de context este de 100.000 de tokeni pentru prompt și completare combinate. Cererile care depășesc dimensiunea corpului de 8 MB pot eșua. De asemenea, sunt suportate funcțiile de apelare a funcțiilor (function calling) și modul JSON prin câmpuri standard.

Răspunsuri în streaming

Activați streaming-ul setând stream: true# Primești Server-Sent Events (SSE) pe măsură ce se generează tokenii. Acest lucru reduce latența percepută pentru aplicațiile interactive.

Statisticile privind utilizarea tokenilor apar în ultimul fragment al fluxului. Acest lucru îți permite să urmărești costurile cu precizie în timp real. Erorile în timpul streaming-ului returnează totuși coduri de stare HTTP corecte.

Apelarea funcțiilor & Mod JSON

Utilizare response_format cu {"type": "json_object"} pentru ieșire JSON strictă. Acest lucru este util pentru analizarea datelor structurate din LLM. Apelarea funcțiilor funcționează cu definiții standard de instrumente.

Setează tool_choice pentru a controla modul în care modelul utilizează funcțiile. Modelul suportă atât utilizarea automată, cât și forțată a instrumentelor. Acest lucru asigură o integrare fiabilă cu logica backend-ului tău.

cURL

Copycurl https://api.mistralaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the api limit for this service"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)