API-dokumentation
Klistra in din befintliga OpenAI-kompatibla kod i vår endpoint. Denna guide visar hur du ansluter, autentiserar och streamar svar med noll konfigurationsöverhead.
Autentisering & bas-URL
Börja med att peka din klient mot rätt bas-URL. Vi accepterar standard OpenAI-huvuden för kompatibilitet. Din API-nyckel placeras i Authorization-huvudet som en bearer-token. Skicka den direkt från dina miljövariabler för att undvika att hårdkoda hemligheter. Denna konfiguration fungerar med alla bibliotek som stöder OpenAI-protokollet.
Första förfrågan
Skicka en enkel chatcompletion för att verifiera anslutning och svarskvalitet. Använd modell-ID:t "uncensored" för textgenerering. Slutpunkten returnerar standard JSON med val och användningsstatistik. Om du får 401, kontrollera ditt nyckelformat. En 402 indikerar otillräckligt förbetalt saldo. Detta snabba test bekräftar att din integration är redo för produktions trafik.
curl 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"}]
}'
Python SDK-integration
Konfigurera OpenAI Python-paketet att använda vår bas-URL. Ange API-nyckel och modellnamn explicit. Skicka dina meddelanden som en lista med ordlistor med nycklarna role och content. Svarsobjektet innehåller den genererade texten i choices[0].message.content. Hantera undantag på ett smidigt sätt för att fånga nätverks- eller hastighetsbegränsningsfel under körning.
from 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)
Node.js SDK-installation
Initiera OpenAI-klienten med din bas-URL och nyckel. Definiera messages-arrayen med användar- och assistentroller. Anropa chat.completions.create med uncensored-modellen. Svaret innehåller den genererade texten i det första valet. Använd detta mönster för både synkrona och asynkrona anrop i dina Node-applikationer.
import 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);
Strömningsresponser
Aktivera strömning genom att ställa in stream till true. API:et skickar datachunkar när de genereras. Varje chunk innehåller deltext som du kan lägga till i en buffert. Detta tillvägagångssätt minskar upplevd latens för långa utdata. Övervaka tokenanvändning i den sista chunken för att spåra fakturering noggrant.
stream = 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)
Begränsningar & Kontextruta
Ditt konto stöder ett kontextfönster på 100,000 token. Maximalt svar är 16,000 token per förfrågan. Du kan skicka 300 förfrågningar per minut. Endast 8 förfrågningar körs samtidigt. Förfrågningar med en kropp över 8 MB kommer att misslyckas. Använd dessa gränser för att utforma din retry-logik. Fel som 429 indikerar att hastighetsbegränsningen har träffats. Avvisningar förbrukar inte kredit.
Vanliga frågor
Vad är mistral bas-URL för detta API?
Använd HTTPS://api.mistralbaseurl.com/v1 som din bas-URL. Den fungerar med alla OpenAI-kompatibla SDK:er. Pek din klient dit och ange modellen till uncensored.
Hur hanterar jag 429-fel för hastighetsbegränsning?
Du får en 429 när du överskrider 300 begäranden per minut. Implementera exponentiell backoff i din klient. Försök igen efter fördröjningsperioden som anges i retry-after-huvudet.
Stöder den icke-censurerade modellen streaming?
Ja, ange stream till true i din begäran. API:et skickar Server-Sent Events med token-deltata. Parsa dessa chunkar för att uppdatera ditt gränssnitt i realtid utan att vänta på fullständig komplettering.
Skaffa din API-nyckel nu
Registrera dig, hämta din nyckel och uppdatera bas-URL:en. Det är allt.