Specifica la posizione per accedere al modello

I modelli di AI generativa di Google sono disponibili in regioni specifiche. Puoi scegliere dove accedere al modello per soddisfare i requisiti di conformità, latenza, disponibilità e durabilità.

Quando utilizzi Firebase AI Logic, ogni richiesta che utilizza Agent Platform Gemini API (formerly Vertex AI) può includere facoltativamente la località per accedere al modello. Firebase AI Logic ha impostazioni di località predefinite.

• Quando utilizzi la nuova sintassi di inizializzazione "Agent Platform": global
• Quando utilizzi la sintassi di inizializzazione "Vertex AI" legacy: us-central1

Informazioni sulla località global

Per quasi tutti i Gemini modelli, il Agent Platform Gemini API (formerly Vertex AI) offre una global località, il che significa che la tua richiesta verrà gestita da un modello disponibile ovunque nel pool globale.

L'utilizzo della località global per le richieste può aiutarti a evitare di raggiungere i limiti di capacità del modello e a ridurre gli errori "servizio sovraccarico" (503). Inoltre, a seconda del modello, l'utilizzo della località global potrebbe essere obbligatorio perché è l'unica località disponibile per il modello (ad esempio, un modello Gemini in anteprima).

Quando è necessario impostare esplicitamente una località?

Firebase AI Logic ha impostazioni predefinite automatiche per la località (ad esempio, global quando utilizzi la sintassi di inizializzazione "Agent Platform"). Tuttavia, se devi o vuoi utilizzare una località diversa, devi specificarla esplicitamente durante l'inizializzazione del Agent Platform Gemini API (formerly Vertex AI) servizio di backend nel codice.

A seconda del modello, l'impostazione esplicita di una località potrebbe essere obbligatoria. Se la tua richiesta tenta di accedere a un modello in una località in cui non è disponibile, riceverai un errore 404 che indica che il modello was not found or your project does not have access to it.

• Gemini modelli in anteprima e sperimentali: disponibili solo nella località global.

• Gemini 4.x e modelli stabili Gemini 3.x: disponibili nella località global e spesso nelle località us e eu.

• Gemini 2.5 modelli: disponibili in molte località. Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Consulta l'elenco di tutte le località disponibili più avanti in questa pagina.

Informazioni generali e best practice

Ecco alcuni fatti chiave e best practice sulle località:

• I limiti di capacità sono per modello, per regione, per minuto.

• Per evitare di raggiungere inaspettatamente i limiti di capacità, valuta la possibilità di utilizzare la località global (se il modello è disponibile nella località global).

• Valuta la possibilità di utilizzare Firebase Remote Config per controllare la località in cui accedi al modello. In questo modo, puoi modificare la località senza rilasciare una nuova versione dell'app.

• Se l'utilizzo della località global non è applicabile al tuo caso d'uso, valuta la possibilità di distribuire esplicitamente la località in cui accedi a un modello (se il modello è disponibile in località diverse da global). Ad esempio, puoi impostare la località in base alla località dell'utente finale utilizzando Firebase Remote Config.

Esempi di codice

Firebase AI Logic ha impostazioni predefinite automatiche per la località (ad esempio, global quando utilizzi la sintassi di inizializzazione "Agent Platform"). Tuttavia, se devi o vuoi utilizzare una località diversa, devi specificarla esplicitamente durante l'inizializzazione del Agent Platform Gemini API (formerly Vertex AI) servizio di backend nel codice.

Sostituisci LOCATION con il codice della località (ad esempio, global o us-central1) dall'elenco delle località disponibili più avanti in questa pagina.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Tieni presente che se specifichi una località in cui il modello non è disponibile, riceverai un errore 404 che indica che il modello was not found or your project does not have access to it.

Località disponibili

Google Cloud utilizza le regioni. Google Cloud archivia i dati dei clienti solo nella regione che specifichi per tutte le funzionalità con disponibilità generale di AI generativa su Agent Platform.

L'AI generativa su Agent Platform è disponibile nelle seguenti regioni. Alcuni modelli e/o versioni specifiche potrebbero non essere disponibili in tutte le località (per la disponibilità dettagliata delle località, consulta la Google Cloud documentazione).

Tieni presente quanto segue:

• Firebase AI Logic utilizza le seguenti località per impostazione predefinita:

  • Quando utilizzi la nuova sintassi di inizializzazione "Agent Platform": global
  • Quando utilizzi la sintassi di inizializzazione "Vertex AI" legacy: us-central1

• Gemini modelli in anteprima e sperimentali: disponibili solo nella località global.

• Gemini 4.x e modelli stabili Gemini 3.x: disponibili nella località global e spesso nelle località us e eu.

• Gemini 2.5 modelli: disponibili in molte località. Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Gemini 3.x e versioni successive

Quando utilizzi i modelli Gemini 3.x e versioni successive, Firebase AI Logic supporta le seguenti località:

• global
• us
• eu
• europe-west2 (Londra, Regno Unito)
• asia-southeast1 (Singapore)

Per i dettagli sulle località disponibili per ogni modello, consulta la Google Cloud documentazione.

Modelli di generazione precedente

Quando utilizzi i modelli Gemini precedenti (come i modelli 2.5), Firebase AI Logic supporta le seguenti località:

Tieni presente che i modelli Gemini Live API 2.5 non sono disponibili in global.

Per i dettagli sulle località disponibili per ogni modello, consulta la Google Cloud documentazione.

Elenco delle località precedentemente disponibili, ma ora ritirate:

• Nessuna località è stata ancora ritirata