Mistral API: come gestire i modelli AI Studio
Questa guida illustra il processo completo per creare un account Mistral, configurare la fatturazione (dati aziendali e metodo di pagamento), gestire i limiti di spesa e creare le chiavi API per l'integrazione con AIsuru.
1. Registrazione su Mistral
Per iniziare a usare Mistral AI Studio, è necessario creare un account sulla piattaforma:
Visita la console Mistral AI Studio e registrati;
Se ti registri con un indirizzo email, potrebbe essere richiesta una verifica; controlla la tua posta in arrivo e clicca sul link di conferma che Mistral ti invia per attivare l'account (un codice OTP o un link per effettuare direttamente il sign in);
Dopo la verifica, ti potrebbe essere richiesto di inserire alcune informazioni aggiuntive, ad esempio il tuo nome completo e l'accettazione dei termini di servizio;
Mistral ti chiederà di creare un’organizzazione (o di unirti a una esistente, se il tuo dominio email corrisponde a un’azienda già presente) e un workspace iniziale: assegna un nome alla tua organizzazione - ad esempio il nome della tua azienda o un nome progetto identificativo. Dopodiché verrà creato automaticamente un workspace predefinito con lo stesso nome (che potrai modificare in seguito se necessario).
Al termine della registrazione verrai indirizzato alla dashboard di Mistral AI Studio. Prima di utilizzare l’API, dovremo configurare la sezione di fatturazione del tuo account.
2. Inserimento dei dati di fatturazione aziendali
Per una corretta fatturazione è importante inserire i dati della tua azienda, inclusa la Partita IVA:
Nella console Mistral AI Studio, accedi alle impostazioni della tua organizzazione;
Clicca sul tuo nome o sull’icona profilo (in alto a destra) e seleziona Admin Settings dal menu: verrai reindirizzato all’Admin Console di Mistral (sezione amministrativa);
Assicurati di aver selezionato la tua organizzazione (in alto a sinistra) e poi vai alla pagina Organization Settings;
Nella pagina di impostazioni dell'organizzazione, inserisci i dati della tua azienda. In particolare:
Nome dell'organizzazione: il nome legale della tua azienda (di solito è precompilato con il nome inserito in fase di registrazione, modificalo se necessario);
Indirizzo completo: inserisci l’indirizzo di fatturazione della sede aziendale (via, città, CAP, paese);
Partita IVA: se la tua azienda ha una VAT, dovresti trovare un campo per il Tax/VAT ID; inserisci la Partita IVA aziendale comprensiva del prefisso nazionale (esempio: IT12345678901 per un'azienda italiana);
Verifica che siano corretti e salva le modifiche.
Nota: queste informazioni verranno utilizzate per emettere fatture fiscali corrette per i consumi del tuo account Mistral.
3. Aggiunta di un metodo di pagamento
Una volta configurati i dati aziendali, dovrai aggiungere un metodo di pagamento valido per poter utilizzare i servizi Mistral:
Apri l’Admin Console di Mistral e, nel menu amministrativo, seleziona Billing.
Aggiungi una carta di pagamento: se è la prima configurazione, vedrai un pulsante Add payment method oppure Complete setup; cliccalo per iniziare la procedura di aggiunta di un metodo di pagamento;
Si aprirà un modulo sicuro in cui inserire i dati della tua carta aziendale:
Numero della carta di credito o debito;
Data di scadenza (formato MM/AA);
Codice CVV/CVC (le 3 o 4 cifre di sicurezza);
Completa la procedura confermando i dati inseriti: una volta aggiunta, la carta verrà collegata al tuo account Mistral per i futuri addebiti.
Nota: attualmente sono accettate solo carte di credito o debito. Non verranno addebitati costi fissi immediati - pagherai solo per l'utilizzo effettivo dei servizi.
Come attivare l'autoricarica per le API di Mistral
Per impostare l'autoricarica:
Accedi all'admin console di Mistral e premi su Billing nella colonna laterale;
Alla voce "Auto Recharge" premi sul tasto Update;
Abilita la checkbox "Enable auto recharge, automatically recharging my account whenever my balance falls below a defined threshold";
Inserisci i valori richiesti:
Top up my wallet with: ricarica il conto di una certa cifra (in Euro);
When my balance goes below: effettua la ricarica quando il saldo scende sotto una certa cifra (sempre in Euro);
Clicca sul pulsante "Enable auto recharge".
4. Attivazione della fatturazione: scelta di un piano
Mistral offre un modello di utilizzo dell’API basato su piani a consumo. Dopo aver aggiunto un metodo di pagamento, è necessario abilitare l'account all'uso dell'API selezionando uno dei piani disponibili.
La piattaforma Mistral AI Studio permette di scegliere se attivare un piano gratuito o uno a pagamento pay-as-you-go.
In questo scenario, dopo aver aggiunto la carta di pagamento, procedi così:
Vai alla sezione Limits dell'admin console;
Qui puoi scegliere il piano:
Experiment (Free) - un piano gratuito con limiti di utilizzo molto restrittivi e condivisione dei dati di utilizzo per il training di nuovi modelli; è ideale per test iniziali;
Scale (Pay-as-you-go) - un piano a consumo con limiti più elevati, adatto all'uso in produzione. Richiede di aver fornito i dettagli di pagamento e comporterà addebiti in base all'utilizzo effettivo (per token/modello, secondo il pricing di Mistral).
Dopo aver selezionato il piano, potrebbe esserti chiesto di verificare il tuo numero di telefono. Inserisci un numero valido e poi il codice OTP ricevuto via SMS per confermare (questo passaggio serve a Mistral per verificare l’affidabilità dell’account prima di sbloccare l’accesso a consumo).
Una volta completati questi passaggi, il tuo account sarà assegnato al piano scelto!
5. Come monitorare l'utilizzo e impostare limiti di spesa su Mistral AI Studio
Monitoraggio dei consumi
Puoi monitorare i consumi a livello di organizzazione e di workspace.
Monitorare i consumi di uno workspace di Mistral AI Studio
Accedi a Mistral AI Studio e clicca su "Workspace" nella barra laterale;
Assicurati di aver selezionato il workspace corretto (premi sul nome in alto a sinistra nel popup che si è aperto per cambiarlo);
Vai alla sezione "Usage" del popup;
Seleziona il mese (di default sarà selezionato il mese corrente, puoi selezionare qualsiasi mese a partire dalla data di creazione del workspace);
All'interno di questa sezione, puoi controllare:
Spesa totale (divisa in diverse categorie: completion, OCR, connectors, fine tuning, audio, ecc.);
Il costo giorno per giorno (totale e diviso nelle diverse categorie);
Il costo di ogni categoria (per ogni categoria, vedrai solo i modelli effettivamente utilizzati durante il mese, altrimenti vedrai la scritta "No usage in [mese e anno]").
Monitorare i consumi API dell'organizzazione di Mistral AI Studio
Puoi vedere le stesse informazioni per l'intera organizzazione - aggregando, quindi, tutti gli workspace. Per farlo:
Accedi alla console admin di Mistral AI e poi premi su Usage nella barra laterale;
Come prima, all'interno di questa pagina potrai selezionare il mese di riferimento e vedere il dettaglio di tutte le spese aggregate in maniera diversa (per categoria, per categoria/giorno e per categoria/modello).
Come impostare un limite di spesa
Puoi impostare un limite di spesa solo a livello di organizzazione, non di workspace. Per impostarlo:
Accedi all'admin console di Mistral AI e vai alla sezione Limits;
All'interno della prima sezione (Organization limits) attiva il toggle "Monthly API spending limit";
Alla voce "Spending limit" inserisci il limite mensile di spesa in Euro e premi sul tasto "Update limit".
Al di sotto della sezione Spending limit troverai anche l'utilizzo del mese corrente rispetto al limite di spesa impostato.
6. Creazione di una chiave API
Per utilizzare i servizi Mistral con AIsuru, è necessario creare una chiave API Mistral:
Nell’AI Studio di Mistral, nella barra laterale, clicca su API Keys: nel popup che si apre, vedrai le chiavi create all'interno del tuo workspace;
Per creare una nuova chiave, premi su "Create new key":
Inserisci un nome descrittivo (opzionale, ma consigliato);
Inserisci una data di scadenza per la tua chiave (opzionale);
Conferma tutto premendo su "Create new key";
Premi su "Copy key" per copiare la chiave API appena creata e conservala (viene mostrata solo una volta al momento della creazione).
Come gestire le chiavi API di Mistral AI Studio
Puoi gestire le tue chiavi direttamente dalla pagina relative alle chiavi API Mistral: al suo interno, infatti, puoi vedere una tabella contenente le chiavi attive e quelle scadute. Per ogni chiave, puoi vedere:
Nome: il nome descrittivo fornito in fase di creazione della chiave;
Chiave: le quattro lettere finali della chiave per una rapida identificazione;
Data di creazione;
Data di scadenza ("Never" se non impostata per quella chiave).
Se hai molte chiavi, puoi usare la barra di ricerca per ricercarle in base al nome.
Come cancellare una chiave API Mistral
Se, invece, vuoi cancellare una chiave, ti basterà:
Premere sull'icona del cestino (ultima colonna);
Premere su Confirm (comparirà al posto del cestino).
7. Gestione dei Workspaces (spazi di lavoro)
Mistral consente di organizzare l’utilizzo in diversi workspaces (spazi di lavoro), analogamente ai progetti di altre piattaforme. Ciò è utile per separare attività, team o clienti all’interno della stessa organizzazione, garantendo maggiore controllo e ordine.
Al momento della creazione dell'account viene generata una Organizzazione di default e un workspace associato.
Creando workspaces aggiuntivi, puoi ad esempio separare l’utilizzo per progetti diversi, dipartimenti interni o clienti. Ogni workspace mantiene chiavi API, impostazioni e membri isolati dagli altri, permettendoti di gestire accessi e limiti in modo granulare all’interno della stessa organizzazione.
Nota: è possibile gestire più workspace sotto la stessa organizzazione - ciascuno avrà le proprie impostazioni indipendenti (chiavi API, membri, report di consumi).
Se hai un solo progetto, potresti utilizzare soltanto il workspace predefinito.
Creare un nuovo Workspace
Per creare nuovi workspace è necessario accedere, come admin alla console admin di Mistral:
Clicca su Workspaces nella colonna laterale (da qui vedi tutti i tuoi workspace) e poi sul pulsante New workspace.
Nel menu che si apre:
Seleziona un'icona (corrispondente ad un'emoji tra quelle disponibili);
Inserisci un nome;
Scrivi una breve descrizione (opzionale);
Se utile, attiva la checkbox "Add all existing organization members to this workspace";
Infine, premi su "Create".
8. Gestione dei membri dell’organizzazione e dei ruoli
Se lavori in team, puoi invitare colleghi all’interno del tuo workspace Mistral e assegnare loro ruoli differenti con permessi adeguati.
Per aggiungere un nuovo membro nel tuo workspace, dovrai prima di tutto invitarlo all'interno della tua organizzazione:
Vai alla console admin di Mistral e premi su Members nella colonna laterale;
Premi sul pulsante Invite members e nel popup che compare:
Scrivi l'email del membro del team (puoi anche scrivere più indirizzi separandoli con una virgola);
Seleziona il ruolo:
Admin: accesso completo all’organizzazione e ai workspaces; può gestire impostazioni, membri, fatturazione e ha tutti i privilegi degli altri ruoli.
Billing: accesso alle informazioni di fatturazione e ai pagamenti; può visualizzare ed editare i dati di billing, gestire i metodi di pagamento e vedere le fatture.
Member: ruolo base con accesso limitato; può utilizzare l’API e vedere le proprie risorse, ma non può creare chiavi API né modificare impostazioni critiche.
Dopo aver confermato, il sistema invierà agli indirizzi specificati un’email con il link per accettare l’invito e unirsi al workspace. Fino a quando l’invito non viene accettato, il membro apparirà nello stato "pending" nell’elenco dei membri.
In base al ruolo scelto, potrebbe essere necessario invitare il membro del team anche nei singoli workspace. Per farlo:
Accedi all'AI Studio di Mistral e premi sulla voce Workspace nella barra laterale;
Seleziona il workspace su cui vuoi lavorare: premi sul nome del workspace in alto a sinistra nel popup che si è aperto per cambiarlo;
Vai alla voce Members e clicca su Add Members:
Seleziona il membro dell'organizzazione da aggiungere al workspace dal menu a tendina;
Specifica il ruolo (di default è "Member", ma puoi selezionare anche "Admin");
Infine, clicca sul pulsante "Add Member" per confermare.
In qualsiasi momento, puoi rimuovere i singoli membri dall'organizzazione (dall'admin console di Mistral) o dai singoli workspace (all'interno di Mistral AI Studio).
9. Limiti di utilizzo (rate limits) dei modelli Mistral API
Come tutti i provider di AI generativa, anche Mistral prevede dei limiti di utilizzo che possono variare in base all'utilizzo e alla spesa totale dell'organizzazione (o, in caso di forte utilizzo, anche in base agli accordi commerciali con Mistral AI).
Puoi controllare i rate limits all'interno dell'admin console di Mistral (non dentro Mistral AI Studio):
Accedi alla sezione Limits della console admin di Mistral;
Oltre a poter controllare i consumi e il limite di spesa mensile, scendendo più sotto puoi vedere altre tre sezioni:
Rate limit per second: è il limite di richieste che puoi fare in un secondo. Per semplificare, possiamo dire che 1 richiesta = 1 messaggio, ma in realtà un messaggio su AIsuru potrebbe consumare fino a 10 richieste.
Completion rate limits per model: in questa sezione, trovi i diversi modelli (che puoi filtrare con la barra di ricerca) che Mistral mette a disposizione. Per ogni modello, troverai:
Tokens per Minute (TPM): il numero massimo di token al minuto che Mistral mette a disposizione per la tua organizzazione per quello specifico modello.
Tokens per Month: il numero massimo di token mensili che Mistral mette a disposizione per la tua organizzazione per quello specifico modello.
Fine-tuning limits: sono i limiti specifici per le attività di fine tuning all'interno di Mistral AI Studio. I modelli fine-tuned di Mistral possono, poi, essere utilizzati su AIsuru.
Come aumentare i rate limits di modelli Mistral API
Puoi chiedere un aumento dei limiti di utilizzo dei modelli Mistral AI contattando direttamente il supporto commerciale di Mistral. Puoi farlo andando nella sezione Contact us di Mistral AI.
Prossimi passi
Dopo aver completato la configurazione della tua console Mistral AI:
Copia la chiave API creata;
Accedi alla tua dashboard AIsuru;
Utilizza la chiave API per creare un nuovo modello in piattaforma.
Last updated