Documentație API

Autentificare & URL de Bază

Începeți prin a direcționa clientul către URL-ul de bază corect. Acceptăm antete standard OpenAI pentru compatibilitate. Cheia API se plasează în antetul Authorization ca token bearer. Transmiteți-o direct din variabilele de mediu pentru a evita codarea hardcoded a secretelor. Această configurare funcționează cu orice bibliotecă care suportă protocolul OpenAI.

Prima cerere

Trimiteți o completare chat simplă pentru a verifica conectivitatea. Utilizați ID-ul modelului "uncensored" pentru generarea de text. Endpoint-ul returnează un JSON standard cu opțiuni și metrici de utilizare. Dacă primiți un 401, verificați formatul cheii. Un 402 indică un sold de credit preplătit insuficient. Acest test rapid confirmă că integrarea dumneavoastră este gata pentru traficul de producție.

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Integrare SDK Python

Configurează pachetul OpenAI Python pentru a folosi URL-ul nostru de bază. Setează cheia API și numele modelului explicit. Transmite mesajele tale ca o listă de dicționare cu cheile role și content. Obiectul de răspuns conține textul generat în choices[0].message.content. Gestionează excepțiile în mod elegant pentru a prinde erori de rețea sau limitare a ratei în timpul execuției.

Copyfrom openai import OpenAI

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

Configurare SDK Node.js

Inițializați clientul OpenAI cu URL-ul de bază și cheia. Definește array-ul de mesaje cu rolurile user și assistant.apelează chat.completări.create cu modelul uncensored. Răspunsul oferă textul generat în prima alegere. Folosește acest model atât pentru apeluri sincrone, cât și asincrone în aplicațiile Node.

Copyimport OpenAI from "openai";

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

Răspunsuri în streaming

Activați fluxul de date setând stream la true. API-ul trimite fragmente de date pe măsură ce sunt generate. Fiecare fragment conține text delta pe care îl puteți adăuga la un buffer. Această abordare reduce latența percepută pentru ieșirile lungi. Monitorizați utilizarea tokenilor în ultimul fragment pentru a urmări facturarea cu precizie.

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)

Limite & Fereastră de Context

Contul dvs. suportă o fereastră de context de 100,000 de tokeni. Outputul maxim este de 16,000 de tokeni per cerere. Puteți trimite 300 de cereri pe minut. Doar 8 cereri rulează simultan. Cererile cu un corp de peste 8 MB vor eșua. Utilizați aceste limite pentru a vă proiecta logica de reîncercare. Erorile de tip 429 indică atingerea limitei de rată. Refuzurile nu consumă credite.