# Chiave IA

## BYOK

I clienti AIsh.li con [il nostro piano Enterprise](/pricing) possono portare la propria chiave (Bring Your Own Key – BYOK):

1. Genera la tua _chiave API Gemini_ sulla pagina [Chiavi API di Google AI Studio](https://aistudio.google.com/api-keys).
1. Vai alla pagina _[Segreti](/secrets)_ sul sito di AIsh.li.
1. Inserisci un nuovo segreto con `GEMINI_API_KEY` come ID segreto e incolla la tua chiave API Gemini come _Valore segreto_.

I tuoi agenti AIsh.li eseguiranno ora le richieste ai modelli tramite le tue credenziali Google, senza consumare i crediti AIsh.li.

> [!NOTE]
> Questa configurazione riguarda la tua chiave API Gemini esterna di Google AI Studio. È del tutto distinta dalla tua [chiave API AIsh.li](api-key.md), che serve per autenticarsi presso le API della piattaforma AIsh.li.

## Livello gratuito {#free}

Google AI Studio offre un livello gratuito (_Free Tier_) per accedere all'API Gemini.

Questo livello è concepito da Google principalmente per la sperimentazione iniziale, la prototipazione e la valutazione personale.

**Limitazioni importanti e considerazioni sulla privacy:**

- **Uso dei dati & revisione umana**: In base ai termini del livello gratuito di Google, Google può registrare, esaminare (anche tramite revisori umani) e utilizzare sia i prompt (input) che le risposte generate (output) per addestrare e migliorare i propri prodotti e modelli di machine learning.
- **Limiti di frequenza (Rate Limits)**: Le chiavi del livello gratuito sono soggette a rigide limitazioni su richieste al minuto (RPM), token al minuto (TPM) e richieste giornaliere (RPD).
- **Rischio di conformità & privacy**: Se i tuoi agenti elaborano dati riservati, proprietari o personali (ad esempio tramite widget di chat incorporati su siti pubblici), l'uso di una chiave gratuita potrebbe violare le tue policy sulla privacy o gli obblighi normativi (come il GDPR), a causa delle clausole di addestramento e revisione umana di Google.

## Livello a pagamento (Consigliato per la produzione)

Per l'utilizzo in ambienti di produzione e contesti aziendali, consigliamo vivamente di attivare la fatturazione in Google AI Studio (o Google Cloud) per passare la chiave API Gemini a un **livello a pagamento** (_Paid Tier_):

- **Privacy aziendale & Zero Training**: L'uso commerciale a pagamento è regolato dai termini commerciali di Google Cloud, che vietano a Google di utilizzare prompt o risposte per l'addestramento dei modelli di IA ed escludono l'accesso di revisori umani ai tuoi dati.
- **Maggiore capacità & affidabilità**: Rimuove i limiti giornalieri di richieste e fornisce soglie RPM e TPM notevolmente superiori.
- **Conformità commerciale**: Ti consente di utilizzare con sicurezza e nel pieno rispetto delle normative AIsh.li con una chiave BYOK per i tuoi agenti in produzione e per i widget di chat aperti al pubblico.