Criar apps no Google AI Studio

Esta página descreve como usar o Google AI Studio para criar (ou "programar") e implantar rapidamente apps que testam os recursos mais recentes do Gemini, como o Nano Banana e a API Live. O Google AI Studio agora oferece suporte a ambientes de execução full stack, permitindo que você crie aplicativos robustos com lógica do lado do servidor, gerenciamento de secrets seguro e suporte a pacotes npm, tudo usando comandos em linguagem natural prompting.

Primeiros passos

Comece a programar no modo de criação do Google AI Studio. Você pode começar a criar de algumas maneiras:

  • Comece com um comando: no modo de criação, use a caixa de entrada para inserir uma descrição do que você quer criar. Selecione "Chips de IA" para adicionar recursos específicos, como geração de imagens ou dados do Google Maps, ao comando. Você pode até dizer o que quer usando o botão de fala para texto.
  • Botão "Estou com sorte": se você precisar de uma inspiração criativa, use o botão "Estou com sorte" e o Gemini vai gerar um comando com uma ideia de projeto para você começar.
  • Remixe um projeto da galeria: abra um projeto na Galeria de apps e selecione Copiar app.

Depois de executar o comando, o código e os arquivos necessários serão gerados, com uma prévia em tempo real do seu app aparecendo no lado direito.

O que é criado?

Quando você executa o comando, o AI Studio cria um aplicativo completo. Por padrão, ele cria um ambiente full stack que pode incluir:

  • Lado do cliente: um front-end da Web (o React é o padrão).
  • Do lado do servidor: um ambiente de execução do Node.js que permite chamadas de API seguras, conexões de banco de dados e uso de pacotes npm.

Você pode conferir o código gerado selecionando a guia Código no painel de visualização à direita. O agente Antigravity gerencia de forma inteligente vários arquivos na sua pilha, garantindo que as mudanças sejam propagadas corretamente.

O agente Antigravity

O agente Antigravity é a principal funcionalidade de IA no Google Antigravity. Agora, os componentes principais do harness do agente estão alimentando a experiência do modo de criação no Google AI Studio. Ele vai além da simples geração de código, mantendo o contexto de todo o projeto, gerenciando vários arquivos e entendendo instruções complexas para criar aplicativos full stack robustos.

As principais capacidades incluem:

  • Consciência de contexto: mantém o contexto de comandos e estados de arquivos anteriores.
  • Gerenciamento de vários arquivos: processa dependências em vários arquivos.
  • Execução verificada: verifica atualizações de código para reduzir alucinações.

Recursos full stack

O Google AI Studio libera o poder do ecossistema da Web moderna, permitindo que você crie mais do que apenas protótipos do lado do cliente.

  • Ambiente de execução do lado do servidor e npm: use a vasta biblioteca de pacotes npm. O agente vai identificar e instalar automaticamente os pacotes necessários para seu app (por exemplo, bibliotecas específicas para visualização de dados ou clientes de API). Você também pode solicitar pacotes específicos, se quiser.
  • Gerenciamento de secrets: armazene chaves de API e secrets com segurança no menu Configurações. Eles podem ser acessados no código do lado do servidor, mantendo-os protegidos contra exposição do lado do cliente.
  • Multiplayer: crie experiências colaborativas em tempo real diretamente no AI Studio. O ambiente de execução do lado do servidor gerencia o estado e as conexões necessárias para que os usuários interajam.
  • Integração do Firebase: provisione e configure automaticamente o Firebase, incluindo o banco de dados do Firestore (armazenamento de dados persistente) e a autenticação do Firebase (fluxos de login, especificamente "Fazer login com o Google"). O agente processa todo o processo de configuração e até mesmo grava o código no seu app para esses serviços.

Saiba mais sobre o desenvolvimento de apps full stack

Continuar criando

Depois que o Google AI Studio gerar o código inicial do seu aplicativo, você poderá continuar refinando-o:

Crie no Google AI Studio

  • Itere com o Gemini: use o painel de chat no modo de criação para pedir ao Gemini que faça modificações, adicione novos recursos ou mude o estilo.
  • Edite o código diretamente: abra a guia Código no painel de visualização para fazer edições em tempo real.

Desenvolver externamente

Para fluxos de trabalho mais avançados, você pode exportar o código e trabalhar no ambiente preferido:

  • Faça o download e desenvolva localmente: exporte o código gerado como um arquivo ZIP e importe-o para o editor de código.
  • Envie para o GitHub: integre o código aos processos de desenvolvimento e implantação atuais enviando-o para um repositório do GitHub.

Principais recursos

O Google AI Studio inclui vários recursos para tornar o processo de criação intuitivo e visual:

  • Crie e itere em apps full stack: crie apps full stack com apenas um comando e itere pelo chat ou pelo modo de anotação. O modo de anotação permite destacar qualquer parte da interface do app e descrever a mudança desejada.
  • Compartilhe e implante seu app: você pode compartilhar suas criações com outras pessoas para colaborar ou mostrar seu trabalho. Ao compartilhar, as chamadas de API são contabilizadas nos limites de uso. Se você usar modelos pagos, custos poderão ser aplicados. Quando o app estiver pronto, implante-o no Cloud Run.
  • Galeria de apps: a galeria de apps oferece uma biblioteca visual de ideias de projetos. Você pode navegar pelo que é possível fazer com o Gemini, visualizar aplicativos instantaneamente e remixá-los para personalizá-los.

Implantar ou arquivar o app

Quando o aplicativo estiver pronto, você poderá implantá-lo:

  • Cloud Run: implante o aplicativo como um serviço escalonável. Os preços do Google Cloud Run podem ser aplicados com base no uso. Para saber mais sobre a implantação, consulte Como implantar no Google AI Studio.

  • GitHub: exporte seu projeto para um repositório do GitHub.

Limitações

Esta seção lista as limitações atuais do modo de criação no Google AI Studio.

Gerenciamento de chaves de API

Quando você cria um novo app que usa a API Gemini, o AI Studio configura automaticamente a chave da API Gemini como um secret no ambiente do lado do servidor do app. Você pode visualizar e gerenciar essa chave no painel Secrets.

  • Configuração automática: seu GEMINI_API_KEY é configurado para você. Nenhuma configuração manual é necessária para começar a criar.
  • Somente do lado do servidor: as chaves de API são injetadas no ambiente de execução do lado do servidor e nunca são incluídas no código do lado do cliente.
  • Apps atuais: para apps criados antes de 14 de maio de 2026, o agente vai atualizar automaticamente a integração da API Gemini para a abordagem recomendada do lado do servidor na próxima vez que você modificar os recursos do Gemini do app.

Implantação fora do Google AI Studio

  • Cloud Run: quando você implanta no Cloud Run pelo AI Studio, a chave de API é incluída com segurança no ambiente do lado do servidor. O app implantado vai usar a chave de API para todas as chamadas da API Gemini dos usuários.
  • Download de ZIP: se você baixar o app como um arquivo ZIP para executá-lo em outro lugar, será necessário configurar a variável de ambiente GEMINI_API_KEY no ambiente de hospedagem. Como as chamadas da API Gemini do app são feitas pelo código do lado do servidor, a chave não é exposta aos usuários finais.

Erro ao compartilhar apps

Se você compartilhar o app e o usuário final encontrar um erro 403 Acesso restrito ao usar o URL compartilhado, isso poderá ser devido a um dos seguintes motivos:

  • Extensões do navegador: extensões de privacidade, como o Privacy Badger, podem estar bloqueando o app. Desative a extensão para evitar o erro.
  • Problemas de build: pode haver problemas com o código atual. Peça ao agente para "corrigir problemas de build com o código atual" e compartilhe o URL novamente.

Perguntas frequentes

O que é o Build no AI Studio?

O Build do AI Studio é uma plataforma projetada para levar você de um comando simples a um aplicativo com tecnologia de IA pronto para produção usando o Gemini. Descreva o que você quer criar com um comando, e o Gemini vai gerar um app para você. Você também pode explorar nossa galeria para conferir o que é possível fazer com a API Gemini e remixar apps para personalizá-los.

Como o Build processa minha chave da API Gemini?

Quando você cria um app que usa a API Gemini, o AI Studio configura automaticamente a chave da API Gemini como um secret do lado do servidor. As chamadas da API Gemini do app são feitas pelo código do lado do servidor usando essa chave, então ela nunca é exposta no navegador. Você pode conferir a chave de API no painel Secrets em "Configurações".

Minha chave de API é exposta ao compartilhar apps?

Não. A chave de API é armazenada como um secret do lado do servidor e nunca é incluída no código do lado do cliente. Quando você compartilha o app, outros usuários podem usá-lo, mas não podem ver a chave de API.

Ao compartilhar seus apps com outras pessoas, as chamadas de API são contabilizadas nos limites de uso. Se você usar modelos pagos, custos poderão ser aplicados. O AI Studio vai avisar durante a configuração e antes de você compartilhar se o app pode gerar custos.

Quem pode ver meus apps?

Por padrão, o app é particular. Você pode compartilhar o app com outros usuários para que eles possam usá-lo. Os usuários com quem você compartilha o app podem ver o código e fazer um fork para os próprios fins. Se você compartilhar o app com permissão de edição, os outros usuários poderão editar o código do app.

Posso executar apps fora do AI Studio?

Sim. Você pode implantar o app no Cloud Run pelo AI Studio, o que dá ao app um URL público com a chave de API configurada com segurança no ambiente do lado do servidor. Você também pode baixar o app como um arquivo ZIP e hospedá-lo em outro lugar. Será necessário definir a variável de ambiente GEMINI_API_KEY no ambiente de hospedagem. Como as chamadas da API Gemini são feitas pelo código do lado do servidor, a chave permanece segura.

Para saber mais sobre as opções de implantação, consulte Como implantar no Google AI Studio.

Posso desenvolver apps localmente com minhas próprias ferramentas e compartilhá-los aqui?

Essa funcionalidade ainda não está disponível. Estamos animados para oferecer suporte a mais casos de uso para apps no futuro. Envie feedback se tiver algo específico em mente.

Como posso usar um banco de dados ou outro armazenamento com meus apps?

Os apps do AI Studio são apps padrão executados em um contêiner do Cloud Run. Você pode usar qualquer solução de armazenamento que possa se conectar a uma rede, desde que não haja um firewall que impeça o acesso de um intervalo de IP dinâmico.

Estamos trabalhando para adicionar suporte direto ao armazenamento no futuro, que poderá ser configurado diretamente no AI Studio.

Para garantir que os espectadores estejam cientes do uso da webcam ou de outros dispositivos de um app, exigimos um reconhecimento extra antes que o app possa acessar essas APIs do navegador. Os criadores de apps podem adicionar essas solicitações de permissão ao arquivo metadata.json do app. Exemplo:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

Os valores aceitos para requestFramePermissions são um subconjunto dos recursos padrão controlados pela política.

Como posso usar o GitHub com meus apps?

A integração do GitHub do AI Studio permite criar um repositório para seu trabalho e confirmar as mudanças mais recentes. No momento, não oferecemos suporte ao pull de mudanças remotas.

Posso conceder acesso de edição a outros usuários no meu app?

Isso ainda não é possível, mas será em breve.

Por que meu app foi sinalizado por violação da política?

Temos sistemas que analisam automaticamente os apps para garantir que eles estejam em conformidade com nossas políticas. Se encontrarmos um app que viola nossas políticas, ele será removido do AI Studio. As violações de políticas podem incluir, entre outras:

  • Apps que contêm malware, phishing ou falsificação de identidade
  • Apps que mostram ou distribuem conteúdo que viola a política de imagens de abuso sexual infantil
  • Apps que mostram ou distribuem conteúdo que viola a política de assédio
  • Apps que mostram ou distribuem conteúdo que viola a política contra discurso de ódio
  • Apps que mostram ou distribuem conteúdo que viola a política de tráfico humano
  • Apps que mostram ou distribuem conteúdo que viola a política de conteúdo sexualmente explícito
  • Apps que mostram ou distribuem conteúdo que viola a política de violência e imagens sangrentas
  • Apps que mostram ou distribuem conteúdo que viola a política nociva ou perigosa

Se o app foi sinalizado por uma violação da política e você acredita que isso ocorreu por engano, envie uma contestação. Violações recorrentes das nossas políticas podem resultar no encerramento do seu acesso ao AI Studio.

Quais são minhas responsabilidades como desenvolvedor de apps?

Como proprietário do aplicativo, você é responsável pelo comportamento dele e por todos os dados que ele processa. Isso inclui:

  • Conformidade legal e direitos de terceiros:garantir que o app esteja em conformidade com todas as leis e regulamentações aplicáveis e não viole os direitos de outras pessoas, incluindo direitos de propriedade intelectual e direitos de privacidade.
  • Monitoramento de conteúdo: a conformidade com termos adicionais pode ser aplicada a outros serviços usados pelo app. Por exemplo, os Termos de Serviço do Google Cloud, aplicáveis ao Firestore, exigem que os clientes que hospedam conteúdo de terceiros publiquem políticas que definam o conteúdo proibido (por exemplo, conteúdo ilegal) e monitorem a presença desse conteúdo ilegal.
  • Implementação segura:implementar as proteções e ferramentas de moderação necessárias para evitar o uso indevido do aplicativo.

Esteja ciente das restrições de uso nos Termos de Serviço.

Os Termos Adicionais de Serviço da API Gemini se aplicam ao uso de apps apresentados na galeria de apps do AI Studio, salvo indicação em contrário.

A seguir