Specifica la posizione per accedere al modello

I modelli di AI generativa di Google sono disponibili in regioni specifiche.

Quando inizializzi il servizio di backend Vertex AI Gemini API nel tuo codice, puoi facoltativamente specificare la località del modello a cui stai accedendo nelle tue richieste. Consulta l'elenco delle località disponibili più avanti in questa pagina.

Ecco alcuni fatti chiave e best practice sulle località:

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

• Se non specifichi una località, il valore predefinito è us-central1.

• Per evitare di raggiungere in modo imprevisto i limiti di capacità, valuta la possibilità di impostare la località su global (se il modello supporta la località global).

• 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 la posizione in cui accedi ai modelli. Ad esempio, puoi impostare la località in base alla località dell'utente finale utilizzando Firebase Remote Config.

Informazioni sulla località global

Per l'accesso a quasi tutti i Gemini modelli, l' Vertex AI Gemini API supporta una località global, il che significa che la tua richiesta verrà gestita da un modello disponibile ovunque nel pool globale. L'impostazione della località su global per le tue richieste può aiutarti a evitare di raggiungere i limiti di capacità del modello e a ridurre gli errori di esaurimento delle risorse (429).

Esempi di 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 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 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.

L'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).

Tutti i modelli Gemini (ad eccezione dei modelli Gemini Live API) sono disponibili anche in una località global. Per tutti i modelli Live API e tutti i Imagen modelli, la località global non è supportata.