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

Acerca de la ubicación global

Para casi todos los modelos Gemini, la Agent Platform Gemini API (formerly Vertex AI) ofrece 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 "servicio sobrecargado" (503). Además, según el modelo, es posible que se global requiera usar la ubicación porque es la única ubicación disponible para el modelo (por ejemplo, un modelo Gemini en versión preliminar).

¿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 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 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.

• Gemini 4.x y Gemini 3.x modelos estables: Disponibles en la ubicación global y, a menudo, en las ubicaciones us y eu.

• Gemini 2.5 modelos: Disponibles en muchas ubicaciones. Ten en cuenta que los modelos Gemini Live API 2.5 no están disponibles en 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 el modelo está disponible en esa 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 a tu caso de uso, considera distribuir de forma explícita dónde accedes a un modelo (si el modelo está disponible en ubicaciones que no sean global). 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 us-central1) 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 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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 los datos del cliente en la región que especifiques para todas las funciones de disponibilidad general de la 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 ubicaciones, consulta la Google Cloud documentación).

Ten en cuenta lo siguiente:

• Firebase AI Logic usa las siguientes ubicaciones de forma predeterminada:

  • 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

• Gemini modelos en versión preliminar y experimental: Solo disponibles en la ubicación global.

• Gemini 4.x y Gemini 3.x modelos estables: Disponibles en la ubicación global y, a menudo, en las ubicaciones us y eu.

• Gemini 2.5 modelos: Disponibles en muchas ubicaciones. Ten en cuenta que los modelos Gemini Live API 2.5 no están disponibles en global.

Gemini 3.x y versiones posteriores

Cuando se usan modelos de Gemini 3.x y versiones posteriores, Firebase AI Logic admite las siguientes ubicaciones:

• global
• us
• eu
• europe-west2 (Londres, Reino Unido)
• asia-southeast1 (Singapur)

Para obtener detalles sobre las ubicaciones disponibles para cada modelo, consulta la Google Cloud documentación.

Modelos de generaciones anteriores

Cuando se usan modelos Gemini más antiguos (como los modelos 2.5), Firebase AI Logic admite las siguientes ubicaciones:

Ten en cuenta que los modelos Gemini Live API 2.5 no están disponibles en global.

Para obtener detalles sobre las ubicaciones disponibles para cada modelo, consulta la Google Cloud documentación.

Lista de ubicaciones que estaban disponibles anteriormente, pero que ahora están desactivadas:

• Aún no se desactivaron ubicaciones