Especifica la ubicación para acceder al modelo

Los modelos de IA generativa de Google están disponibles en regiones específicas. Cada una de tus solicitudes que usan Vertex AI Gemini API debe incluir la ubicación para acceder al modelo. Firebase AI Logic se establece automáticamente como us-central1 para todas las solicitudes.

En casi todos los modelos Gemini, el Vertex AI Gemini API admite una ubicación global, lo que significa que tu solicitud se controlará con un modelo disponible en cualquier lugar del grupo global. Usar la ubicación global para tus solicitudes puede ayudarte a evitar alcanzar los límites de capacidad del modelo y reducir los errores de "servicio sobrecargado" (503). Además, según el modelo, es posible que se requiera usar la ubicación global.

¿Cuándo es necesario establecer una ubicación de forma explícita?

Dado que Firebase AI Logic se establece automáticamente como us-central1 para todas las solicitudes, si necesitas o quieres usar una ubicación diferente, debes especificarla de forma explícita durante la inicialización del servicio de backend Vertex AI Gemini API en tu código.

Según el modelo, es posible que se requiera establecer una ubicación de forma explícita. Si tu solicitud intenta acceder a un modelo en una ubicación en la que no está disponible, recibirás un error 404 que indica que el modelo was not found or your project does not have access to it.

• Gemini modelos de vista previa: Se requiere establecer explícitamente la ubicación en global (excepto para los modelos de vista previa de Live API).

• Modelos de Gemini 3.x: Es necesario establecer la ubicación de forma explícita en global cuando se usa Firebase AI Logic. Firebase AI Logic aún no admite las ubicaciones us y eu.

• Modelos de Gemini 2.5: Establecer la ubicación de forma explícita es opcional, pero se recomienda. Si no especificas una ubicación, el valor predeterminado es us-central1.

• Modelos de Gemini Live API: Establecer la ubicación de forma explícita es opcional, pero se recomienda. Si no especificas una ubicación, el valor predeterminado es us-central1. Ten en cuenta que no se admite la ubicación global.

Consulta la lista de todas las ubicaciones disponibles más adelante en esta página.

Datos generales y prácticas recomendadas

Estos son algunos datos clave y prácticas recomendadas sobre las ubicaciones:

• Los límites de capacidad son por modelo, por región y por minuto.

• Para evitar alcanzar los límites de capacidad de forma inesperada, considera establecer la ubicación en global (si tu modelo admite la ubicación global).

• Considera usar Firebase Remote Config para controlar la ubicación desde la que accedes al modelo. De esta manera, puedes cambiar la ubicación sin lanzar una versión nueva de tu app.

• Si establecer la ubicación en global no es aplicable o no se admite para tu caso de uso, considera distribuir explícitamente dónde accedes a los modelos. Por ejemplo, puedes establecer la ubicación según la del usuario final con Firebase Remote Config.

Muestras de código

Firebase AI Logic se establece automáticamente como us-central1 para todas las solicitudes. Si necesitas o quieres usar una ubicación diferente, debes especificarla de forma explícita durante la inicialización del servicio de backend de Vertex AI Gemini API en tu código.

Ten en cuenta que estos ejemplos muestran el acceso a un modelo Gemini, pero también puedes especificar una ubicación cuando accedes a un modelo Imagen.

Reemplaza LOCATION por el código de ubicación (por ejemplo, global o europe-west4) de la lista de ubicaciones disponibles que se encuentra más adelante en esta página.

// ...

// 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");

// ...

Ten en cuenta que, si especificas una ubicación en la que el modelo no está disponible, recibirás un error 404 que indica que el modelo was not found or your project does not have access to it.

Ubicaciones disponibles

Google Cloud usa regiones. Google Cloud solo almacena los datos del cliente en la región que especifiques para todas las funciones de disponibilidad general de la IA generativa en Vertex AI.

La IA generativa en Vertex AI está disponible en las siguientes regiones. Es posible que algunos modelos o versiones específicos no estén disponibles en todas las ubicaciones (para obtener información detallada sobre la disponibilidad por ubicación, consulta la documentación de Google Cloud).

Ten en cuenta lo siguiente:

• Firebase AI Logic se establece de forma predeterminada en la ubicación us-central1.

• Para todos los modelos de Gemini en versión preliminar (excepto los modelos de Live API), la única ubicación admitida es global.

• Cuando se usa Firebase AI Logic para acceder a modelos Gemini 3.x, la única ubicación admitida es global. Firebase AI Logic aún no admite las ubicaciones us y eu.

• Para todos los modelos Live API y Imagen, no se admite la ubicación global.