API mistral ai: guida rapida

URL Base e Autenticazione

Il primo passaggio consiste nel configurare il tuo client per puntare alla nostra infrastruttura. Sostituisci l'URL di base standard di OpenAI con HTTPS://api.apimistralai.com/v1 e inserisci la tua chiave API univoca nell'intestazione authorization. Questo semplice swap reindirizza tutte le richieste al nostro modello uncensored mantenendo intatta la logica di integrazione esistente.

• URL Base: HTTPS://api.apimistralai.com/v1
• Autenticazione: Token Bearer tramite il Authorization header

Assicurati che la tua chiave sia attiva nel dashboard del tuo account prima di testare le connessioni.

Prima richiesta

Invia una richiesta standard di completamento chat per verificare la connettività e la risposta del modello. Il seguente curl command targets the uncensored modello con un prompt di base.

Questo conferma che l'endpoint è raggiungibile e restituisce testo senza i filtri di contenuto standard.

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

Se la risposta contiene testo, la tua integrazione viene instradata con successo attraverso il nostro layer di inferenza uncensored.

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per interagire con la nostra API senza modificare la struttura della richiesta core. Inizializza il client con il nuovo URL di base e la tua chiave API, poi chiama chat.completions.create.

Questo approccio ti permette di mantenere tutta la logica Python esistente ottenendo al contempo l'accesso alle funzionalità del modello 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)

L'oggetto di risposta si comporta in modo identico alle risposte standard di OpenAI, rendendo la migrazione semplice per gli sviluppatori Python.

Integrazione SDK Node

Per ambienti JavaScript o TypeScript, inizializza il pacchetto OpenAI con l'URL di base personalizzato. Imposta il apiKey e baseURL proprietà prima di chiamare chat.completions.create.

Questo garantisce che le tue applicazioni Node.js instradino le richieste al nostro endpoint uncensored mantenendo la compatibilità con i pattern standard degli 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);

La struttura della risposta rimane coerente con gli standard OpenAI, consentendo una facile integrazione nei flussi di lavoro Node.js esistenti.

Risposte in streaming tramite SSE

Abilita la generazione dei token in tempo reale impostando stream: true nella tua richiesta. L'API restituisce uno stream di Server-Sent Events (SSE), permettendoti di elaborare i token man mano che generano.

Questo riduce la latenza percepita per gli utenti e fornisce feedback immediato durante le completazioni lunghe.

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)

Analizza il flusso di dati SSE per visualizzare i token in modo incrementale. L'ultimo chunk contiene l'utilizzo totale dei token per la richiesta.

Limiti, Errori e Contesto

Monitora il tuo utilizzo rispetto a rigorosi limiti di velocità e gestisci con grazia gli errori HTTP comuni. Hai diritto a 300 richieste al minuto e 8 richieste concorrenti per chiave.

Un errore 401 indica una chiave API non valida o mancata, mentre un errore 402 significa che il tuo credito prepagato è esaurito. Uno status 429 segnala che hai superato il limite di 300 richieste al minuto.

La tua finestra di contesto supporta 100.000 token in totale, con un output massimo di 16.000 token per richiesta. Errori e rifiuti non consumano credito, garantendo che paghi solo per il contenuto effettivo generato.