Especifique o local para acessar o modelo

Os modelos de IA generativa do Google estão disponíveis em regiões específicas. É possível escolher onde acessar o modelo para atender aos requisitos de conformidade, latência, disponibilidade e durabilidade.

Ao usar Firebase AI Logic, cada uma das suas solicitações que usam a Agent Platform Gemini API (formerly Vertex AI) pode incluir o local para acessar o modelo. Firebase AI Logic tem configurações de local padrão.

• Ao usar a nova sintaxe de inicialização da Agent Platform: global
• Ao usar a sintaxe de inicialização legada da Vertex AI: us-central1

Sobre o local global

Para quase todos os modelos Gemini, o Agent Platform Gemini API (formerly Vertex AI) oferece um local global, o que significa que sua solicitação será processada por um modelo disponível em qualquer lugar do pool global.

Usar o local global para suas solicitações pode ajudar a evitar limites de capacidade para o modelo e reduzir erros de "serviço sobrecarregado" (503). Além disso, dependendo do modelo, o uso do local global pode ser necessário porque é o único local disponível para o modelo (por exemplo, um modelo Gemini de prévia).

Quando é necessário definir um local explicitamente?

Firebase AI Logic tem padrões automáticos para o local (por exemplo, global ao usar a sintaxe de inicialização da Agent Platform). No entanto, se você precisar ou quiser usar um local diferente, especifique-o explicitamente durante a inicialização do serviço de back-end Agent Platform Gemini API (formerly Vertex AI)no seu código.

Dependendo do modelo, a definição explícita de um local pode ser necessária. Se a solicitação tentar acessar um modelo em um local em que ele não está disponível, você receberá um erro 404 informando que o modelo was not found or your project does not have access to it.

• Gemini Modelos de prévia e experimentais: Disponíveis apenas no local global.

• Gemini 4.x e Gemini 3.x modelos estáveis: Disponíveis no local global e, geralmente, nos locais us e eu.

• Gemini 2.5 modelos: Disponíveis em muitos locais. Observe que os modelos Gemini Live API 2.5 não estão disponíveis em global.

Confira a lista de todos os locais disponíveis mais adiante nesta página.

Fatos gerais e práticas recomendadas

Confira alguns fatos importantes e práticas recomendadas sobre locais:

• Os limites de capacidade são por modelo, por região e por minuto.

• Para evitar limites de capacidade inesperados, use o local global (se o modelo estiver disponível nele).global

• Use Firebase Remote Config para controlar o local em que você acessa o modelo. Dessa forma, é possível mudar o local sem lançar uma nova versão do app.

• Se o uso do global local não for aplicável ao seu caso de uso, considere distribuir explicitamente onde você acessa um modelo (se ele estiver disponível em locais diferentes de global). Por exemplo, é possível definir o local com base no local do usuário final usando Firebase Remote Config.

Exemplos de código

Firebase AI Logic tem padrões automáticos para o local (por exemplo, global ao usar a sintaxe de inicialização da Agent Platform). No entanto, se você precisar ou quiser usar um local diferente, especifique-o explicitamente durante a inicialização do serviço de back-end Agent Platform Gemini API (formerly Vertex AI)no seu código.

Substitua LOCATION pelo código do local (por exemplo, global ou us-central1) na lista de locais disponíveis mais adiante nesta 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"));

// ...

Se você especificar um local em que o modelo não está disponível, vai receber um erro 404 informando que o modelo was not found or your project does not have access to it.

Locais disponíveis

Google Cloud usa regiões. Google Cloud só armazena os dados do cliente na região especificada para todos os recursos geralmente disponíveis da IA generativa em Agent Platform.

A IA generativa na Agent Platform está disponível nas seguintes regiões. Alguns modelos e/ou versões específicas podem não estar disponíveis em todos os locais (para disponibilidade detalhada do local, consulte a Google Cloud documentação).

Observe o seguinte:

• Firebase AI Logic usa os seguintes locais por padrão:

  • Ao usar a nova sintaxe de inicialização da Agent Platform: global
  • Ao usar a sintaxe de inicialização legada da Vertex AI: us-central1

• Gemini Modelos de prévia e experimentais: Disponíveis apenas no local global.

• Gemini 4.x e Gemini 3.x modelos estáveis: Disponíveis no local global e, geralmente, nos locais us e eu.

• Gemini 2.5 modelos: Disponíveis em muitos locais. Observe que os modelos Gemini Live API 2.5 não estão disponíveis em global.

Gemini 3.x e modelos mais recentes

Ao usar modelos Gemini 3.x e mais recentes, Firebase AI Logic oferece suporte aos seguintes locais:

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

Para mais detalhes sobre os locais disponíveis para cada modelo, consulte a Google Cloud documentação.

Modelos de geração mais antigos

Ao usar modelos mais antigos Gemini (como os modelos 2.5), Firebase AI Logic oferece suporte aos seguintes locais:

Observe que os modelos Gemini Live API 2.5 não estão disponíveis em global.

Para mais detalhes sobre os locais disponíveis para cada modelo, consulte a Google Cloud documentação.

Lista de locais que estavam disponíveis, mas foram desativados :

• Nenhum local foi desativado ainda