Especifica la ubicación para acceder al modelo

Los modelos de IA generativa de Google están disponibles en regiones específicas. Puedes elegir dónde acceder al modelo para satisfacer tus requisitos de cumplimiento, latencia, disponibilidad y durabilidad.

Cuando usas Firebase AI Logic, cada una de tus solicitudes que usan la Agent Platform Gemini API (formerly Vertex AI) puede incluir de forma opcional la ubicación para acceder al modelo. Firebase AI Logic tiene parámetros de configuración de ubicación predeterminados.

• Cuando se usa la nueva sintaxis de inicialización de "Agent Platform": global
• Cuando se usa la sintaxis de inicialización heredada de "Vertex AI": us-central1

Para casi todos los modelos Gemini, la Agent Platform Gemini API (formerly Vertex AI) 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 sea obligatorio usar la ubicación global.

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

Firebase AI Logic tiene valores predeterminados automáticos para la ubicación (por ejemplo, global cuando se usa la sintaxis de inicialización de "Agent Platform"). Sin embargo, si necesitas o quieres usar una ubicación diferente, debes especificarla de forma explícita durante la inicialización del servicio de backend Agent Platform Gemini API (formerly Vertex AI) en tu código.

Según el modelo, es posible que sea obligatorio 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 was not found or your project does not have access to it.

• Gemini Modelos en versión preliminar y experimental: Solo disponibles en la ubicación global (excepto para los modelos Live API, consulta más abajo).

• Gemini 3.x modelos: Solo disponibles en la ubicación global cuando se usa Firebase AI Logic. Firebase AI Logic aún no admite las ubicaciones us y eu.

• Gemini 2.5 modelos: Disponibles en muchas ubicaciones.

• modelos: Solo disponibles en la ubicación us-central1.Gemini Live API 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 usar la ubicación global (si tu modelo admite la ubicación global).

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

• Si usar la ubicación global no es aplicable ni compatible con tu caso de uso, considera distribuir de forma explícita dónde accedes a los modelos. Por ejemplo, puedes establecer la ubicación según la ubicación del usuario final con Firebase Remote Config.

Muestras de código

Firebase AI Logic tiene valores predeterminados automáticos para la ubicación (por ejemplo, global cuando se usa la sintaxis de inicialización de "Agent Platform"). Sin embargo, si necesitas o quieres usar una ubicación diferente, debes especificarla de forma explícita durante la inicialización del servicio de backend Agent Platform Gemini API (formerly Vertex AI) en tu código.

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

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

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 was not found or your project does not have access to it.

Ubicaciones disponibles

Google Cloud usa regiones. Google Cloud solo almacena datos del cliente en la región que especificas para todas las funciones disponibles de IA generativa en Agent Platform.

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

Ten en cuenta lo siguiente:

• Firebase AI Logic usa la ubicación us-central1 de forma predeterminada.

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

• Cuando se usa Firebase AI Logic para acceder a los modelos de 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 todos los modelos Imagen, no se admite la global ubicación .