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 cumplir con 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 la configuración de ubicación predeterminada.

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

Acerca de la ubicación de global

Para casi todos los modelos de Gemini, el 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 parte 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 porque es la única ubicación disponible para el modelo (por ejemplo, un modelo Gemini de 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 de 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 el modelo was not found or your project does not have access to it.

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

• Modelos estables Gemini 4.x y Gemini 3.x: Están 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

A continuación, se incluyen 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 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 la app.

• Si usar la ubicación global no es aplicable para 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 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-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 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íficas no estén disponibles en todas las ubicaciones (para obtener información detallada sobre la disponibilidad de las ubicaciones, consulta la documentación de Google Cloud).

Ten en cuenta lo siguiente:

• Firebase AI Logic se establece de forma predeterminada en las siguientes ubicaciones:

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

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

• Modelos estables Gemini 4.x y Gemini 3.x: Están 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 de Gemini más antiguos (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 antes estaban disponibles, pero que ahora se rechazaron:

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