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.

Modelos necessários

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ó oferecem suporte à modalidade texto-para-texto. A API Prompt tem recursos multimodais.

Modelos do Chrome

O Chrome usa modelos de linguagem especializados e de base. Esses modelos não estão disponíveis em dispositivos móveis.

A partir do Chrome 149, os modelos oferecem suporte a inglês, espanhol, japonês, alemão e francês para texto de entrada e saída.

Hardware necessário

Os requisitos a seguir existem para desenvolvedores e usuários que operam recursos usando essas APIs no Chrome. Outros navegadores podem ter requisitos operacionais diferentes.

As APIs Language Detector e Translator funcionam no Chrome para computador. Essas APIs não funcionam em dispositivos móveis.

A API Prompt, a API Summarizer, a API Writer, a API Rewriter e a API Proofreader funcionam no Chrome quando as condições a seguir 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 Google 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 modelos de base.
  • Armazenamento: pelo menos 22 GB de espaço livre no volume que contém seu perfil do Chrome.
  • GPU ou CPU: os modelos integrados podem ser executados com GPU ou CPU.
    • GPU: estritamente mais de 4 GB de VRAM.
    • CPU: 16 GB de RAM ou mais e 4 núcleos de CPU ou mais.
    • Observação: a API Prompt com entrada de áudio requer uma GPU.
  • 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 no Chrome Stable, outros estão disponíveis para participantes dos testes de origem, e outros estão disponíveis apenas para participantes do Programa de testes.

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 na criação de 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.

Algumas APIs exigem opções extras ao chamar a disponibilidade. Por exemplo, a API Prompt exige a declaração de suporte a idiomas:

// Makes sure the model is available for English and Japanese input text,
// supports image input, and can generate English output.
await LanguageModel.availability({
  expectedInputs: [{type: "text", languages: ["en", "ja"]}, {type: "image"}],
  expectedOutputs: [{type: "text", languages: ["en"]}],
});

Ativação do usuário

Se o dispositivo for compatível com APIs de IA integradas, mas o modelo ainda não tiver sido baixado (ou seja, quando a chamada availability() retorna "downloadable" ou "downloading"), o usuário precisará interagir de forma significativa com sua página para que o aplicativo inicie uma sessão com create().

Use a propriedade UserActivation.isActive para confirmar se um usuário interagiu diretamente com a página desde que ela terminou de carregar. Isso pode incluir um toque, clique, pressionamento de tecla, mousedown ou outros eventos de ativação fixos.

// 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() ou criar o resumo assim que um usuário começar a digitar, um evento keydown.

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 Estado do broker 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.