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 o local para acessar o modelo. O Firebase AI Logic tem configurações de local padrão.

• Ao usar a nova sintaxe de inicialização "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 o local global para suas solicitações pode ajudar a evitar que você atinja os limites de capacidade do modelo e reduzir os erros de "serviço sobrecarregado" (503). Além disso, dependendo do modelo, o uso do local global pode ser obrigatório porque é o único local disponível para o modelo (por exemplo, um modelo Gemini de pré-lançamento).

Quando é necessário definir explicitamente um local?

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

Dependendo do modelo, pode ser necessário definir explicitamente um local. Se a solicitação tentar acessar um modelo em um local em que 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 Gemini experimentais e de pré-lançamento:disponíveis apenas no local global.

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

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

Consulte 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 atingir os limites de capacidade inesperadamente, use o local global (se o modelo estiver disponível no local global).

• Considere usar 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 local global não for aplicável ao seu caso de uso, considere distribuir explicitamente onde você acessa um modelo (se o modelo 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.

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 "Plataforma de agente"). No entanto, se você precisar ou quiser usar um local diferente, será necessário especificar explicitamente o local durante a inicialização do serviço de back-end Agent Platform Gemini API (formerly Vertex AI) no código.

Substitua LOCATION pelo código do 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-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

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 na 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 saber mais sobre a disponibilidade por local, consulte a documentação do Google Cloud).

Observações:

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

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

• Modelos Gemini experimentais e de pré-lançamento:disponíveis apenas no local global.

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

• Modelos 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 é compatível com os 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ções anteriores

Ao usar modelos Gemini mais antigos (como os modelos 2.5), o Firebase AI Logic oferece suporte aos 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 recusados:

• Nenhum local foi recusado ainda