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 localizzazione predefinite.

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

Per quasi tutti i modelli Gemini, il Agent Platform Gemini API (formerly Vertex AI) supporta una località global, 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.

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 anteprima e sperimentali: disponibili solo nella località global (ad eccezione dei modelli Live API, vedi di seguito).

• Gemini 3.x modelli: disponibili solo nella località global quando utilizzi Firebase AI Logic. Firebase AI Logic non supporta ancora le us e eu località.

• Gemini 2.5 modelli: Disponibili in molte località.

• Gemini Live API modelli: disponibili solo nella località us-central1. La località global non è supportata.

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

Informazioni generali e best practice

Ecco alcuni dati 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 la supporta).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 o supportato per il tuo caso d'uso, valuta la possibilità di distribuire esplicitamente la località in cui accedi ai modelli. 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 europe-west4) 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 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`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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.

Paesi in cui è disponibile il servizio

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 per impostazione predefinita la località us-central1.

• Per tutti i modelli Gemini anteprima (ad eccezione dei modelli Live API), l' unica località supportata è global.

• Quando utilizzi Firebase AI Logic per accedere ai modelli Gemini 3.x, l' unica località supportata è global. Firebase AI Logic non supporta ancora le località us ed eu.

• Per tutti i modelli Live API e tutti i modelli Imagen, la global località non è supportata.