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 posizione per accedere al modello. Firebase AI Logic viene impostato automaticamente su us-central1 per tutte le richieste.

Per quasi tutti i modelli Gemini, Vertex AI Gemini API supporta una posizione 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 "Servizio sovraccarico" (503). Inoltre, a seconda del modello, l'utilizzo della posizione global potrebbe essere obbligatorio.

Quando è necessario impostare esplicitamente una posizione?

Poiché Firebase AI Logic viene impostato automaticamente su us-central1 per tutte le richieste, se devi o vuoi utilizzare una posizione diversa, devi specificare esplicitamente la posizione durante l'inizializzazione del servizio di backend Vertex AI Gemini API nel codice.

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

• Modelli Gemini 3.x: l'impostazione esplicita della località su global è obbligatoria quando si utilizza Firebase AI Logic. Firebase AI Logic non supporta ancora le località us e eu.

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

• Modelli Gemini Live API: l'impostazione esplicita della posizione è 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.

Fatti generali e best practice

Ecco alcuni fatti 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 impostare la posizione su global (se il modello supporta la posizione global).

• Prendi in considerazione l'utilizzo di Firebase Remote Config per controllare la posizione da cui accedi al modello. In questo modo, puoi modificare la posizione 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 in modo esplicito dove accedi ai modelli. Ad esempio, puoi impostare la località in base a quella dell'utente finale utilizzando Firebase Remote Config.

Esempi di codice

Firebase AI Logic viene impostato automaticamente su us-central1 per tutte le richieste. Se hai bisogno o vuoi utilizzare una posizione diversa, devi specificarla esplicitamente durante l'inizializzazione del servizio di backend Vertex AI Gemini API nel codice.

Tieni presente che questi esempi mostrano l'accesso a un modello Gemini, ma puoi anche specificare una posizione 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.

Paesi in cui è disponibile il servizio

Google Cloud utilizza regioni. Google Cloud memorizza i dati dei clienti solo nella regione specificata per tutte le funzionalità di AI generativa su Vertex AI disponibili a livello generale.

L'AI generativa su Vertex AI è 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 Google Cloud).

Tieni presente quanto segue:

• Firebase AI Logic è impostato per impostazione predefinita sulla posizione us-central1.

• Per tutti i modelli Gemini di 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 e eu.

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