Comienza a usar la IA integrada

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado el 12 de diciembre de 2024. Última actualización el 20 de mayo de 2025.

Con las APIs de IA integradas, tu aplicación web puede realizar tareas potenciadas por IA sin necesidad de implementar ni administrar sus propios modelos de IA. Estamos trabajando para estandarizar estas APIs en todos los navegadores.

Modelos requeridos

Las APIs de Translator y Language Detector usan modelos expertos. Todas las demás APIs usan un modelo de lenguaje, diseñado para ejecutarse de forma local en computadoras de escritorio y laptops.

Las APIs de Summarizer, Writer, Rewriter y Proofreader solo admiten la modalidad de texto a texto. La API de Prompt tiene capacidades multimodales.

Modelos de Chrome

Chrome usa modelos de lenguaje expertos y de base. Estos modelos no están disponibles en dispositivos móviles.

A partir de Chrome 149, los modelos admiten inglés, español, japonés, alemán y francés para el texto de entrada y salida.

Hardware requerido

Existen los siguientes requisitos para los desarrolladores y los usuarios que operan funciones con estas APIs en Chrome. Es posible que otros navegadores tengan requisitos operativos diferentes.

Las APIs de Language Detector y Translator funcionan en Chrome en computadoras de escritorio. Estas APIs no funcionan en dispositivos móviles.

Las APIs de Prompt, Summarizer, Writer, Rewriter y Proofreader funcionan en Chrome cuando se cumplen las siguientes condiciones:

  • Sistema operativo: Windows 10 o 11; macOS 13 o versiones posteriores (Ventura y versiones posteriores); Linux; o ChromeOS (desde la plataforma 16389.0.0 y versiones posteriores) en Chromebook Plus dispositivos. Las APIs que usan modelos de base aún no admiten Chrome para Android, iOS y ChromeOS en dispositivos que no son Chromebook Plus.
  • Almacenamiento: Al menos 22 GB de espacio libre en el volumen que contiene tu perfil de Chrome.
  • GPU o CPU: Los modelos integrados se pueden ejecutar con GPU o CPU.
    • GPU: Estrictamente más de 4 GB de VRAM.
    • CPU: 16 GB de RAM o más y 4 núcleos de CPU o más.
    • Nota: La API de Prompt con entrada de audio requiere una GPU.
  • Red: Datos ilimitados o una conexión de uso no medido.

El tamaño exacto de Gemini Nano puede variar a medida que el navegador actualiza el modelo. Para determinar el tamaño actual, visita chrome://on-device-internals.

Comienza con la compilación

Existen varias APIs de IA integradas disponibles en diferentes etapas de desarrollo. Algunas están en la versión estable de Chrome, otras están disponibles para los participantes de las pruebas de origen, y otras solo están disponibles para los participantes del Programa de vista previa anticipada.

Cada API tiene su propio conjunto de instrucciones para comenzar y descargar el modelo, tanto para la creación de prototipos locales como en entornos de producción con las pruebas de origen.

Todas estas APIs se pueden usar cuando se compilan extensiones de Chrome.

Descarga de modelos

Las APIs están integradas en Chrome, al igual que los modelos. La primera vez que un usuario interactúa con estas APIs, el modelo debe descargarse en el navegador.

Para determinar si una API se puede usar y está lista, llama a la función asíncrona availability(), que muestra una promesa con uno de los siguientes valores:

  • "unavailable": No se admiten el dispositivo del usuario ni las opciones de sesión solicitadas. Es posible que el dispositivo no tenga suficiente energía o espacio en el disco.
  • "downloadable": Se necesitan descargas adicionales para crear una sesión, que puede incluir un modelo experto, un modelo de lenguaje o un ajuste. Es posible que se requiera la activación del usuario para llamar a create().
  • "downloading": Las descargas están en curso y deben completarse antes de que puedas usar una sesión.
  • "available": Puedes crear una sesión de inmediato.

Algunas APIs requieren opciones adicionales cuando se llama a la disponibilidad. Por ejemplo, la API de Prompt requiere que se declare la compatibilidad con el idioma:

// 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"]}],
});

Activación del usuario

Si el dispositivo puede admitir APIs de IA integradas, pero el modelo aún no se descargó (es decir, cuando la llamada a availability() muestra "downloadable" o "downloading"), el usuario debe interactuar de manera significativa con tu página para que tu aplicación inicie una sesión con create().

Usa la UserActivation.isActive propiedad para confirmar que un usuario interactuó directamente con la página desde que la página terminó de cargarse. Esto puede incluir un toque, un clic, una presión de tecla, mousedown, o otros eventos de activación persistente.

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

Por ejemplo, con la API de Summarizer, puedes pedirles a los usuarios que interactúen con un botón que diga "Resumir" para activar Summarizer.create(), o puedes crear el resumidor una vez que un usuario comience a escribir, un evento keydown.

Soluciona problemas de localhost

Si el modelo no funciona como se espera, sigue estos pasos:

  1. Reinicia Chrome.
  2. Ve a chrome://on-device-internals.
  3. Selecciona la pestaña Broker State y asegúrate de que no haya errores.
  4. Abre las Herramientas para desarrolladores y escribe LanguageModel.availability(); en la consola. Debería mostrar available.

Si es necesario, espera un tiempo y repite estos pasos.

Proceso de estándares

Estamos trabajando para estandarizar estas APIs, de modo que funcionen en todos los navegadores. Esto significa que propusimos las APIs a la comunidad de plataformas web y las trasladamos al W3C Web Incubator Community Group para que se debatan más.

Solicitamos comentarios del W3C, Mozilla y WebKit para cada API.

Interactúa y envía comentarios

Si pruebas la IA integrada y tienes comentarios, nos encantaría leerlos.