Mistral API: gestione dei 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 chiavi API per l'integrazione con AIsuru.
1. Registrazione su Mistral
Per iniziare a utilizzare Mistral AI Studio, devi creare un account sulla piattaforma:
Visita la console Mistral AI Studio e registrati;
Se ti registri con un indirizzo email, potresti doverlo verificare; controlla la posta in arrivo e fai clic sul link di conferma che Mistral ti invia per attivare il tuo account (un codice OTP o un link di accesso diretto);
Dopo la verifica, potrebbe esserti richiesto di fornire alcune informazioni aggiuntive, come 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 dominio della tua email corrisponde a quello di un'azienda già presente sulla piattaforma) e un workspace iniziale: assegna un nome alla tua organizzazione — ad esempio, il nome della tua azienda o un nome di progetto identificativo. Verrà creato automaticamente un workspace predefinito con lo stesso nome (che potrai rinominare in seguito, se necessario).
Una volta completata la registrazione, verrai indirizzato alla dashboard di Mistral AI Studio. Prima di utilizzare l'API, dovrai configurare la sezione 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, vai alle impostazioni della tua organizzazione;
Fai clic sul tuo nome o sull'icona profilo (in alto a destra) e seleziona Admin Settings dal menu: verrai reindirizzato alla Admin Console (sezione amministrativa) di Mistral;
Assicurati che la tua organizzazione sia selezionata (in alto a sinistra), quindi vai alla pagina Organization Settings;
Nella pagina delle impostazioni dell'organizzazione, inserisci i dati della tua azienda. In particolare:
Nome dell'organizzazione: la ragione sociale della tua azienda (di solito precompilata con il nome inserito durante la registrazione: aggiornala se necessario);
Indirizzo completo: inserisci l'indirizzo di fatturazione della tua azienda (via, citta, CAP, paese);
Partita IVA: se la tua azienda ha una partita IVA, dovresti trovare un campo Tax/VAT ID; inserisci la partita IVA della tua azienda incluso il prefisso del paese (ad es. IT12345678901 per un'azienda italiana);
Verifica che i dati 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 della tua azienda, dovrai aggiungere un metodo di pagamento valido per utilizzare i servizi Mistral:
Apri la Admin Console di Mistral e seleziona Billing dal menu amministrativo.
Aggiungi una carta di pagamento: se e la prima volta, vedrai un pulsante Add payment method o Complete setup; fai clic su di esso per avviare la procedura;
Si aprira un modulo sicuro in cui inserirai i dati della tua carta:
Numero della carta di credito o di debito;
Data di scadenza (formato MM/YY);
Codice CVV/CVC (3 o 4 cifre di sicurezza);
Completa la procedura confermando i dati: 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 applicati costi fissi immediati: pagherai solo per l'utilizzo effettivo dei servizi.
Come attivare l'autoricarica per le API di Mistral
Per impostare l'autoricarica:
Vai alla console di amministrazione di Mistral e fai clic su Billing nella barra laterale;
Accanto a "Auto Recharge", fai clic su Update;
Seleziona la casella "Enable auto recharge, automatically recharging my account whenever my balance falls below a defined threshold";
Inserisci i valori richiesti:
Top up my wallet with: l'importo (in Euro) da aggiungere al tuo saldo;
When my balance goes below: la soglia (in Euro) alla quale si attiva l'autoricarica;
Fai clic su "Enable auto recharge".
4. Attivazione della fatturazione: scelta di un piano
Mistral utilizza un modello API basato sul consumo. Dopo aver aggiunto un metodo di pagamento, devi abilitare il tuo account all'accesso alle API selezionando uno dei piani disponibili.
Mistral AI Studio ti consente di scegliere tra un piano gratuito e un piano a pagamento pay-as-you-go.
Dopo aver aggiunto la tua carta di pagamento, procedi come segue:
Vai alla sezione Limits della console di amministrazione;
Scegli un piano:
Experiment (Free) — un piano gratuito con limiti di utilizzo molto restrittivi e condivisione dei dati di utilizzo per l'addestramento di nuovi modelli; ideale per i test iniziali;
Scale (Pay-as-you-go) — un piano a consumo con limiti più elevati, adatto all'uso in produzione. Richiede l'inserimento dei dati di pagamento e comporterà addebiti in base all'utilizzo effettivo (per token/model, according to Mistral's pricing).
Dopo aver selezionato un piano, potrebbe esserti chiesto di verificare il tuo numero di telefono. Inserisci un numero valido, quindi inserisci il codice OTP ricevuto via SMS per confermare (questo passaggio consente a Mistral di verificare l'affidabilita del tuo account prima di sbloccare l'accesso a consumo).
Una volta completati questi passaggi, il tuo account verra assegnato al piano scelto!
5. Come monitorare i consumi e impostare limiti di spesa su Mistral AI Studio
Monitoraggio dei consumi
Puoi monitorare i consumi sia a livello di organizzazione sia di workspace.
Monitorare i consumi di un workspace di Mistral AI Studio
Vai a Mistral AI Studio e fai clic su "Workspace" nella barra laterale;
Assicurati che sia selezionato il workspace corretto (fai clic sul nome in alto a sinistra nel popup che si apre per cambiarlo);
Vai alla sezione "Usage" del popup;
Seleziona il mese (il mese corrente e selezionato per impostazione predefinita, ma puoi selezionare qualsiasi mese dalla creazione del workspace);
All'interno di questa sezione, puoi verificare:
Spesa totale (suddivisa in categorie: completion, OCR, connector, fine-tuning, audio, ecc.);
Costi giorno per giorno (totali e suddivisi per categoria);
Costo per categoria (per ogni categoria, vedrai solo i modelli effettivamente utilizzati durante il mese; altrimenti vedrai "Nessun utilizzo in [mese e anno]").
Monitorare l'utilizzo API a livello di organizzazione su Mistral AI Studio
Puoi visualizzare le stesse informazioni per l'intera organizzazione, aggregando tutti i workspace. Per farlo:
Vai alla console di amministrazione Mistral AI e fai clic su Usage nella barra laterale;
Come in precedenza, in questa pagina puoi selezionare il mese di riferimento e visualizzare una suddivisione di tutte le spese aggregate in diversi modi (per categoria, per categoria/giorno e per categoria/modello).
Come impostare un limite di spesa
I limiti di spesa possono essere impostati solo a livello di organizzazione, non per singolo workspace. Per impostarne uno:
Vai alla console di amministrazione Mistral AI e passa a Limits;
Nella prima sezione, (Organization limits), attiva l'interruttore "Monthly API spending limit";
In "Spending limit", inserisci il limite massimo di spesa mensile in euro e fai clic su "Update limit".
Sotto la sezione Spending limit, vedrai anche l'utilizzo del mese corrente rispetto al limite impostato.
6. Creazione di una chiave API
Per utilizzare i servizi Mistral con AIsuru, devi creare una chiave API Mistral:
In Mistral AI Studio, fai clic su API Keys nella barra laterale: il popup che si apre mostra le chiavi create nel tuo workspace;
Per creare una nuova chiave, fai clic su "Create new key":
Inserisci un nome descrittivo (opzionale, ma consigliato);
Imposta una data di scadenza per la chiave (opzionale);
Conferma facendo clic su "Create new key";
Fai clic su "Copy key" per copiare la chiave API appena creata e salvala in un luogo sicuro (viene mostrata una sola volta al momento della creazione).
Come gestire le chiavi API di Mistral AI Studio
Puoi gestire le tue chiavi direttamente dalla pagina delle chiavi API Mistral: qui vedrai una tabella con le chiavi attive e quelle scadute. Per ogni chiave, puoi visualizzare:
Nome: il nome descrittivo assegnato al momento della creazione della chiave;
Chiave: gli ultimi quattro caratteri della chiave per identificarla rapidamente;
Data di creazione;
Data di scadenza ("Never" se non impostata per quella chiave).
Se hai molte chiavi, puoi usare la barra di ricerca per trovarle in base al nome.
Come eliminare una chiave API Mistral
Per eliminare una chiave:
Fai clic sull'icona del cestino (ultima colonna);
Fai clic su Confirm (che apparirà al posto dell'icona del cestino).
7. Gestione dei workspace
Mistral ti consente di organizzare l'utilizzo in diversi workspaces, simili ai progetti di altre piattaforme. Questo è utile per separare attività, team o clienti all'interno della stessa organizzazione, offrendoti maggiore controllo e ordine.
Quando crei il tuo account, vengono creati automaticamente un'organizzazione predefinita e un workspace associato.
Creando workspace aggiuntivi, puoi separare l'utilizzo per progetto, reparto interno o cliente. Ogni workspace mantiene chiavi API, impostazioni e membri isolati, consentendoti di gestire accessi e limiti in modo granulare all'interno della stessa organizzazione.
Nota: puoi gestire più workspace nella stessa organizzazione: ciascuno avrà le proprie impostazioni indipendenti (chiavi API, membri, report sui consumi).
Se hai un solo progetto, puoi semplicemente utilizzare il workspace predefinito.
Creazione di un nuovo workspace
Per creare nuovi workspace, devi disporre dell'accesso amministratore alla console amministrativa di Mistral:
Fai clic su Workspaces nella barra laterale (qui vengono mostrati tutti i tuoi workspace), quindi fai clic sul pulsante New workspace.
Nel menu che si apre:
Seleziona un'icona (un'emoji tra quelle disponibili);
Inserisci un nome;
Scrivi una breve descrizione (facoltativa);
Se utile, attiva "Add all existing organization members to this workspace";
Infine, fai clic su "Create".
Nota: puoi solo archiviare (non eliminare) i workspace di Mistral AI Studio.
8. Gestione dei membri dell'organizzazione e dei ruoli
Se lavori in team, puoi invitare colleghi nel tuo workspace Mistral e assegnare loro ruoli diversi con permessi appropriati.
Per aggiungere un nuovo membro al tuo workspace, devi prima invitarlo nella tua organizzazione:
Vai alla console amministrativa di Mistral e fai clic su Members nella barra laterale;
Fai clic sul pulsante Invite members e, nel popup visualizzato:
Inserisci l'email del membro del team (puoi inserire piu indirizzi separati da virgole);
Seleziona un ruolo:
Admin: accesso completo all'organizzazione e ai workspace; puo gestire impostazioni, membri, fatturazione e dispone di tutti i privilegi degli altri ruoli.
Billing: accesso alle informazioni di fatturazione e ai pagamenti; puo visualizzare e modificare i dati di fatturazione, gestire i metodi di pagamento e visualizzare le fatture.
Member: ruolo base con accesso limitato; puo utilizzare l'API e visualizzare le proprie risorse, ma non puo creare chiavi API ne modificare impostazioni critiche.
Dopo la conferma, il sistema inviera un'email con un link di invito agli indirizzi specificati. Finche l'invito non viene accettato, il membro apparira come "pending" nell'elenco dei membri.
A seconda del ruolo scelto, potrebbe essere necessario invitare il membro del team anche nei singoli workspace. Per farlo:
Vai a Mistral AI Studio e fai clic su Workspace nella barra laterale;
Seleziona il workspace su cui vuoi lavorare: fai clic sul nome del workspace in alto a sinistra nel popup per passare a un altro;
Vai a Members e fai clic su Add Members:
Seleziona dal menu a discesa il membro dell'organizzazione da aggiungere al workspace;
Specifica il ruolo (l'impostazione predefinita è "Member", ma puoi selezionare anche "Admin");
Infine, fai clic su "Add Member" per confermare.
In qualsiasi momento, puoi rimuovere membri dall'organizzazione (dalla console di amministrazione Mistral) o dai singoli workspace (all'interno di Mistral AI Studio).
9. Limiti di frequenza per i modelli API Mistral
Come tutti i provider di IA generativa, Mistral ha limiti di utilizzo che possono variare in base all'utilizzo e alla spesa totali della tua organizzazione (oppure, per utilizzi ad alto volume, in base agli accordi commerciali con Mistral AI).
Puoi controllare i limiti di frequenza nella console di amministrazione Mistral (non all'interno di Mistral AI Studio):
Vai alla sezione Limits della console di amministrazione Mistral;
Oltre a controllare i consumi e i limiti di spesa mensili, scorrendo verso il basso troverai altre tre sezioni:
Rate limit per second: il limite di richieste che puoi effettuare al secondo. Per semplificare: 1 richiesta = 1 messaggio, anche se in pratica un singolo messaggio su AIsuru può consumare fino a 10 richieste.
Completion rate limits per model: qui troverai i diversi modelli (filtrabili con la barra di ricerca) che Mistral mette a disposizione. Per ogni modello, vedrai:
Tokens per Minute (TPM): il numero massimo di token al minuto che Mistral mette a disposizione della tua organizzazione per quello specifico modello.
Tokens per Month: il numero massimo di token mensili che Mistral mette a disposizione della tua organizzazione per quello specifico modello.
Fine-tuning limits: limiti specifici per le attività di fine-tuning all'interno di Mistral AI Studio. I modelli Mistral sottoposti a fine-tuning possono poi essere utilizzati su AIsuru.
Come aumentare i limiti di frequenza per i modelli API Mistral
Puoi richiedere un aumento dei limiti di utilizzo dei modelli Mistral AI contattando direttamente il supporto commerciale di Mistral. Puoi farlo andando alla sezione Contattaci su Mistral AI.
Prossimi passi
Dopo aver completato la configurazione della console Mistral AI:
Copia la chiave API che hai creato;
Accedi alla dashboard di AIsuru;
Utilizza la chiave API per creare un nuovo modello sulla piattaforma.
Ultimo aggiornamento