Comece a usar a IA integrada

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado em 12 de dezembro de 2024. Última atualização: 20 de maio de 2025

Com as APIs de IA integradas, seu aplicativo da Web pode realizar tarefas com tecnologia de IA sem precisar implantar ou gerenciar os próprios modelos de IA. Estamos trabalhando para padronizar essas APIs em todos os navegadores.

Requisitos

Para usar a IA integrada, há requisitos de modelo e hardware.

Modelos

As APIs Translator e Language Detector usam modelos especializados. Todas as outras APIs usam um modelo de linguagem projetado para ser executado localmente em computadores e laptops.

As APIs Summarizer, Writer, Rewriter e Proofreader só são compatíveis com a modalidade de texto para texto. A API Prompt tem recursos multimodais.

Gemini Nano no Chrome

No Chrome, o modelo de linguagem é o Gemini Nano. O Gemini Nano não está disponível em dispositivos móveis.

A partir do Chrome 140, o Gemini Nano oferece suporte a inglês, espanhol e japonês para entrada e saída de texto.

Antes de usar as APIs de IA integradas, confirme que você leu e concorda com a Política de uso proibido da IA generativa do Google.

Hardware

Os desenvolvedores e usuários que operam recursos usando essas APIs no Chrome precisam atender aos seguintes requisitos. Outros navegadores podem ter requisitos operacionais diferentes.

As APIs Language Detector e Translator funcionam no Chrome em computadores. Essas APIs não funcionam em dispositivos móveis. As APIs Prompt, Summarizer, Writer, Rewriter e Proofreader funcionam no Chrome quando as seguintes condições são atendidas:

  • Sistema operacional: Windows 10 ou 11; macOS 13 ou mais recente (Ventura e versões posteriores); Linux; ou ChromeOS (da plataforma 16389.0.0 em diante) em dispositivos Chromebook Plus. O Chrome para Android, iOS e ChromeOS em dispositivos que não são Chromebook Plus ainda não é compatível com as APIs que usam o Gemini Nano.
  • Armazenamento: pelo menos 22 GB de espaço livre no volume que contém seu perfil do Chrome.
  • GPU: mais de 4 GB de VRAM.
  • Rede: dados ilimitados ou uma conexão ilimitada.

O tamanho exato do Gemini Nano pode variar conforme o navegador atualiza o modelo. Para determinar o tamanho atual, acesse chrome://on-device-internals.

Comece a criar

Há várias APIs de IA integradas disponíveis em diferentes estágios de desenvolvimento. Alguns estão na versão estável do Chrome, outros estão disponíveis para participantes dos testes de origem, e outros estão disponíveis apenas para participantes do Programa de prévia antecipada.

Cada API tem um conjunto de instruções para começar e baixar o modelo, tanto para prototipagem local quanto em ambientes de produção com os testes de origem.

Todas essas APIs podem ser usadas ao criar extensões do Chrome.

Download do modelo

As APIs e os modelos são integrados ao Chrome. Na primeira vez que um usuário interage com essas APIs, o modelo precisa ser baixado para o navegador.

Para determinar se uma API está pronta e pode ser usada, chame a função assíncrona availability(), que retorna uma promessa com um dos seguintes valores:

  • "unavailable": o dispositivo do usuário ou as opções de sessão solicitadas não são compatíveis. O dispositivo pode não ter energia ou espaço em disco suficientes.
  • "downloadable": são necessários outros downloads para criar uma sessão, que pode incluir um modelo especializado, um modelo de linguagem ou ajuste refinado. A ativação do usuário pode ser necessária para chamar create().
  • "downloading": os downloads estão em andamento e precisam ser concluídos antes que você possa usar uma sessão.
  • "available": você pode criar uma sessão imediatamente.

Ativação de usuário

Se o dispositivo puder oferecer suporte às APIs de IA integradas, mas o modelo ainda não estiver disponível, será necessária uma interação do usuário para iniciar uma sessão com o create().

Use a propriedade UserActivation.isActive para confirmar uma ativação do usuário, que pode ser um clique, um toque ou uma tecla pressionada.

// Check for user activation.
if (navigator.userActivation.isActive) {
  // Create an instance of a built-in API
}

Por exemplo, com a API Summarizer, você pode pedir aos usuários para interagir com um botão que diz "Resumir" para ativar Summarizer.create().

Usar APIs no localhost

Todas as APIs estão disponíveis em localhost no Chrome.

  1. Acesse chrome://flags/#prompt-api-for-gemini-nano-multimodal-input.
  2. Selecione Ativado.
  3. Clique em Reiniciar ou reinicie o Chrome.

Para confirmar se o Gemini Nano foi baixado e funciona conforme o esperado, abra o DevTools e digite await LanguageModel.availability(); no console. (isso retornará o código available)

Resolver problemas do localhost

Se o modelo não funcionar como esperado, siga estas etapas:

  1. Reinicie o Chrome.
  2. Acesse chrome://on-device-internals.
  3. Selecione a guia Status do modelo e verifique se não há erros.
  4. Abra o DevTools e digite LanguageModel.availability(); no console. Isso vai retornar available.

Se necessário, aguarde um pouco e repita essas etapas.

Processo de padrões

Estamos trabalhando para padronizar essas APIs, para que elas funcionem em todos os navegadores. Isso significa que propusemos as APIs à comunidade de plataformas da Web e as movemos para o W3C Web Incubator Community Group (em inglês) para mais discussões.

Estamos pedindo feedback do W3C, da Mozilla e do WebKit para cada API.

Engajamento e como compartilhar feedback

Se você testar a IA integrada e tiver feedback, envie sua opinião.