API-sleutel mistral: Snelle Startgids

Vereisten: SDK en omgeving

Installeer je favoriete OpenAI-compatibele SDK. Je hebt alleen een geldige API-sleutel en de basis-URL voor onze dienst nodig.

Exporteer de sleutel naar je omgevingsvariabelen zodat je scripts deze veilig kunnen gebruiken. Maak een nieuw account aan via Google of e-mail om je sleutel direct te ontvangen. Voor deze stap is geen telefoonnumerverificatie vereist.

Zorg ervoor dat je omgeving standaard HTTP-bibliotheken ondersteunt. De API verwacht standaard JSON-payloads voor alle verzoeken. Je hoeft geen vendor-specifieke drivers te installeren.

De basis-URL instellen

Wijs uw SDK-client naar ons toegewijde eindpunt voor ongefilterde inferentie. De basis-URL vervangt het standaard OpenAI-eindpunt in uw configuratie.

Gebruik HTTPS://api.apikeymistral.com/v1 als je basis-URL. Dit zorgt ervoor dat alle verzoeken via onze servers met hoge doorvoer worden verwerkt. Je hoeft het eindpuntpad niet te wijzigen als je SDK standaard naar /chat/completions verwijst.

Bewaar uw API-sleutel in het geheugen of een veilige kluis. De sleutel verifieert elk verzoek dat u naar deze URL stuurt.

Je eerste POST-request maken

Stuur een standaard chat-completion verzoek om tekstuitvoer te krijgen. Gebruik de model-ID "uncensored" om toegang te krijgen tot ons afgestelde model.

Specify the temperature and other parameters to control creativity. The endpoint accepts standard JSON bodies with messages array.

Hier is een basis curl-opdracht om de verbinding te testen:

Copycurl https://api.apikeymistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json object with keys name age"}]
  }'

Verifieer dat de respons de gegenereerde tekst bevat. Controleer of de statuscode 200 is voor succes.

Python SDK integratie

Configureer de Python-client om onze basis-URL te gebruiken. Initialiseer de client met je API-sleutel en het aangepaste eindpunt.

Roep de methode chat.completions.create aan met je prompt. Het responsobject bevat de gegenereerde tekst in choices[0].message.content.

Verwerk potentiële fouten zoals rate limits of ongeldige sleutels soepel. Log het tokengebruik indien nodig voor kostenopvolging.

Copyfrom openai import OpenAI

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

Deze aanpak werkt met elke OpenAI-compatible bibliotheek. Je kunt bestaande code met minimale aanpassingen hergebruiken.

Node SDK-integratie

Initialiseer de Node.js-client met de aangepaste basis-URL. Geef je API-sleutel door in het configuratieobject.

Roep de functie chat.completions.create aan met uw gewenste parameters. De respons volgt het standaard OpenAI-formaat.

Verwerk de stream of de eindrespons zoals nodig. Foutafhandeling moet netwerkproblemen of authenticatiefouten opvangen.

Copyimport OpenAI from "openai";

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

Deze setup stelt je in staat uncensored inference snel te integreren in je Node-applicaties.

Stream-antwoorden verwerken

Schakel streamen in door stream=true in te stellen in je request. De API retourneert gegevens in chunks zodra ze worden gegenereerd.

Verwerk elke chunk om realtime uitvoer aan je gebruikers weer te geven. Accumuleer de inhoud om het volledige antwoord te krijgen.

Monitor tokengebruik in het laatste chunk van de stream. Dit helpt je kosten nauwkeurig te volgen.

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 vermindert de waargenomen latentie voor lange antwoorden. Het is ideaal voor chatinterfaces en interactieve toepassingen.

Limieten, fouten en contextvenster

Begrijp de technische limieten om serviceonderbrekingen te voorkomen. Het contextvenster ondersteunt 100.000 tokens voor prompt en completion samen.

Max output is 16.000 tokens per verzoek. Stel max_tokens expliciet in om te voorkomen dat je de standaardwaarde van 2.048 raakt.

Rate limits allow 300 requests per minute per key. You can have 8 concurrent requests at a time.

Verwerk 401-fouten door de geldigheid van je sleutel te controleren. 402-fouten geven aan dat het tegoed onvoldoende is. 429-fouten betekenen dat je de rate limit hebt bereikt.

Verzoeken die de limiet van de bodygrootte van 8 MB overschrijden, zullen falen. Plan je payload dienovereenkomstig.