Mistral api documentatie: Snelle Startgids

Installeer de SDK en stel je basis-URL in

Installeer eerst de officiële SDK voor uw taal en wijs deze naar ons eindpunt. De basis-URL is HTTPS://api.mistralapidoc.com/v1. Deze enkele wijziging stuurt alle aanroepen naar onze ongecensureerde infrastructuur zonder uw bestaande logica te wijzigen. U kunt elke standaardclient gebruiken die OpenAI-compatibiliteit ondersteunt. De setup duurt enkele seconden en vereist geen complexe configuratiebestanden.

Zorg ervoor dat je je unieke API-sleutel doorgeeft in de Authorization-header. Ons systeem valideert deze sleutel tegen je vooruitbetaalde saldo voordat het tokens verwerkt. Deze aanpak zorgt ervoor dat je alleen betaalt voor wat je gebruikt. Houd je sleutel veilig en draai hem om als je vermoedt dat hij is blootgesteld. De sleutel wordt direct uitgegeven bij aanmelding via Google of e-mail.

Maak je eerste verzoek aan het uncensored model

Stuur een POST-verzoek naar /v1/chat/completions met de model ID ingesteld op "uncensored". Dit model reageert op wettelijke volwassen inhoud, fictie en controversiële onderwerpen zonder standaardweigeringen. Het is een open-weight model dat is getuned voor directe antwoorden. Je hoeft geen versienummer op te geven of te routeren tussen verschillende leveranciers. De response retourneert tekst in het content-veld.

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"}]
  }'

De request body bevat je berichtarray en optionele parameters. Onze API negeert extra velden op een soepele manier. Als je een eenvoudige prompt stuurt, ontvang je een directe voltooiing. Gebruik dit om te verifiëren dat je integratie werkt voordat je complexe logica toevoegt. Het model verwerkt context tot 100,000 tokens efficiënt.

Activeer streaming en verwerk tokenverbruik

Stel stream in op true om tokens te ontvangen via Server-Sent Events. Deze methode vermindert de waargenomen latentie voor lange antwoorden. Het laatste chunk in de stream bevat de volledige tokenverbruiksstatistieken voor dat verzoek. Je kunt deze metrieken loggen om je verbruik van vooruitbetaalde tegoeden nauwkeurig te volgen. Streamen is ideaal voor chatinterfaces en realtime-applicaties.

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)

Verwerk gedeeltelijke responsen door de contentdelta op te hopen. Onze API zorgt ervoor dat het totale tokenaantal overeenkomt met het daadwerkelijke verbruik. Fouten tijdens het streamen brengen je niet in rekening voor onvolledige tokens. Deze functie zorgt voor een soepele gebruikerservaring terwijl de kosten transparant blijven. Je kunt de stream vroegtijdig stoppen als de gebruiker de generatie onderbreekt.

Gebruik function calling en JSON-modus

Geef een tools-array op om functaanroepen mogelijk te maken. Het model geeft gestructureerde toolaanroepen weer wanneer gepast. U kunt ook JSON-modus afdwingen door response_format in te stellen op json_object. Dit garandeert dat de output geldige JSON is, wat het parseren in uw applicatie vereenvoudigt. Beide functies werken met de standaard OpenAI SDK-syntaxis.

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);

Definieer je funtieschema met naam, beschrijving en parameters. De API retourneert de functienaam en argumenten in het antwoord. Dit stelt je code in staat externe logica uit te voeren op basis van het besluit van het model. JSON-modus is nuttig wanneer je strikte gegevensstructuren nodig hebt. Combineer deze functies voor robuuste, geautomatiseerde workflows.

Configureer parameters: temperatuur, top_p en seed

Pas de temperatuur aan om willekeurigheid te regelen. Lagere waarden maken de antwoorden meer deterministisch. Top_p beperkt de nucleus sampling tot de meest waarschijnlijke tokens. Seed zorgt voor reproduceerbare outputs voor debugging. Deze parameters geven je fijne controle over het gedrag van het model. Gebruik ze om de balans tussen creativiteit en nauwkeurigheid af te stemmen.

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)

Stel presence_penalty en frequency_penalty in om herhaling te verminderen. Het model ondersteunt alle standaard OpenAI-parameters. Je kunt een stopvolgorde doorgeven om de generatie te stoppen bij specifieke markeringen. Deze besturingselementen helpen je de exacte uitvoerindeling te krijgen die je nodig hebt. Experimenteer met verschillende combinaties om de optimale instellingen voor jouw use case te vinden.

Limieten, fouten en contextvenster

Onze API ondersteunt een contextvenster van 100.000 tokens. De maximale output per request is 16.000 tokens, of 2.048 als je max_tokens weglaat. Je bent beperkt tot 300 requests per minuut en 8 gelijktijdige requests per key. De request body moet kleiner zijn dan 8 MB. Deze limieten zorgen voor eerlijk gebruik voor alle prepaid-klanten.

Afhandelen van HTTP 401-fouten door je API-sleutel te verifiëren. Een 402-fout geeft aan dat er onvoldoende vooruitbetaald krediet is. Laad op met crypto om de service te hervatten. Een 429-fout betekent dat je de limiet hebt overschreden. Wacht kort voordat je het opnieuw probeert. Ons systeem gebruikt geen prompts voor training, waardoor je gegevensprivacy behouden blijft. Fouten en weigeringen zijn gratis, dus je betaalt alleen voor succesvolle voltooiingen.