URL Base e Autenticazione
Connettiti immediatamente puntando il tuo client al nostro URL di base e passando la tua chiave nell'intestazione. L'autenticazione è semplice: includi Authorization: Bearer YOUR_API_KEY con ogni richiesta. Ottieni la tua chiave istantaneamente dopo la registrazione con Google o email. Non è richiesto il numero di telefono e la chiave appare immediatamente sullo schermo. Questa configurazione funziona con qualsiasi SDK standard compatibile con OpenAI perché seguiamo la stessa struttura dell'interfaccia. Non è necessario gestire sessioni di accesso complesse o affrontare le scadenze delle sessioni che affliggono altre piattaforme. La tua chiave è l'unica credenziale necessaria per tutti gli endpoint. Questa semplicità significa che puoi integrare l'API nei tuoi script o applicazioni senza preoccuparti dei cicli di aggiornamento dei token o dei flussi OAuth. Il servizio è progettato per gli sviluppatori che desiderano un accesso diretto senza ostacoli burocratici. Forniamo un'interfaccia pulita e prevedibile che si comporta esattamente come lo standard del settore. Questo riduce significativamente i tempi di integrazione rispetto alla gestione di sistemi di accesso proprietari.
Endpoint Chat Completions
Invia messaggi al modello senza filtri utilizzando l'endpoint standard di completamento chat. L'endpoint accetta richieste POST a /v1/chat/completions con un corpo JSON contenente i tuoi messaggi. Devi specificare l'ID del modello come uncensored a utilizzare il nostro specifico modello linguistico di grandi dimensioni. Il sistema restituisce risposte testuali che puoi elaborare o visualizzare. Questa è un'API text-in, text-out senza capacità di generazione di immagini o audio. Controlli il tono e lo stile regolando parametri come la temperatura o il top_p. Il formato della risposta è coerente e prevedibile, rendendolo facile da analizzare in qualsiasi lingua. Puoi inviare più turni in una singola richiesta per mantenere la cronologia delle conversazioni. Questo approccio imita il comportamento dei principali provider offrendo però il nostro specifico modello uncensored. È la funzionalità principale per costruire chatbot, assistenti o generatori di contenuti. L'endpoint è ottimizzato per velocità e affidabilità.
Integrazione SDK Python
Integra rapidamente utilizzando l'SDK Python ufficiale con configurazione minima. Devi solo impostare l'URL di base e la chiave API nell'inizializzazione del client. Lo snippet di codice seguente mostra come creare una semplice richiesta di completamento della chat. Questo metodo funziona perfettamente con le codebase OpenAI esistenti perché l'interfaccia è identica. Puoi passare un elenco di messaggi con ruoli come system, user, o assistant. L'oggetto risposta ti dà accesso al testo generato e all'utilizzo dei token. Questo rende il debug e il monitoraggio della tua applicazione semplici. Non è necessario scrivere client HTTP personalizzati o gestire manualmente la serializzazione JSON. L'SDK gestisce tutto il lavoro pesante per te. Questo riduce il codice boilerplate e accelera significativamente i cicli di sviluppo. Puoi iniziare a prototipare in pochi minuti e scalare in seguito quando necessario. La libreria è ben documentata e attivamente mantenuta.
Integrazione SDK Node
Utilizza l'SDK Node.js per integrare l'API nei tuoi progetti JavaScript o TypeScript. La configurazione è simile a Python: configura l'URL di base e la chiave una volta. L'esempio di codice dimostra una semplice richiesta all'endpoint chat. Puoi utilizzare la stessa struttura dei messaggi di Python, garantendo coerenza nel tuo stack. L'oggetto di risposta fornisce il testo di completamento e le statistiche di utilizzo. Questo è utile per monitorare il consumo di token nelle tue applicazioni Node. L'SDK gestisce lo streaming e la gestione degli errori internamente, semplificando il tuo codice. Puoi integrarlo in route Express, funzioni serverless o job in background. L'interfaccia è familiare a chiunque abbia utilizzato la libreria Node di OpenAI. Questo significa che puoi riutilizzare logica e pattern esistenti senza imparare una nuova struttura API. Si integra naturalmente negli ecosistemi JavaScript moderni. Ottieni i vantaggi di un'interfaccia standardizzata con le nostre specifiche capacità del modello. Questo riduce il carico cognitivo quando si passa tra diverse parti della tua applicazione.
Risposte in streaming
Abilita l'output in tempo reale impostando il parametro stream su true nella tua richiesta. L'API restituisce uno stream di chunk invece di una singola risposta completa. Questo è ideale per le interfacce chat dove vuoi mostrare il testo man mano che viene generato. Ogni chunk contiene una risposta parziale, permettendoti di aggiornare l'interfaccia utente in modo incrementale. L'ultimo chunk include l'utilizzo totale dei token per la richiesta. Questa funzione funziona sia con gli SDK Python che Node con modifiche minime al codice. Gestisci lo stream iterando sugli chunk e aggiungendo il testo. Questo crea un'esperienza utente più fluida rispetto all'attesa della risposta completa. È particolarmente utile per la generazione di contenuti di lunga durata o per compiti di ragionamento complessi. La capacità di streaming è standard nelle API LLM moderne ed è completamente supportata qui. Puoi controllare il flusso gestendo il tasso di consumo dello stream. Questo ti dà un controllo fine su come l'output viene visualizzato all'utente.
Limiti, Errori e Contesto
La finestra di contesto supporta fino a 100.000 token per prompt e completamento combinati. Puoi inviare fino a 8 richieste concorrenti per chiave e 300 richieste al minuto. Se superi questi limiti, riceverai un errore di limite di frequenza 429. Gli errori di autenticazione restituiscono un codice di stato 401 se la tua chiave non è valida. Un codice di stato 402 indica che il tuo credito prepagato è esaurito. Puoi ricaricare con criptovalute in qualsiasi momento per riprendere il servizio. Gli errori non consumano il tuo credito, quindi le richieste fallite sono gratuite. L'output massimo per richiesta è di 16.000 token, o 2.048 se non specifichi un limite. I corpi delle richieste sono limitati a 8 MB. Questi limiti sono progettati per garantire un utilizzo equo e la stabilità del sistema. Puoi monitorare il tuo utilizzo tramite le intestazioni di risposta o gli oggetti SDK. Questa trasparenza ti aiuta a gestire il budget e a pianificare l'architettura della tua applicazione in modo efficace. Il modello prepagato significa che paghi solo ciò che usi, senza spese nascoste.
cURL
curl https://api.mistralapilogin.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix my token expiry error"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapilogin.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapilogin.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
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)