Especifique o local para acessar o modelo

Clique no seu provedor Gemini API para conferir o conteúdo específico do provedor e o código nesta página.


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 opcionalmente 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

Para quase todos os modelos Gemini, a Agent Platform Gemini API (formerly Vertex AI) oferece suporte a um local global, o que significa que sua solicitação será processada por um modelo disponível em qualquer lugar do pool global. O uso do 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.

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 visualização e experimentais: disponíveis apenas no local global (exceto para modelos Live API, consulte abaixo).

  • Gemini 3.x modelos: disponíveis apenas no local global ao usar Firebase AI Logic. Firebase AI Logic ainda não oferece suporte aos locais us e eu .

  • Gemini 2.5 modelos: Disponível em muitos locais.

  • modelos: disponíveis apenas no local us-central1.Gemini Live API O local global não é compatível.

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 oferecer suporte a ele).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 ou compatível com seu caso de uso, distribua explicitamente onde você acessa os modelos. Por exemplo, é possível definir o local com base na localização do usuário final usando Firebase Remote Config.

Amostras 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 europe-west4) na lista de locais disponíveis mais adiante nesta página.

Sintaxe da Agent Platform

Swift 

// ...

// 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"))

// ...

Kotlin 

// ...

// 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"))

// ...

Java 

// ...

// 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"));

// ...

Web 

// ...

// 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') });

// ...

Dart 

// ...

// 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');

// ...

Unity 

// ...

// 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`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

Sintaxe da Vertex AI

Swift 

// ...

// 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"))

// ...

Kotlin 

// ...

// 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"))

// ...

Java 

// ...

// 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"));

// ...

Web 

// ...

// 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') });

// ...

Dart 

// ...

// 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');

// ...

Unity 

// ...

// 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, 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).

Observações:

  • Firebase AI Logic usa o local us-central1 por padrão.

  • Para todos os modelos Gemini de visualização (exceto os modelos Live API), o único local com suporte é global.

  • Ao usar Firebase AI Logic para acessar modelos Gemini 3.x, o único local com suporte é global. Firebase AI Logic ainda não oferece suporte aos locais us e eu.

  • Para todos os modelos Live API e todos os modelos Imagen, o global local não é compatível.

Global

  • global

Estados Unidos

  • Columbus, Ohio (us-east5)
  • Dallas, Texas (us-south1)
  • Iowa (us-central1)
  • Las Vegas, Nevada (us-west4)
  • Moncks Corner, Carolina do Sul (us-east1)
  • Norte da Virgínia (us-east4)
  • Oregon (us-west1)

Canadá

  • Montréal (northamerica-northeast1)

América do Sul

  • São Paulo, Brasil (southamerica-east1)

Europa

  • Bélgica (europe-west1)
  • Finlândia (europe-north1)
  • Frankfurt, Alemanha (europe-west3)
  • Londres, Reino Unido (europe-west2)
  • Madri, Espanha (europe-southwest1)
  • Milão, Itália (europe-west8)
  • Países Baixos (europe-west4)
  • Paris, França (europe-west9)
  • Varsóvia, Polônia (europe-central2)
  • Zurique, Suíça (europe-west6)

Ásia-Pacífico

  • Changhua County, Taiwan (asia-east1)
  • Hong Kong, China (asia-east2)
  • Mumbai, Índia (asia-south1)
  • Seul, Coreia (asia-northeast3)
  • Singapura (asia-southeast1)
  • Sydney, Austrália (australia-southeast1)
  • Tóquio, Japão (asia-northeast1)

Oriente Médio

  • Damã, Arábia Saudita (me-central2)
  • Doha, Catar (me-central1)
  • Tel Aviv, Israel (me-west1)