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 o Agent Platform Gemini API (formerly Vertex AI) pode incluir opcionalmente a localização 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 "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 a localização global nas solicitações ajuda a evitar atingir os limites de capacidade do modelo e reduzir os erros "serviço sobrecarregado" (503). Além disso, dependendo do modelo, o uso da região global pode ser obrigatório porque é a única disponível para ele (por exemplo, um modelo Gemini de prévia).

Quando é necessário definir explicitamente um local?

O Firebase AI Logic tem padrões automáticos para local (por exemplo, global ao usar a sintaxe de inicialização "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, definir explicitamente um local pode ser obrigatório. Se a solicitação tentar acessar um modelo em um local onde ele não está disponível, você vai receber um erro 404 informando que o modelo was not found or your project does not have access to it.

• Modelos de prévia e experimental do Gemini:disponíveis apenas no local global.

• Modelos estáveis Gemini 3.x:disponíveis na região global e, geralmente, nas regiões us e eu.

• Modelos do Gemini 2.5:Disponíveis em vários locais. Os modelos Gemini Live API 2.5 não estão disponíveis no global.

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

Fatos gerais e práticas recomendadas

Confira alguns fatos e práticas recomendadas sobre locais:

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

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

• Considere usar Firebase Remote Config para controlar o local de acesso ao modelo. Assim, é possível mudar o local sem lançar uma nova versão do app.

• Se o uso do local global não for aplicável ao seu caso de uso, distribua 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 na localização do usuário final usando Firebase Remote Config.

Amostras de código

O Firebase AI Logic tem padrões automáticos para localização (por exemplo, global ao usar a sintaxe de inicialização "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 de local (por exemplo, global ou us-central1) da 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-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"));

// ...

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

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

A IA generativa no 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 saber mais sobre a disponibilidade em cada local, consulte a documentação do Google Cloud.

Observações:

• O 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 "Vertex AI": us-central1

• Modelos de prévia e experimental do Gemini:disponíveis apenas no local global.

• Modelos estáveis Gemini 3.x:disponíveis na região global e, geralmente, nas regiões us e eu.

• Modelos do Gemini 2.5:Disponíveis em vários locais. Os modelos Gemini Live API 2.5 não estão disponíveis no global.

Gemini 3.x e modelos mais recentes

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

• global
• us
• eu

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

Modelos de geração mais antiga

Ao usar modelos Gemini mais antigos (como os 2.5), o Firebase AI Logic é compatível com os seguintes locais:

Os modelos Gemini Live API 2.5 não estão disponíveis no global.

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

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

• Nenhum local foi recusado ainda