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

Informazioni sulla località global

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

L'utilizzo della località global per le tue richieste può aiutarti a evitare di raggiungere i limiti di capacità del modello e a ridurre gli errori di "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 valori predefiniti automatici 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 servizio di backend Agent Platform Gemini API (formerly Vertex AI) 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.

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

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

• Modelli Gemini 2.5: 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 dati chiave e best practice sulle località:

• I limiti di capacità sono per modello, per regione e 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à da cui accedi al modello. In questo modo, puoi modificare la posizione 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 posizione da cui accedi a un modello (se il modello è disponibile in località diverse da global). Ad esempio, puoi impostare la località in base a quella dell'utente finale utilizzando Firebase Remote Config.

Esempi di codice

Firebase AI Logic ha valori predefiniti automatici per la località (ad esempio, global quando si utilizza la sintassi di inizializzazione "Agent Platform"). Tuttavia, se devi o vuoi utilizzare una località diversa, devi specificarla esplicitamente durante l'inizializzazione del servizio di backend Agent Platform Gemini API (formerly Vertex AI) 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.

Paesi in cui l'app è disponibile

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

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 informazioni dettagliate sulla disponibilità delle località, consulta la documentazione di Google Cloud).

Tieni presente quanto segue:

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

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

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

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

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

Gemini 3.x e modelli successivi

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

• global
• us
• eu

Per informazioni dettagliate sulle località disponibili per ogni modello, consulta la documentazione di Google Cloud.

Modelli di generazione precedente

Quando utilizzi 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 informazioni dettagliate sulle località disponibili per ogni modello, consulta la documentazione di Google Cloud.

Elenco delle località precedentemente disponibili, ma ora non più supportate:

• Nessuna località è stata ancora rifiutata