# Gemini API: errori di restrizione regionale, piano gratuito e autorizzazioni della chiave API

> Come distinguere 403 Access Restricted, 400 FAILED_PRECONDITION e 403 PERMISSION_DENIED dal testo dell’errore e dalle condizioni applicabili.

Source: https://ailoot.ai/blog/it/gemini-api-access-errors/
Canonical: https://ailoot.ai/blog/it/gemini-api-access-errors/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-096
Revision: sha256-e27b99fb746b9fe6c87923b99e2fedadb34257007fda3d7726f1dd5a49b52bb5


Ma non tutti gli errori di Gemini riguardano la tua regione. Uno riguarda il piano gratuito, un altro la chiave API stessa. E per programmare, Gemini mi sembra un po’ ottuso, anche se gli ho dato una seconda possibilità più di una volta.

Spiegherò come capire che cosa è successo dal messaggio di errore e che cosa usare al posto di Gemini. Cominciamo.

Per informazioni sull’utilizzo del servizio, consulta la [documentazione di Ailoot](https://ailoot.ai/docs/).

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

403 Access Restricted significa che sono state violate le condizioni di accesso. 400 FAILED_PRECONDITION significa che il piano gratuito non è disponibile nel paese. 403 PERMISSION_DENIED con un messaggio sulle autorizzazioni della chiave significa che la chiave è quella sbagliata. Per programmare, usa Claude Code; se non funziona, usa Codex, poi Qwen o DeepSeek.

</div>

## Come si controllano le regioni supportate da Gemini?

Google mantiene una pagina separata che elenca i paesi in cui funzionano Gemini API e Google AI Studio:

<figure>
<blockquote>
<p>The Gemini API and Google AI Studio are available in the following countries and territories. If you're not in one of these countries or territories, try the Gemini API in Gemini Enterprise Agent Platform</p>
</blockquote>
<figcaption>https://ai.google.dev/gemini-api/docs/available-regions</figcaption>
</figure>

Traduzione: «Gemini API e Google AI Studio sono disponibili nei seguenti paesi e territori. Se non ti trovi in uno di questi, prova Gemini API in Gemini Enterprise Agent Platform».

L’elenco contiene 230 voci, dall’Albania alle Isole Åland. Gemini Enterprise Agent Platform è una piattaforma Google Cloud.

Se vieni reindirizzato a questa pagina invece che ad AI Studio, Google indica 3 motivi: la tua regione, avere meno di 18 anni e l’età non verificata nel tuo account Google.

## 403 Access Restricted: che cosa c’entra la tua regione?

Google lo descrive così:

<figure>
<blockquote>
<p>If you see a 403 Access Restricted error, you are using Google AI Studio in a way that does not follow the Terms of Service. One common reason is you are not located in a supported region.</p>
</blockquote>
<figcaption>https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio</figcaption>
</figure>

Traduzione: «Se visualizzi un errore 403 Access Restricted, stai usando Google AI Studio in un modo che viola i Termini di servizio. Un motivo comune è che non ti trovi in una regione supportata».

La tua regione è uno dei 4 controlli. Gli altri 3 sono:

- la richiesta deve superare i controlli di sicurezza automatizzati;
- devi accettare i Termini di servizio di Google e i termini aggiuntivi per l’IA generativa;
- il progetto Google Cloud non deve essere segnalato per violazioni.

## 400 FAILED_PRECONDITION e il piano gratuito

Questo errore riguarda il denaro. Ecco il messaggio nella tabella degli errori di Gemini API:

<figure>
<blockquote>
<p>Gemini API free tier is not available in your country. Please enable billing on your project in Google AI Studio.</p>
</blockquote>
<figcaption>https://ai.google.dev/gemini-api/docs/generate-content/api-errors</figcaption>
</figure>

Traduzione: «Il piano gratuito di Gemini API non è disponibile nel tuo paese. Attiva la fatturazione per il tuo progetto in Google AI Studio».

Google consiglia di attivare un piano a pagamento in AI Studio. Ma funziona solo nei paesi presenti nell’elenco.

## 403 PERMISSION_DENIED: leggi il messaggio

Il numero è lo stesso, ma il messaggio nella tabella degli errori è diverso:

<figure>
<blockquote>
<p>Your API key doesn't have the required permissions.</p>
</blockquote>
<figcaption>https://ai.google.dev/gemini-api/docs/generate-content/api-errors</figcaption>
</figure>

Traduzione: «La tua chiave API non dispone delle autorizzazioni necessarie».

Secondo Google, i motivi sono che hai scelto la chiave sbagliata o che stai accedendo a un modello ottimizzato senza l’autorizzazione necessaria. Controlla che la chiave sia corretta e che abbia accesso.

Ma in AI Studio lo stesso PERMISSION_DENIED si verifica anche durante il controllo della regione: Google lo descrive nella pagina dedicata ai 4 controlli. Quindi leggi il messaggio. Se parla delle autorizzazioni della chiave, controlla la chiave. Se parla della tua regione, la chiave non c’entra.

## Vale la pena continuare a usare Gemini?

Per programmare, secondo me no. Ho Gemini con il piano di livello più alto, ma non ci scrivo programmi. Lo uso per video e foto. Ho lavorato per un mese in Google Antigravity, il programma di Google per lavorare con il codice, e alla fine sono tornato a VS Code.

Non importa che Gemini riesca a tenere a mente 1 milione di token: è un po’ meno intelligente di ChatGPT. Antigravity non è stupido e mi piace, ma purtroppo la qualità è ancora molto peggiore. Se non hai altro a disposizione, può andare: avere qualcosa è meglio che non avere niente.

Gemini è valido per fare ricerche approfondite online su un argomento. Dopotutto è Google: si divora tutti i siti web e tutti i siti web gli permettono di accedere. Per questo faccio questo tipo di ricerche con Gemini invece che con Claude: Claude è costoso e consumerà un sacco di token. Tieni però presente che Gemini scrive molto, si dilunga e non riesce a tirare fuori il punto chiave.

## Che cosa usare al posto di Gemini

Il mio ordine è questo. Claude Code, perché è semplicemente più intelligente. Perché scegliere un modello meno intelligente quando è disponibile quello più intelligente? Se non c’è modo di farlo funzionare, usa ChatGPT Codex: è più facile ottenere l’accesso e ci sono meno blocchi. Se non funziona neanche quello, ci sono i modelli cinesi.

L’esempio video confronta altri modelli per il vibe coding:

<figure>
Il video verrà caricato mentre scorri
<figcaption>Altri modelli per il vibe coding: Codex, Gemini, Qwen e app builder</figcaption>
</figure>

Presenta Codex, Gemini, Qwen, Cursor, Lovable, Bolt e v0 e spiega la scelta di Claude Code nell’esempio di lavoro descritto.

**Qwen.** Qwen è un modello cinese. È circa il 10% indietro rispetto a Opus, il modello più potente di Claude; è abbastanza valido, ma lento. Lo uso anch’io, soprattutto per controllare il codice alla ricerca di bug. Ho spiegato come configurarlo [in un articolo separato](https://ailoot.ai/blog/it/qwen-code-token-plan-setup/).

**DeepSeek.** È una piattaforma cinese. Ma non è in grado di gestire un’attività che dura diverse ore: l’ho provata e si blocca durante il lavoro. Ho spiegato in che cosa differisce da ChatGPT [in un articolo separato](https://ailoot.ai/blog/it/chatgpt-vs-deepseek/).

Ho spiegato quale modello scegliere per ciascuna attività per evitare di pagare troppo [in un articolo separato](https://ailoot.ai/blog/it/ai-model-for-each-task/).

## Se Gemini fa parte del tuo prodotto

Integra un modello di riserva fin dall’inizio. Nel caso descritto è stata usata l’API ufficiale di ChatGPT e l’account è stato bloccato: il servizio aveva elaborato il testo di un utente contenente osservazioni offensive. L’utente non si è nemmeno accorto del blocco, perché il servizio è passato a un modello cinese quando ha ricevuto un rifiuto.

Un’analisi simile dell’errore di regione di Claude Code è disponibile [in un articolo separato](https://ailoot.ai/blog/it/claude-code-region-unavailable/).

Se Gemini e Claude non sono disponibili nella tua regione, confronta le alternative disponibili per la tua attività.

<div class="section" role="doc-bibliography" aria-label="Fonti">

### Fonti

- [Google: regioni disponibili per Gemini API e Google AI Studio](https://ai.google.dev/gemini-api/docs/available-regions) - elenco di 230 paesi e territori, 3 motivi per cui si viene reindirizzati alla pagina e Gemini Enterprise Agent Platform per i paesi che non figurano nell’elenco.
- [Google: risoluzione dei problemi di Google AI Studio](https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio) - l’errore 403 Access Restricted e i 4 controlli di accesso durante i quali può verificarsi PERMISSION_DENIED.
- [Google: errori API](https://ai.google.dev/gemini-api/docs/generate-content/api-errors) - 400 FAILED_PRECONDITION per il piano gratuito e 403 PERMISSION_DENIED per le autorizzazioni della chiave.

</div>



Scopri [Ailoot](https://ailoot.ai/).

## Domande frequenti

### Ogni errore Gemini 403 significa che il mio paese non è supportato?

No. Leggi il messaggio completo. I controlli di accesso ad AI Studio comprendono regione, età e condizioni dell’account; un PERMISSION_DENIED sui permessi della chiave richiede invece di verificare la chiave selezionata e i suoi accessi.

### Cosa controllo se il livello gratuito restituisce FAILED_PRECONDITION?

Verifica che il livello gratuito Gemini API sia disponibile nel tuo paese e progetto. Non confondere questa restrizione con una chiave API errata: l’articolo rimanda alle pagine Google su regioni e risoluzione dello specifico errore.


## Ailoot · L’azienda e il suo portafoglio di progetti

Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
