Guida rapida per gli utenti di Mistral

URL di base e autenticazione

La nostra API è pienamente compatibile con gli SDK di OpenAI. Devi solo aggiornare l'URL di base e fornire la tua chiave API. L'URL di base per questo servizio è https://api.mistralapi.com/v1. L'autenticazione avviene tramite l'intestazione Authorization utilizzando un token Bearer. A differenza di alcuni provider, non richiediamo routing complesso o intestazioni specifiche del fornitore; passa semplicemente la tua chiave come faresti di solito.

• URL di base: https://api.mistralapi.com/v1
• Intestazione: Authorization: Bearer YOUR_API_KEY

La tua chiave API viene generata immediatamente dopo la registrazione. Tienila al sicuro, poiché garantisce l'accesso al tuo credito prepagato. Non ci sono canoni mensili, solo prezzi a consumo basati sull'utilizzo dei token.

Endpoint Chat Completions

Il cuore della nostra API è l'endpoint POST /v1/chat/completions. Accetta un elenco di messaggi e restituisce una risposta generata. Questo endpoint supporta il formato dei messaggi standard utilizzato dalla maggior parte dei client LLM. Devi specificare l'ID del modello come "uncensored". Questo modello è un modello linguistico di grandi dimensioni a pesi aperti ospitato sui nostri server, ottimizzato per rispondere senza rifiuti di contenuto per un uso adulto legale.

• Endpoint: POST /v1/chat/completions
• ID modello: uncensored

L'API restituisce solo risposte testuali. Non supporta immagini, audio, video o embedding. Per la maggior parte degli sviluppatori, questo endpoint sostituisce l'endpoint chat standard di OpenAI senza modifiche al codice oltre all'URL di base e all'ID del modello.

Integrazione SDK Python

L'utilizzo della libreria ufficiale OpenAI Python è il modo più veloce per integrare. Imposta l'URL di base sul nostro endpoint e fornisci la tua chiave API. Il codice sottostante mostra una semplice richiesta di completamento del testo.

• Installa la libreria: pip install openai
• Imposta base_url su https://api.mistralapi.com/v1
• Usa model="uncensored"

Questo approccio funziona perché la nostra API rispecchia la struttura di risposta di OpenAI. Puoi utilizzare librerie esistenti per lo streaming, la chiamata di funzioni e la modalità JSON senza modifiche.

Integrazione SDK Node.js

Per gli sviluppatori JavaScript/TypeScript, il pacchetto npm openai funziona senza problemi. Configura il client con il nostro URL base e la tua chiave API. Questo ti permette di utilizzare lo stesso codice sorgente sia per OpenAI che per il nostro modello senza censura.

• Installa la libreria: npm install openai
• Configura baseUrl su https://api.mistralapi.com/v1
• Specifica model: "uncensored"

Questa compatibilità si estende a tutti i parametri standard come temperature, top_p e le sequenze stop. Puoi passare facilmente tra i provider modificando la configurazione del client.

Risposte in streaming

Supportiamo le risposte in streaming tramite Server-Sent Events (SSE). Questo ti permette di ricevere i token man mano che vengono generati, riducendo la latenza percepita per gli utenti. L'ultimo chunk dello streaming include le statistiche sull'utilizzo dei token per il fatturato.

• Imposta stream: true nella tua richiesta
• Leggi i frammenti dalla risposta
• Analizza l'ultimo frammento per i dati di utilizzo

Lo streaming è ideale per le interfacce chat e le applicazioni in tempo reale. Il formato della risposta corrisponde allo standard di streaming di OpenAI, quindi la tua logica di streaming esistente funzionerà senza modifiche.

Limiti, errori e finestra di contesto

La nostra API ha limiti specifici per garantire la stabilità. Ogni chiave API supporta 300 richieste al minuto e 8 richieste concorrenti. La dimensione massima del corpo della richiesta è 8 MB. La finestra di contesto è di 100.000 token in totale (prompt + completamento). Se non imposti max_tokens, l'output predefinito è 2.048 token; in caso contrario, l'output massimo è 32.000 token.

• 401: Chiave API non valida
• 402: Credito insufficiente
• 429: Limite di richieste superato

Il credito premium non scade mai. Errori e rifiuti sono gratuiti. Se riscontri problemi, utilizza la pagina Supporto per rimborsi o assistenza all'account.

cURL

Copiacurl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copiafrom openai import OpenAI

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

Copiaimport OpenAI from "openai";

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

Streaming

Copiastream = 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)