Specifica la posizione per accedere al modello

I modelli di AI generativa di Google sono disponibili in regioni specifiche. Ogni richiesta che utilizza Vertex AI Gemini API deve includere la località per accedere al modello. Firebase AI Logic imposta automaticamente us-central1 come valore predefinito per tutte le richieste.

Per quasi tutti i modelli Gemini, l'Vertex AI Gemini API supporta una località global, il che significa che la 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 "service overloaded" (503). Inoltre, a seconda del modello, l'utilizzo della località global potrebbe essere obbligatorio.

Quando è necessario impostare esplicitamente una località?

Poiché Firebase AI Logic imposta automaticamente us-central1 come valore predefinito per tutte le richieste, se devi o vuoi utilizzare una località diversa, devi specificarla esplicitamente durante l'inizializzazione del Vertex AI Gemini API servizio di backend nel codice.

A seconda del modello, l'impostazione esplicita di una località potrebbe essere obbligatoria. Se la 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 di anteprima: è necessario impostare esplicitamente la località su global (ad eccezione dei modelli di anteprima Live API).

• Gemini 3.x modelli: è necessario impostare esplicitamente la località su global quando si utilizza Firebase AI Logic. Firebase AI Logic non supporta ancora le località us e eu.

• Gemini 2.5 modelli: l'impostazione esplicita della località è facoltativa, ma consigliata. Se non specifichi una località, il valore predefinito è us-central1.

• Gemini Live API modelli: l'impostazione esplicita della località è facoltativa, ma consigliata. Se non specifichi una località, il valore predefinito è us-central1. Tieni presente che 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 fatti chiave e best practice sulle località:

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

• Per evitare di raggiungere inaspettatamente i limiti di capacità, valuta la possibilità di impostare la località su global (se il modello supporta la 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'impostazione della località su global non è applicabile o supportata 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 imposta automaticamente us-central1 come valore predefinito per tutte le richieste. Se devi o vuoi utilizzare una località diversa, devi specificare esplicitamente la località durante l'inizializzazione del Vertex AI Gemini API servizio di backend nel codice.

Tieni presente che questi esempi mostrano l'accesso a un modello Gemini, ma puoi anche specificare una località quando accedi a un modello Imagen.

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 Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

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 in Vertex AI.

AI generativa in Vertex AI è 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 di 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.