API Mistral AI: Ghid de început rapid

URL de bază și autentificare

Primul pas este configurarea clientului pentru a indica către infrastructura noastră. Înlocuiți URL-ul de bază standard OpenAI cu HTTPS://api.apimistralai.com/v1 și injectați cheia dvs. unică de API în antetul de autorizare. Această simplă comutare redirecționează toate cererile către modelul nostru uncensored, păstrând logica existentă de integrare intactă.

• URL de bază: HTTPS://api.apimistralai.com/v1
• Autentificare: Token Bearer prin Authorization header

Asigură-te că cheia este activă în panoul de cont înainte de a testa conexiunile.

Prima cerere

Trimiteți o cerere standard de completare a chat-ului pentru a verifica conectivitatea și răspunsul modelului. Următorul curl comanda țintește uncensored modelul cu un prompt de bază.

Aceasta confirmă că endpoint-ul este accesibil și returnează text fără filtrele standard de conținut.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Dacă răspunsul conține text, integrarea dvs. este redirecționată cu succes prin stratul nostru de inferență fără cenzură.

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI pentru a interacționa cu API-ul nostru fără a modifica structura de bază a cererii. Inițializează clientul cu noul URL de bază și cheia ta API, apoi apele chat.completions.create.

Această abordare vă permite să păstrați toată logica Python existentă în timp ce câștigați acces la capacitățile modelului uncensored.

Copyfrom openai import OpenAI

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

Obiectul de răspuns se comportă identic cu răspunsurile standard OpenAI, facilitând migrarea pentru dezvoltatorii Python.

Integrare SDK Node

Pentru medii JavaScript sau TypeScript, inițializați pachetul OpenAI cu URL-ul de bază personalizat. Setați apiKey și baseURL proprietăți înainte de a apela chat.completions.create.

Aceasta asigură că aplicațiile Node.js direcționează cererile către endpoint-ul nostru uncensored, menținând în același timp compatibilitatea cu modelele standard de SDK.

Copyimport OpenAI from "openai";

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

Structura răspunsului rămâne consistentă cu standardele OpenAI, permițând o integrare ușoară în fluxurile de lucru existente Node.js.

Răspunsuri în streaming prin SSE

Activați generarea tokenilor în timp real setând stream: true în cererea ta. API-ul returnează un flux de Evenimente Trimise de Server (SSE), permițându-vă să procesați tokenii pe măsură ce se generează.

Aceasta reduce latența percepută pentru utilizatori și oferă feedback imediat în timpul completărilor lungi.

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)

Analizați fluxul de date SSE pentru a afișa tokenii incremental. Fragmentul final conține utilizarea totală a tokenilor pentru solicitare.

Limitări, Erori și Context

Monitorați-vă utilizarea în raport cu limitele stricte de rată și gestionați erorile HTTP comune cu blândețe. Aveți voie la 300 de solicitări pe minut și 8 solicitări concurente per cheie.

O eroare 401 indică o cheie API nevalidă sau lipsă, în timp ce o eroare 402 înseamnă că creditul tău preplătit este epuizat. Un status 429 semnalează că ai depășit limita de 300 de cereri pe minut.

Fereastra de context suportă 100.000 de tokeni în total, cu o ieșire maximă de 16.000 de tokeni per cerere. Erorile și refuzurile nu consumă credit, asigurându-te că plătești doar pentru conținutul efectiv generat.