Comece a usar a IA integrada

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado em 12 de dezembro de 2024, atualizado pela última vez em 20 de maio de 2025

Com 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 de especialistas. 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 de texto para texto. A API Prompt tem recursos multimodais.

Modelos do Chrome

O Chrome usa modelos de linguagem de especialistas e de fundação. 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 estas 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.

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 mais recentes); Linux; ou ChromeOS (da plataforma 16389.0.0 e versões mais recentes) em Chromebook Plus dispositivos. O Google Chrome para Android, iOS e ChromeOS em dispositivos não Chromebook Plus ainda não tem suporte das APIs que usam modelos de fundação.
  • 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 à medida que 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. Algumas estão no Chrome Stable, outras estão disponíveis para participantes de testes de origem e outras estão disponíveis apenas para participantes do programa de pré-lançamento.

Cada API tem o próprio conjunto de instruções para começar e fazer o download do 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 são integradas ao Chrome, assim como os modelos. Na primeira vez que um usuário interage com essas APIs, o modelo precisa ser baixado para o navegador.

Para determinar se uma API é utilizável e está pronta, 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 ter energia ou espaço em disco insuficientes.
  • "downloadable": são necessários downloads adicionais para criar uma sessão, que pode incluir um modelo de especialista, um modelo de linguagem ou ajuste fino. 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 adicionais 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 oferecer suporte a APIs de IA integradas, mas o modelo ainda não tiver sido baixado (ou seja, quando chamar availability() retornar "downloadable" ou "downloading"), o usuário precisará interagir de forma significativa com a página para que o aplicativo inicie uma sessão com create().

Use the UserActivation.isActive propriedade para confirmar que um usuário interagiu diretamente com a página desde que a página 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 que interajam com um botão que diz "Resumir" para ativar Summarizer.create(), ou você pode criar o resumo quando 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 Google Chrome.
  2. Acesse chrome://on-device-internals.
  3. Selecione a guia Broker State e verifique se não há erros.
  4. Abra o DevTools e digite LanguageModel.availability(); no console. Isso precisa 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 para mais discussões.

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

Interagir e compartilhar feedback

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