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 codice, puoi facoltativamente specificare la posizione del modello a cui accedi nelle tue richieste. Consulta l'elenco delle località disponibili più avanti in questa pagina.

Ecco alcuni fatti chiave e best practice relativi alle sedi:

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

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

• Per evitare di raggiungere inaspettatamente i limiti di capacità, ti consigliamo di impostare la località su global nelle tue richieste.

• Se l'impostazione della località su global non è applicabile al tuo caso d'uso, valuta la possibilità di distribuire esplicitamente la posizione da cui accedi ai modelli. Ad esempio, puoi impostare la posizione in base a quella dell'utente finale utilizzando Firebase Remote Config.

Scopri di più sulla posizione global

Per accedere a quasi tutti i modelli Gemini, l'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. Impostare la località su global per le richieste può aiutarti a evitare di raggiungere i limiti di capacità del modello e ridurre gli errori di risorse esaurite (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 the 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 the 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 the 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 the 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 the 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 the 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'IA 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 di Google Cloud).

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