Nesta página, você encontra respostas para perguntas frequentes e informações sobre solução de problemas do Firebase AI Logic e como usá-lo com o Gemini API:
- Painéis de status
- Perguntas frequentes gerais
- Perguntas frequentes sobre mudanças (como descontinuações e encerramentos de modelos)
- Perguntas frequentes sobre segurança
Se necessário, confira outros recursos:
Solução de problemas código do erro.
Saiba mais sobre configuração de faturamento, preços e pagamentos.
Saiba mais sobre limites de taxa e cotas.
Painéis de status
Agent Platform Gemini API (formerly Vertex AI) (
Vertex Gemini API)
Perguntas frequentes gerais
Diferenças entre o uso de Gemini Developer API e Agent Platform Gemini API (formerly Vertex AI)
A tabela a seguir lista as diferenças importantes entre os dois provedores do Gemini API em geral, independentemente de como você os acessa:
| Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) | |
|---|---|---|
| Preços | Disponível no plano de preços Spark sem custo financeiro e no plano de preços Blaze de pagamento por uso1 | Sempre exige o plano de preços Blaze de pagamento por uso1 (quando usado com Firebase AI Logic) |
| Limites de taxa (cota) | Limites de taxa explícitos | Usa a cota compartilhada dinâmica (DSQ, na sigla em inglês) que todos os usuários desse modelo nessa região compartilham. A capacidade de processamento provisionada (PT, na sigla em inglês) está disponível. |
| Especificar o local para acessar o modelo | não é compatível com a API | compatíveis com a API |
| Suporte a URLs do Cloud Storage | não são compatíveis com a API 2 |
Arquivos públicos e arquivos protegidos por Firebase Security Rules |
| Suporte para URLs do YouTube e do navegador | Somente URLs do YouTube | URLs do YouTube e do navegador |
1 Os dois provedores de API têm preços de pagamento por uso diferentes (saiba mais na documentação de cada um).
2 A API Files para o Gemini Developer API não é compatível com os SDKs do Firebase AI Logic.
A tabela a seguir lista a disponibilidade de recursos comuns para os dois provedores "Gemini API". Esta tabela se aplica especificamente ao uso dos SDKs de cliente do Firebase AI Logic.
| Recurso | Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) |
|---|---|---|
| Suporte para modelos do Gemini | compatível | compatível |
| Suporte para o Gemini Live API | compatível | compatível |
| Integração com o Firebase App Check | compatível | compatível |
| Compatível com Firebase Remote Config | compatível | compatível |
| Suporte para monitoramento de IA no console do Firebase | compatível | compatível |
Como usar Gemini Developer API e Agent Platform Gemini API (formerly Vertex AI)
É possível ativar os dois provedores do Gemini API no seu projeto do Firebase e usar as duas APIs no próprio app.
Para alternar entre provedores de API no código, verifique se você definiu o serviço de back-end corretamente no código.
APIs necessárias e como ativá-las
|
Selecione seu provedor da API Gemini para conferir o conteúdo específico dele |
Para usar os SDKs do Firebase AI Logic com o Gemini Developer API, seu projeto precisa ter as duas APIs a seguir ativadas:
- Gemini Developer API (
generativelanguage.googleapis.com) - API do Firebase AI Logic (
firebasevertexai.googleapis.com)
Ative essas duas APIs usando o console do Firebase:
No console do Firebase, acesse Serviços de IA > Lógica de IA.
Clique em Começar.
Selecione para começar a usar o Gemini Developer API.
Isso inicia um fluxo de trabalho guiado que ativa as duas APIs para você. O Firebase também vai provisionar uma conta de serviço gerenciada pelo Google (P4SA) para autorizar o uso do Gemini API, além de adicionar a API Firebase AI Logic à lista de permissões da sua chave de API do Firebase.
Como desativar APIs em um projeto do Firebase
Para o Firebase AI Logic, tentamos facilitar ao máximo a configuração do seu projeto do Firebase para usar o provedor de Gemini API escolhido. Isso inclui ativar as APIs necessárias no projeto do Firebase durante jornadas específicas, como o fluxo de trabalho guiado no console do Firebase.
No entanto, se você decidir não usar o Firebase AI Logic ou um dos provedores do Gemini API, poderá desativar as APIs associadas no seu projeto do Firebase.
Desativar as APIs associadas ao uso de Gemini Developer API
Para usar os SDKs do Firebase AI Logic com o Gemini Developer API, seu projeto precisa ter as duas APIs a seguir ativadas:
- Gemini Developer API (
generativelanguage.googleapis.com) - API do Firebase AI Logic (
firebasevertexai.googleapis.com)
Se você quiser parar de usar o Firebase AI Logic completamente:
Clique em cada link de API acima para acessar as respectivas páginas no console do Google Cloud e clique em Gerenciar.
Acesse a guia Métricas para verificar se a API não está sendo usada.
Se você ainda quiser desativar a API, clique em Desativar API na parte de cima da página.
Remova a API Firebase AI Logic da lista de APIs selecionadas que podem ser chamadas usando suas chaves de API do Firebase. Consulte estas perguntas frequentes sobre a lista de permissões para chaves de API do Firebase para saber como modificar essa lista.
Se você quiser continuar usando o Firebase AI Logic, mas com o Agent Platform Gemini API (formerly Vertex AI):
Acesse a página Gemini Developer API no console do Google Cloud e clique em Gerenciar.
Acesse a guia Métricas para verificar se a API não está sendo usada.
Se você ainda quiser desativar a API, clique em Desativar API na parte de cima da página.
Verifique se o projeto tem as APIs necessárias ativadas para o Agent Platform Gemini API (formerly Vertex AI).
Desativar as APIs associadas ao uso de Agent Platform Gemini API (formerly Vertex AI)
Para usar os SDKs do Firebase AI Logic com o Agent Platform Gemini API (formerly Vertex AI), seu projeto precisa ter as duas APIs a seguir ativadas:
- API do Agent Platform (
aiplatform.googleapis.com) - API do Firebase AI Logic (
firebasevertexai.googleapis.com)
Se você quiser parar de usar o Firebase AI Logic completamente:
Clique em cada link de API acima para acessar as respectivas páginas no console do Google Cloud e clique em Gerenciar.
Acesse a guia Métricas para verificar se a API não está sendo usada.
Se você ainda quiser desativar a API, clique em Desativar API na parte de cima da página.
Remova a API Firebase AI Logic da lista de APIs selecionadas que podem ser chamadas usando suas chaves de API do Firebase. Consulte estas perguntas frequentes sobre a lista de permissões para chaves de API do Firebase para saber como modificar essa lista.
Se você quiser continuar usando o Firebase AI Logic, mas com o Gemini Developer API:
Acesse a página da API Agent Platform no console do Google Cloud e clique em Gerenciar.
Acesse a guia Métricas para verificar se a API não está sendo usada.
Se você ainda quiser desativar a API, clique em Desativar API na parte de cima da página.
Verifique se o projeto tem as APIs necessárias ativadas para o Gemini Developer API.
Permissões necessárias para usar o Firebase AI Logic
| Ação | Permissões do IAM obrigatórias | Papéis do IAM que incluem as permissões necessárias por padrão |
|---|---|---|
| Fazer upgrade do faturamento para o plano de preços de pagamento por uso (Blaze) | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
Proprietário |
| Ativar APIs no projeto | serviceusage.services.enable |
Editor Proprietário |
| Criar app do Firebase | firebase.clients.create |
Administrador do Firebase Editor Proprietário |
Modelos compatíveis ao usar Firebase AI Logic
Consulte a lista de modelos compatíveis. Adicionamos novos recursos aos SDKs com frequência. Por isso, consulte estas perguntas frequentes para ver as atualizações (além de notas da versão, blogs e posts em redes sociais).
O Firebase AI Logic é compatível com os seguintes modelos:
Gemini Developer API
- A maioria dos modelos de fundação do Gemini
Agent Platform Gemini API (formerly Vertex AI)
- A maioria dos modelos de fundação do Gemini
O Firebase AI Logic não é compatível com os seguintes modelos (independentemente do provedor de Gemini API escolhido):
Modelos ajustados
Modelos de embedding, modelos do Veo, modelos do Lyria, modelos de robótica, modelos de uso de computador, modelos do Gemini Omni ou modelos do Gemini Cyber
Como definir um limite de taxa por usuário
Por padrão, o Firebase AI Logic define o limite de solicitações por usuário em 100 solicitações por minuto (RPM).
Se você quiser ajustar o limite de taxa por usuário, ajuste as configurações de cota da API Firebase AI Logic.
Saiba mais sobre a cota da API Firebase AI Logic. Nessa página, você também pode aprender a ver e editar sua cota.
Como reduzir a latência e o alto uso de tokens
Se você estiver enfrentando alta latência ou alto uso de tokens, é provável que isso se deva à configuração do nível de raciocínio do modelo que está usando.
Os modelos Gemini 3 e mais recentes sempre usam um "processo de pensamento" interno que melhora significativamente as habilidades de raciocínio e planejamento em várias etapas, tornando-os altamente eficazes para tarefas complexas, como programação, matemática avançada e análise de dados.
No entanto, dependendo da tarefa, nem sempre é necessário usar níveis mais altos de raciocínio, e você pode configurar o modelo para usar um nível mais baixo. Um nível de pensamento mais baixo ajuda a reduzir a latência e o uso de tokens. Para ajudar você a decidir o quanto um modelo pode precisar da capacidade de raciocínio, consulte a comparação de dificuldades de tarefas.
Para a maioria dos modelos Gemini 3 e mais recentes, o
nível de raciocínio padrão
é definido como HIGH.
Requisitos de tipo MIME para solicitações multimodais (como para imagens, PDFs, vídeos e entrada de áudio)
Em cada solicitação multimodal, você precisa fornecer o seguinte:
O
mimeTypedo arquivo. Confira uma exceção abaixo.O arquivo. É possível fornecer o arquivo como dados inline ou usando o URL dele.
Saiba mais sobre os tipos de arquivo de entrada compatíveis, como especificar o tipo MIME e as duas opções para fornecer o arquivo em Arquivos de entrada e requisitos compatíveis.
Exceção para incluir o tipo MIME na solicitação
Uma exceção ao fornecimento do tipo MIME são as entradas de imagem inline para solicitações de apps nativos para Android e Apple.
Os SDKs do Firebase AI Logic para plataformas Android e Apple oferecem uma maneira simplificada e compatível com a plataforma para processar imagens em solicitações. Todas as imagens (independentemente do formato) são convertidas no lado do cliente para JPEG com 80% de qualidade antes de serem enviadas ao servidor. Isso significa que, ao fornecer imagens como dados inline usando os SDKs das plataformas Android e Apple, não é necessário especificar o tipo MIME na solicitação.
Esse processamento simplificado é mostrado na documentação de Firebase AI Logic nos exemplos de envio de imagens codificadas em base64 em solicitações.
Confira algumas informações adicionais sobre esse recurso em plataformas específicas:
No Android:
É possível aproveitar a maneira simplificada de lidar com tipos de imagem nativos da plataforma (
Bitmap) em comandos multimodais que contêm imagens como dados inline (consulte o exemplo).Para ter mais controle sobre os formatos da imagem e as conversões, forneça as imagens como um
InlineDataParte o tipo MIME específico. Exemplo:content { inlineData(/* PNG as byte array */, "image/png") }
Para plataformas da Apple:
É possível aproveitar a maneira simplificada de lidar com tipos de imagem nativos da plataforma (
UIImage,NSImage,CIImageeCGImage) em comandos multimodais que contêm imagens como dados inline (consulte o exemplo).Para ter mais controle sobre os formatos da imagem e as conversões, forneça as imagens como um
InlineDataParte o tipo MIME específico. Exemplo:InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
Recursos avançados que ainda não estão disponíveis ao usar o Firebase AI Logic: embasamento com a Pesquisa de imagens do Google, ajuste de um modelo, geração de embeddings e recuperação semântica
Os recursos a seguir são compatíveis com vários modelos e provedores de API, mas não estão disponíveis ao usar Firebase AI Logic:
- Embasamento com a Pesquisa de Imagens do Google
- Ajustar um modelo
- Geração de embeddings
- Recuperação semântica
Se você quiser adicionar esses recursos como solicitações de recurso ou votar em uma solicitação de recurso existente, acesse o UserVoice do Firebase.
Uso de dados para treinar modelos
Consulte Governança de dados e IA responsável.
Perguntas frequentes sobre as mudanças
Esta seção contém perguntas frequentes relacionadas à descontinuação ou ao encerramento de modelos, bem como mudanças nas APIs, nos SDKs ou na nossa marca.
Modelos descontinuados ou encerrados (aposentados): lista e substituições
Quando o Google lança uma versão estável do modelo, nos esforçamos para mantê-la disponível por pelo menos 12 meses antes de desativar (retirar) o modelo.
No entanto, esteja ciente do seguinte:
Para o Agent Platform Gemini API (formerly Vertex AI), alguns modelos estáveis têm apenas disponibilidade de curto prazo, o que significa que eles podem ser desativados (descontinuados) em até 45 dias após o lançamento de um modelo de substituição.
Para o Gemini Developer API, às vezes, em vez de encerrar um modelo, o serviço encaminha automaticamente a solicitação para um modelo mais recente. As solicitações para o modelo mais recente são cobradas de acordo com as taxas dele.
Várias semanas antes da data de desativação, os projetos que não usaram um modelo antes serão impedidos de começar a usá-lo.
Quando uma versão estável é lançada para um determinado modelo, todas as versões experimentais e de pré-lançamento desse modelo geralmente são encerradas (desativadas) em alguns dias ou semanas. Estas perguntas frequentes não listam todos os modelos experimentais e de pré-lançamento anteriores.
Modelos de uso geral
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-3.7-flash 1
Data de lançamento: 13 de agosto de 2026 Estágio de lançamento: estável |
Solicitações roteadas para gemini-3.8-flash
Substituição: gemini-3.8-flash
|
Data de desativação: 28 de janeiro de 2027
Substituição: gemini-3.8-flash
|
gemini-3.6-flash 1
Data de lançamento: 21 de julho de 2026 Estágio de lançamento: estável |
Data da desativação: ---
Substituição: gemini-3.8-flash
|
Data de desativação: 19 de novembro de 2026
Substituição: gemini-3.8-flash
|
gemini-3.5-flash
Data de lançamento: 19 de maio de 2026 Estágio da versão: estável |
Solicitações roteadas para gemini-3.6-flash
Substituição: gemini-3.8-flash
|
Data da desativação: ---
Substituição: gemini-3.8-flash
|
gemini-3.1-pro-preview
Data de lançamento: 19 de fevereiro de 2026 Estágio de lançamento: pré-lançamento |
Data da desativação: ---
Substituição: gemini-4-hydrogen
|
Data da desativação: ---
Substituição: gemini-4-hydrogen
|
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.5-pro
Data de lançamento: 17 de junho de 2025 Estágio de lançamento: estável |
Solicitações encaminhadas para gemini-3.8-flash (a partir de 1º de dezembro de 2026)
Substituição: gemini-3.8-flash
|
Data de desativação: 20 de outubro de 2026
Substituição: gemini-3.8-flash
|
gemini-2.5-flash
Data de lançamento: 17 de junho de 2025 Estágio de lançamento: estável |
Solicitações encaminhadas para gemini-3.5-flash-lite (a partir de 1º de dezembro de 2026)
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 20 de outubro de 2026
Substituição: gemini-3.5-flash-lite
|
gemini-2.5-flash-lite
Data de lançamento: 22 de julho de 2025 Estágio de lançamento: estável |
Data da desativação: ---
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 20 de outubro de 2026
Substituição: gemini-3.5-flash-lite
|
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.0-flash-001
Data de lançamento: 5 de fevereiro de 2025 Estágio de lançamento: desativação |
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
gemini-2.0-flash
Data de lançamento: 10 de fevereiro de 2025 Estágio da versão: desativação |
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
gemini-2.0-flash-lite-001
Data de lançamento: 25 de fevereiro de 2025 Estágio de lançamento: desativação |
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
gemini-2.0-flash-lite
Data de lançamento: 25 de fevereiro de 2025 Estágio de lançamento: desativação |
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
Data de desativação: 1º de junho de 2026
Substituição: gemini-3.5-flash-lite
|
1 Para o Agent Platform Gemini API (formerly Vertex AI), esse é um "modelo de disponibilidade de curto prazo". Consulte Padrões de nomenclatura e controle de versões de modelos
Todos os seguintes modelos de uso geral também foram desativados:
gemini-1.0-pro,
gemini-1.0-pro-001,
gemini-1.0-pro-002,
gemini-1.0-pro-vision,
gemini-1.0-pro-vision-001
gemini-1.5-flash-001,
gemini-1.5-flash,
gemini-1.5-flash-002,
gemini-1.5-pro-001,
gemini-1.5-pro,
gemini-1.5-pro-002
Modelos de geração de imagens (Nano Banana e Imagen)
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-2.5-flash-image
Data de lançamento: 2 de outubro de 2025 Estágio de lançamento: desativação |
Data de desativação: 2 de outubro de 2026
Substituição: gemini-nano-banana-2.1
|
Data de desativação: 2 de outubro de 2026
Substituição: gemini-nano-banana-2.1
|
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
imagen-4.0-generate-001
Data de lançamento: 14 de agosto de 2025 Estágio de lançamento: desativação |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
imagen-4.0-fast-generate-001
Data de lançamento: 14 de agosto de 2025 Estágio de lançamento: desativação |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
imagen-4.0-ultra-generate-001
Data de lançamento: 14 de agosto de 2025 Estágio de lançamento: desativação |
Data de desativação: 30 de junho de 2026
Substituição: gemini-3-pro-image
|
Data de desativação: 30 de junho de 2026
Substituição: gemini-3-pro-image
|
imagen-3.0-capability-001
Data de lançamento: 10 de dezembro de 2024 Estágio de lançamento: desativação |
incompatível |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
imagen-3.0-generate-002
Data de lançamento: 23 de janeiro de 2025 Estágio de lançamento: desativação |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
imagen-3.0-generate-001
Data de lançamento: 31 de julho de 2024 Estágio de lançamento: desativação |
incompatível |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
imagen-3.0-fast-generate-001
Data de lançamento: 31 de julho de 2024 Estágio de lançamento: desativação |
incompatível |
Data de desativação: 30 de junho de 2026
Substituição: gemini-nano-banana-2.1
|
Áudio: modelos de conversão de texto em voz (TTS)
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-3.1-flash-tts-preview
Data de lançamento: 17 de junho de 2026 Estágio de lançamento: pré-lançamento |
Data de desativação: 17 de novembro de 2026
Substituição: gemini-3.8-flash-tts ou
gemini-3.8-flash-lite-tts
|
Data de desativação: 17 de novembro de 2026
Substituição: gemini-3.8-flash-tts ou
gemini-3.8-flash-lite-tts
|
Áudio: Live API modelos
| Modelo | Gemini Developer API | Agent Platform Gemini API |
|---|---|---|
gemini-live-2.5-flash-preview
Data de lançamento: 17 de junho de 2025 Estágio de lançamento: desativação |
Data de desativação: 9 de dezembro de 2025
Substituição: gemini-3.1-flash-live-preview
|
Data de desativação: 9 de dezembro de 2025
Substituição: gemini-live-2.5-flash-native-audio
|
gemini-2.0-flash-live-001
Data de lançamento: 9 de abril de 2025 Estágio de lançamento: desativação |
Data de desativação: 9 de dezembro de 2025
Substituição: gemini-3.1-flash-live-preview
|
Data de desativação: 9 de dezembro de 2025
Substituição: gemini-live-2.5-flash-native-audio
|
gemini-2.0-flash-live-preview-04-09
Data de lançamento: 9 de abril de 2025 Estágio de lançamento: desativação |
incompatível |
Data de desativação: 9 de dezembro de 2025
Substituição: gemini-live-2.5-flash-native-audio
|
Mudanças necessárias quando os modelos são descontinuados ou encerrados (aposentados)
Onde encontrar a data de desativação de um modelo?
Veja algumas maneiras de encontrar a data de desativação de um modelo:
O Google envia e-mails para os membros relevantes do projeto.
Publicamos avisos e lembretes sobre as próximas desativações em vários canais:
- Notas de lançamento (veja um exemplo)
- Banners no nível da página na documentação, na página de modelos compatíveis e nas perguntas frequentes sobre modelos descontinuados e encerrados.
O que fazer se o modelo que você está usando estiver prestes a ser desativado?
É necessário fazer essas mudanças antes da data de desativação. Caso contrário, todas as solicitações para um modelo desativado vão falhar com um erro 404.
Encontre um modelo com suporte e o nome do modelo.
Também fornecemos modelos de substituição recomendados nas Perguntas frequentes sobre modelos descontinuados e encerrados.
Atualize o nome do modelo usado pelo app.
Você define o nome do modelo durante a inicialização ao criar uma instância
GenerativeModel,LiveModelouImagenModel. Leia a recomendação importante abaixo sobre o uso de Firebase Remote Config ou modelos de comando do servidor.Verifique se você precisa atualizar algum código.
Normalmente, não é necessário modificar o código que chama o modelo. Confira algumas exceções:
Parâmetros de amostragem não compatíveis: os modelos Gemini 4.x e Gemini 3.x mais recentes não são compatíveis com vários parâmetros (especificamente temperatura, Top-K, Top-P, penalidade de frequência, penalidade de presença e contagem de candidatos).
Nível de raciocínio x orçamento de raciocínio: a partir dos modelos Gemini 3.x, use
thinkingLevelem vez dethinkingBudget(masthinkingBudgetainda é compatível com versões anteriores). No entanto, a partir dos modelos Gemini 4.x, othinkingBudgetnão é compatível. Saiba mais sobre o pensamento.Teste o valor do nível de raciocínio: ao fazer upgrade para uma nova geração (por exemplo, de 2.5 para 3.8) e quiser garantir o mesmo desempenho e comportamento (por exemplo, latência), recomendamos testar a configuração do nível de raciocínio com um valor mais baixo. Saiba mais sobre o pensamento.
Teste o app para garantir que as respostas ainda sejam as esperadas.
Mudanças necessárias para o rebranding de "Vertex AI" para "Plataforma de Agentes"
Em meados de 2026, o Google Cloud mudou o nome da "Vertex AI" para "Gemini Enterprise Agent Platform" (ou "Agent Platform"). No ecossistema do Firebase, chamamos esse serviço de "API Gemini da Agent Platform".
Para o Google Cloud, esse rebranding incluiu o seguinte. Houve outras mudanças, mas elas não são aplicáveis ao Firebase AI Logic.
Mudança do nome do produto de "Vertex AI" para "Gemini Enterprise Agent Platform" (ou "Agent Platform"), que inclui novos URLs para o console do Google Cloud e a documentação.
Mudança do nome de exibição da API de "API Vertex AI" para "API Agent Platform". O nome do serviço permaneceu o mesmo:
aiplatform.googleapis.com.Mudança de marca de "Vertex AI Studio" para "Agent Studio".
Não há mudanças nos recursos das APIs ou dos modelos compatíveis.
Para os SDKs do Firebase AI Logic, acomodamos esse rebranding atualizando a sintaxe de inicialização do serviço de back-end "Gemini API" e atualizando o local padrão para acessar o modelo ao usar essa nova sintaxe.
Nova sintaxe de inicialização para o serviço de back-end "Gemini API":
Swift
Altere
vertexAIparaagentPlatform.- A sintaxe
agentPlatformestá disponível a partir da v12.17.0+ do SDK. - A sintaxe
vertexAIfoi removida na versão 13.0.0 do SDK.
BEFORE
// ... // 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")) // ...AFTER
// ... // 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
Altere
vertexAIparaagentPlatform.- A sintaxe
agentPlatformestá disponível a partir da v17.15.0+ do SDK e da v34.17.0+ do Firebase Android BoM. - A sintaxe
vertexAIfoi removida na v18.0.0 do SDK e na v35.0.0 do BoM.
BEFORE
// ... // 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")) // ...AFTER
// ... // 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
Altere
vertexAIparaagentPlatform.- A sintaxe
agentPlatformestá disponível a partir da v17.15.0+ do SDK e da v34.17.0+ do Firebase Android BoM. - A sintaxe
vertexAIfoi removida na v18.0.0 do SDK e na v35.0.0 do BoM.
BEFORE
// ... // 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")); // ...AFTER
// ... // 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
Altere
VertexAIBackendparaAgentPlatformBackend.- A sintaxe
AgentPlatformBackendestá disponível a partir da versão 12.17.0+ do SDK do Firebase para JS. - A sintaxe
VertexAIBackendfoi removida na versão 13.0.0 do SDK.
BEFORE
import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai"; // ... // 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') }); // ...AFTER
import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai"; // ... // 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
Altere
vertexAIparaagentPlatform.- A sintaxe
agentPlatformestá disponível a partir da v3.15.0+ do plug-in e da v4.18.0+ da BoM do Firebase para Flutter. - A sintaxe
vertexAIfoi removida na v5.0.0 do plug-in e na v5.0.0+ da BoM do Firebase para Flutter.
BEFORE
// ... // 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'); // ...AFTER
// ... // 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
Altere
VertexAIparaAgentPlatform.- A sintaxe
AgentPlatformestá disponível a partir do SDK do Firebase para Unity v13.15.0+. - A sintaxe
VertexAIfoi removida na versão 14.0.0 do SDK.
BEFORE
// ... // 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")); // ...AFTER
// ... // 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")); // ...- A sintaxe
Novo local padrão para acessar o modelo ao usar a nova sintaxe de inicialização:
Ao usar a nova sintaxe de inicialização "Agent Platform", o local padrão é
global.Essa mudança foi feita porque quase todos os modelos Gemini são compatíveis com
global, e o Google Cloud não oferece mais suporte ao localus-central1para novas versões da maioria dos modelos Gemini.
Para apps Swift: mudanças necessárias para migrar de FirebaseAI para FirebaseAILogic
Para apps de plataformas da Apple, a partir do SDK do Firebase v12.5.0,
o Firebase AI Logic é distribuído no módulo FirebaseAILogic. No SDK
v13.0.0, o módulo FirebaseAI foi removido.
Por que fizemos essa mudança?
Anteriormente, distribuíamos esse serviço no módulo FirebaseAI. No entanto, precisamos
renomeá-lo para FirebaseAILogic pelos seguintes motivos:
Evite uma colisão de nomes entre o módulo e a classe que causa problemas em distribuições binárias.
Permitir o uso de macros do Swift para o desenvolvimento de recursos futuros.
O que fazer se você estiver fazendo upgrade para a v12.5.0+ ou v13.0.0+?
No Firebase 12 (a partir da v12.5.0+), a mudança do nome do módulo para
FirebaseAILogic não causa interrupções e é compatível com versões anteriores. Portanto, essas mudanças são
recomendadas no Firebase 12. No entanto, no SDK do Firebase v13.0.0, o módulo
FirebaseAI antigo foi removido. Portanto, essas mudanças são obrigatórias ao
fazer upgrade para o Firebase 13.
Ao escolher as dependências do Swift PM, escolha
FirebaseAILogic(em vez deFirebaseAI).Mude as instruções de importação para
FirebaseAILogic(em vez deFirebaseAI).
Entenda a mudança de nome de "Vertex AI in Firebase" para "Firebase AI Logic"
Em 2024, lançamos um conjunto de SDKs de cliente do Firebase que podiam usar a Agent Platform Gemini API (formerly Vertex AI), além de um gateway de proxy do Firebase para proteger essa API contra abusos e permitir integrações com outros produtos do Firebase. Chamamos nosso produto de "Vertex AI no Firebase", e esse nome descrevia com precisão os casos de uso disponíveis do produto na época.
No entanto, desde então, expandimos os recursos do nosso produto. Por exemplo, desde maio de 2025, oferecemos suporte para o Gemini Developer API, incluindo a capacidade de proteger o Gemini Developer API contra abusos usando nossa integração com o Firebase App Check.
Como resultado, o nome "Vertex AI no Firebase" não representa mais com precisão o escopo ampliado do nosso produto. Assim, um novo nome, Firebase AI Logic, reflete melhor nosso conjunto de atributos em evolução e nos permite continuar expandindo nossas ofertas no futuro.
Confira o guia de migração para garantir que você tenha todos os recursos mais recentes do Firebase AI Logic (e, se quiser, comece a usar o Gemini Developer API).
Perguntas frequentes sobre segurança
As seções a seguir contêm perguntas frequentes relacionadas à segurança, por exemplo, sobre App Check ou sobre chaves de API do Gemini.
Perguntas frequentes sobre o Firebase App Check
Aplicação obrigatória de App Check para todas as versões de um app
A App Check precisa ser aplicada a todas as versões do app que usam Firebase AI Logic.
É fundamental que o App Check seja aplicado o mais cedo possível, especialmente antes de confirmar o app em um sistema de controle de código-fonte disponível publicamente, compartilhar o app ou disponibilizá-lo publicamente.
Se você implementar o App Check na base de código do app imediatamente, todas as versões dele poderão enviar tokens App Check válidos. Uma solicitação que não envia um token válido é considerada não verificada e será bloqueada quando App Check for aplicado.
Se você já lançou uma versão do seu app para usuários finais que não tem o App Check implementado, consulte as perguntas frequentes sobre como implementar e aplicar o App Check em um app já lançado.
Adiar a aplicação automática de App Check para Firebase AI Logic
A partir de 2 de novembro de 2026, o Firebase vai aplicar automaticamente o Firebase App Check para o Firebase AI Logic no seu projeto do Firebase (se ainda não tiver sido aplicado).
Quando o App Check é aplicado, todas as solicitações para Firebase AI Logic sem um token App Check válido são bloqueadas. Isso inclui versões de apps lançadas que não têm um provedor de atestado de produção implementado.
Se você lançou versões do app que não têm o App Check implementado, é possível atrasar temporariamente a aplicação automática do App Check para Firebase AI Logic. No entanto, antes de 21 de janeiro de 2027, é fundamental que você trabalhe para implementar e aplicar o App Check nos apps já lançados.
Veja como atrasar a aplicação automática de App Check para Firebase AI Logic:
No console do Firebase, acesse a guia Segurança > App Check > APIs.
Encontre a linha de Firebase AI Logic.
No final da linha, encontre o seletor de data Aplicar: com o ícone
editEditar .Selecione a data em que você quer que o App Check seja aplicado automaticamente ao Firebase AI Logic.
A última data possível é 21 de janeiro de 2027. Depois dessa data, não será possível atrasar a aplicação automática de App Check para Firebase AI Logic.
Clique em Salvar.
Como implementar e aplicar o App Check em um app que já foi lançado
Para versões de apps que não têm o App Check implementado, as solicitações para Firebase AI Logic dessas versões não têm tokens App Check válidos e são consideradas não verificadas. Essas solicitações serão bloqueadas quando App Check for aplicado a Firebase AI Logic.
As instruções a seguir ajudam a migrar o app para que você possa aplicar App Check de uma forma que evite interrupções de serviço em um app já lançado que não tenha App Check.
Adiar a aplicação automática de App Check para Firebase AI Logic:
No console do Firebase, acesse a guia Segurança > App Check > APIs.
Encontre a linha de Firebase AI Logic.
No final da linha, encontre o seletor de data Aplicar: com o ícone
editEditar .Selecione a data em que você quer que o App Check seja aplicado automaticamente ao Firebase AI Logic.
A última data possível é 21 de janeiro de 2027. Após essa data, não será possível adiar a aplicação automática de App Check para Firebase AI Logic.
Clique em Salvar.
Implemente um provedor de atestado de produção no app o mais rápido possível.
- Plataformas da Apple: DeviceCheck ou App Attest ou reCAPTCHA Enterprise
- Android: Play Integrity ou reCAPTCHA Enterprise
- Web: reCAPTCHA Enterprise
- Flutter: oferece suporte a todos os provedores acima, incluindo reCAPTCHA Enterprise.
- Unity: compatível com todos os provedores acima (em breve, compatível com reCAPTCHA Enterprise)
Monitore as solicitações do seu app para ajudar a decidir quando é seguro aplicar o App Check.
Por exemplo, se quase todas as solicitações recentes forem de clientes verificados, considere aplicar o App Check.
Para o desenvolvimento local quando o App Check é aplicado, é possível configurar o provedor de depuração do App Check e ainda manter o App Check aplicado para o Firebase AI Logic.
Perguntas frequentes sobre a chave de API do Gemini
Entenda os upgrades de segurança (meados de 2026) para o Gemini Developer API e o Firebase AI Logic
No passado, o Gemini Developer API dependia de chaves de API padrão do Gemini para autorizar o uso do Gemini Developer API (generativelanguage.googleapis.com). Se você ativou o Firebase AI Logic e escolheu usar o Gemini Developer API, o Firebase criou uma chave de API do Gemini para você que era restrita ao Gemini Developer API.
Essa chave foi chamada de
Gemini Developer API key (auto created by Firebase)
A partir de meados de 2026, o Gemini Developer API será atualizado para uma alternativa mais segura chamada "chaves de autorização (autenticação)" (que são essencialmente contas de serviço). Firebase AI Logic foi atualizado em
conjunto. Em vez de usar uma chave de API padrão do Gemini,
o Firebase AI Logic agora processa a autorização para o
Gemini Developer API usando uma conta de serviço gerenciada pelo Google (P4SA) que
provisionamos automaticamente para você:
Firebase AI Logic Service Agent
(service-PROJECT_ID@
Para projetos novos e atuais, se você acessar o Gemini Developer API pelo Firebase AI Logic, não será necessário fazer nada para aproveitar essas atualizações de segurança a partir de meados de 2026.
Como migrar uma chave de API do Gemini para uma "chave de autorização"
Para projetos novos e atuais, se você acessar o Gemini Developer API pelo Firebase AI Logic, não será necessário fazer nada para aproveitar os upgrades de segurança de meados de 2026 (incluindo a migração para uma "chave de autorização (auth)").
Em nome dos nossos desenvolvedores, o Firebase AI Logic está lidando automaticamente com todas as mudanças de segurança necessárias para acomodar a transição do Gemini Developer API para exigir "chaves de autorização (autenticação)".
A partir de meados de 2026, o Firebase AI Logic não vai mais provisionar nem usar chaves de API padrão do Gemini. Em vez disso, o Firebase AI Logic agora processa
a autorização para o Gemini Developer API usando uma
conta de serviço gerenciada pelo Google (P4SA) que provisionamos automaticamente para você no
seu projeto do Firebase:
Agente de serviço do Firebase AI Logic
(service-PROJECT_ID@
Com essa mudança, você pode revisar e excluir qualquer chave de API chamada
Gemini Developer API key (auto created by Firebase)
-
Esta chave de API do Gemini foi criada pelo Firebase com o único propósito
de ser usada com o Firebase AI Logic. Portanto, é seguro excluí-la.
No entanto, antes de excluir essa chave, verifique se
você não a usou por engano com outras ferramentas que podem dar
acesso ao Gemini Developer API, como os SDKs do servidor de IA generativa ou o
Genkit. Veja como verificar o uso:
- No console do Google Cloud, acesse a página do Gemini Developer API e clique em Gerenciar.
-
Na guia Métricas, no menu suspenso Credenciais, selecione
a chave chamada
.Gemini Developer API key (auto created by Firebase) -
Se os gráficos exibidos não mostrarem uso desde o início de julho de 2026 (quando
o Firebase AI Logic parou de usar essas chaves de API), a
chave poderá ser excluída com segurança.
No entanto, se os gráficos mostrarem uso, você está usando a chave com outra ferramenta e deve renomear a chave para que fique claro que ela está sendo usada com essa ferramenta (e não com Firebase AI Logic).
-
Não exclua nenhuma outra chave de API com um nome que contenha o segmento
.(auto created by Firebase)
Não adicione uma chave de API do Gemini à base de código de um app da Web ou para dispositivos móveis.
Ao usar os SDKs do Firebase AI Logic, você não precisa de uma chave de API do Gemini para autorizar o uso do Gemini Developer API e não deve adicionar uma chave de API do Gemini à base de código do seu app.
Não use uma "chave de API do Firebase" como uma chave de API do Gemini.
Nunca use sua "chave de API do Firebase" como uma chave de API do Gemini. Recomendamos que você não adicione a Gemini Developer API à lista de permissões da sua chave de API do Firebase.
A chave de API do Firebase é a chave de API listada no arquivo ou objeto de configuração do Firebase que você adiciona à base de código do app para conectá-lo ao Firebase. Não há problema em incluir sua chave de API do Firebase no código quando você usa a chave apenas com APIs relacionadas ao Firebase (como Firebase AI Logic). Saiba mais sobre as chaves de API do Firebase.
No painel APIs e serviços > Credenciais do console do Google Cloud, as chaves de API do Firebase são mostradas assim:

Como é necessário adicionar a chave de API do Firebase à base de código do app para que as APIs relacionadas ao Firebase funcionem, e como a Gemini Developer API pode ser autorizada por meio da chave de API, recomendamos que você NÃO adicione a Gemini Developer API (chamada de "API Generative Language" no console do Google Cloud) à lista de permissões da chave de API do Firebase. Se fizer isso, você vai expor o Gemini Developer API a possíveis abusos.
Como manter uma chave de API do Gemini segura
Enviar feedback sobre sua experiência com o Firebase AI Logic