Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Generare una chiave API

Lezione 2 di 14 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Accesso programmatico a Grok
  2. Aprire la console
  3. Creare la tua prima chiave
  4. Migliori pratiche di gestione
  5. Fatturazione legata alle chiavi
  6. Testare subito la chiave
  7. Punti chiave

Accesso programmatico a Grok

Chiave API creata nella console xAI 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-local per il tuo ambiente di sviluppo
  • prod-backend per il tuo server di produzione
  • test-ci per 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/models prima di integrarla