Generare una chiave API
In questa pagina
Accesso programmatico a Grok
La chiave API è il token di autenticazione che permette alle tue applicazioni di comunicare con i modelli Grok. Senza di essa, nessuna richiesta viene elaborata. Questa lezione ti guida nella creazione e nella gestione delle tue chiavi nella console xAI.
Aprire la console
Vai su console.x.ai ed effettua il login con l’account creato nel passaggio precedente. La console è la tua dashboard centrale per gestire le chiavi, monitorare l’utilizzo e configurare la fatturazione.
Nel menu laterale, apri API Keys (percorso completo: console.x.ai/team/default/api-keys).
Creare la tua prima chiave
Clicca su Create API Key. Puoi assegnare a ogni chiave un nome descrittivo per identificarne lo scopo:
dev-localper il tuo ambiente di sviluppoprod-backendper il tuo server di produzionetest-ciper la tua pipeline di integrazione continua
La chiave viene mostrata una sola volta, al momento della creazione. Copiala immediatamente e conservala in un luogo sicuro (un gestore di password o un vault per segreti). Se perdi una chiave, dovrai generarne una nuova.
Formato della chiave
Le chiavi API xAI iniziano con il prefisso xai- seguito da una stringa alfanumerica. Questo prefisso ti aiuta a individuarle rapidamente nei file di configurazione e a rilevarle se vengono esposte accidentalmente nel codice sorgente.
Migliori pratiche di gestione
Una chiave per ambiente
Crea chiavi separate per ogni contesto. Se una chiave viene compromessa, puoi revocarla senza influenzare gli altri ambienti.
Rotazione regolare
Rinnova le tue chiavi periodicamente, specialmente per gli ambienti di produzione. La procedura è semplice: crea una nuova chiave, aggiorna la tua applicazione, quindi elimina quella vecchia.
Verifica prima di condividere
Prima di condividere un progetto, assicurati che nessuna chiave sia codificata direttamente nel sorgente. Utilizza file .env mantenuti fuori dal controllo versione (aggiungi .env al tuo .gitignore).
Fatturazione legata alle chiavi
Ogni chiamata API effettuata con una chiave viene conteggiata e fatturata. xAI offre due modalità:
- Crediti prepagati: acquisti i crediti in anticipo e le chiamate vengono scalate immediatamente
- Fatturazione mensile: l’utilizzo eccedente i tuoi crediti viene fatturato alla fine del mese
Controlla le informazioni di fatturazione nella console prima di iniziare a utilizzare l’API, poiché le fatture non possono essere modificate retroattivamente.
Testare subito la chiave
Prenditi trenta secondi per validare la chiave prima di integrarla in un progetto. Il test più semplice richiede l’elenco dei modelli:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Una risposta JSON che elenca i modelli conferma che la chiave è attiva e che la fatturazione è corretta. Un errore 401 indica che la chiave è stata copiata in modo errato; un 403 segnala un problema di permessi o di crediti. Diagnosticare il problema qui, alla fonte, ti risparmia una sessione di debug successiva nel mezzo del codice della tua applicazione.
Punti chiave
- Crei le chiavi su console.x.ai/team/default/api-keys
- Iniziano con
xai-e vengono mostrate una sola volta - Crea una chiave per ambiente e conservale in un vault per segreti
- Verifica la tua modalità di fatturazione prima di qualsiasi chiamata API
- Valida ogni nuova chiave con una chiamata a
/v1/modelsprima di integrarla