Documentație API Mistral: Ghid de început rapid

Instalează SDK-ul și setează URL-ul tău de bază

Începe prin a instala SDK-ul oficial pentru limbajul tău și să-l direcționezi către punctul nostru de terminare. URL-ul de bază este HTTPS://api.mistralapidoc.com/v1. Această singură modificare direcționează toate apelurile către infrastructura noastră fără cenzură, fără a altera logica existentă. Poți folosi orice client standard care suportă compatibilitatea OpenAI. Configurarea durează câteva secunde și nu necesită fișiere de configurare complexe.

Asigură-te că transmiți cheia ta API unică în antetul Authorization. Sistemul nostru validează această cheie împotriva soldului tău preplătit înainte de a procesa orice tokeni. Această abordare asigură că plătești doar pentru ceea ce folosești. Păstrează cheia în siguranță și rot-o dacă bănuiești o expunere. Cheia este emisă imediat după înregistrare prin Google sau email.

Fă prima ta cerere către modelul uncensored

Trimiteți o cerere POST către /v1/chat/completions cu ID-ul modelului setat la "uncensored". Acest model răspunde la conținut adult legal, ficțiune și subiecte controversate fără refuzurile standard. Este un model open-weight finetunat pentru răspunsuri directe. Nu trebuie să specifici un număr de versiune sau să faci routing între diferiți furnizori. Răspunsul returnează text în câmpul content.

Copycurl https://api.mistralapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models and their context windows"}]
  }'

Corpul solicitării include array-ul tău de mesaje și parametri opționali. API-ul nostru ignoră elegant câmpurile suplimentare. Dacă trimiți un prompt simplu, primești un completament direct. Folosește acest lucru pentru a verifica dacă integrarea ta funcționează înainte de a adăuga logică complexă. Modelul gestionează eficient contextul de până la 100,000 de tokeni.

Activați streaming-ul și gestionați utilizarea tokenilor

Setează stream la true pentru a primi tokeni prin Server-Sent Events. Această metodă reduce latența percepută pentru răspunsurile lungi. Ultimul chunk din stream conține statisticile complete de utilizare a tokenilor pentru acea solicitare. Poți loga aceste metrici pentru a urmări consumul creditelor preplătite cu precizie. Streaming-ul este ideal pentru interfețe de chat și aplicații în timp real.

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)

Gestionați răspunsurile parțiale acumulând delta-ul de conținut. API-ul nostru asigură că numărul total de token-uri corespunde cu utilizarea reală. Erorile în timpul streamingului nu vă vor fi facturate pentru token-urile incomplete. Această funcționalitate oferă o experiență fluidă utilizatorului, menținând în același timp costurile transparente. Puteți opri fluxul în avans dacă utilizatorul întrerupe generarea.

Utilizează apelarea de funcții și modul JSON

Pasați un array de tools pentru a activa apelarea funcțiilor. Modelul va genera apeluri de instrumente structurate când este cazul. De asemenea, puteți impune modul JSON setând response_format la json_object. Acest lucru garantează că ieșirea este un JSON valid, ceea ce simplifică analiza în aplicația dumneavoastră. Ambele funcții funcționează cu sintaxa standard a SDK-ului OpenAI.

Copyimport OpenAI from "openai";

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

Definește schema funcției tale cu nume, descriere și parametri. API-ul returnează numele funcției și argumentele în răspuns. Acest lucru permite codului tău să execute logica externă pe baza deciziei modelului. Modul JSON este util atunci când ai nevoie de structuri de date stricte. Combină aceste funcții pentru fluxuri de lucru robuste și automate.

Configurează parametrii: temperatura, top_p și seed

Ajustează temperatura pentru a controla aleatorietatea. Valorile mai mici fac răspunsurile mai deterministe. Top_p limitează eșantionarea nucleului la tokenii cei mai probabili. Seed asigură ieșiri reproducibile pentru depanare. Acești parametri îți oferă un control fin asupra comportamentului modelului. Folosește-i pentru a ajusta echilibrul dintre creativitate și acuratețe.

Copyfrom openai import OpenAI

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

Setează presence_penalty și frequency_penalty pentru a reduce repetiția. Modelul suportă toți parametrii standard OpenAI. Poți transmite o secvență stop pentru a opri generarea la markeri specifici. Aceste controale te ajută să obții formatul exact de output de care ai nevoie. Experimentează cu diferite combinații pentru a găsi setările optime pentru cazul tău de utilizare.

Limitări, erori și fereastră de context

API-ul nostru acceptă o fereastră de context de 100.000 de tokeni. Outputul maxim per solicitare este de 16.000 de tokeni, sau 2.048 dacă omiți max_tokens. Ai o limită de 300 de solicitări pe minut și 8 solicitări concurente per cheie. Corpul solicitării trebuie să rămână sub 8 MB. Aceste limite asigură o utilizare echitabilă pentru toți clienții preplătiți.

Gestionați erile HTTP 401 verificând cheia API. O eroare 402 indică credit preplătit insuficient. Reîncărcați cu criptomonede pentru a relua serviciul. O eroare 429 înseamnă că ați depășit limita de rată. Așteptați puțin înainte de a reîncerca. Sistemul nostru nu utilizează prompturi pentru antrenament, păstrând confidențialitatea datelor dvs. Erorile și refuzurile sunt gratuite, așa că plătiți doar pentru completările reușite.