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 Agent Platform Gemini API (formerly Vertex AI) puede incluir de forma opcional la ubicación para acceder al modelo. Firebase AI Logic tiene la configuración de ubicación predeterminada.

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

Acerca de la ubicación global

En casi todos los modelos de Gemini, el Agent Platform Gemini API (formerly Vertex AI) ofrece una ubicación de global, lo que significa que un modelo disponible en cualquier lugar del grupo global controlará tu solicitud.

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 porque es la única disponible para el modelo (por ejemplo, un modelo de Gemini de vista previa).

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

• Modelos experimentales y de vista previa de Gemini: Solo están disponibles en la ubicación global.

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

• Modelos de Gemini 2.5: Disponibles en muchas ubicaciones. Ten en cuenta que los modelos de 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 desde la que accedes al modelo. De esta 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 explícitamente dónde accedes a un modelo (si el modelo está disponible en ubicaciones distintas de global). Por ejemplo, puedes establecer la ubicación según la 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 "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 de 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 que se encuentra 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-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 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 Agent Platform.

La IA generativa en Agent Platform 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:

• La configuración predeterminada de Firebase AI Logic es en las siguientes ubicaciones:

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

• Modelos experimentales y de vista previa de Gemini: Solo están disponibles en la ubicación global.

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

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

Gemini 3.x y modelos posteriores

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

• global
• us
• eu

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

Modelos de generaciones anteriores

Cuando se usan modelos Gemini anteriores (como los modelos 2.5), Firebase AI Logic admite las siguientes ubicaciones:

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

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

Lista de ubicaciones que estaban disponibles anteriormente, pero que ahora se rechazan:

• Aún no se rechazó ninguna ubicación