Descripción general de las APIs de IA generativa de ML Kit

Las APIs de IA generativa de ML Kit aprovechan la potencia de Gemini Nano para ayudar a tus apps a realizar tareas de IA generativa integrada en el dispositivo. Estas APIs se basan en AICore, un servicio del sistema de Android que administra los modelos de base integrados en el dispositivo y acelera la inferencia, a la vez que mantiene la privacidad de los datos del usuario.

Las Condiciones del Servicio Adicionales de la API de IA generativa de ML Kit se aplican al uso de las APIs de IA generativa. Los desarrolladores son los únicos responsables de la seguridad de su cliente de API y de la experiencia del usuario de su app.

Funciones clave

El ML Kit organiza sus capacidades de IA generativa en las siguientes categorías:

Generación y agentes personalizados

Trabaja directamente con el modelo de base Gemini Nano para crear instrucciones personalizadas y flujos de trabajo de agentes autónomos:

  • Acceso directo al modelo (con la clase GenerativeModel): Genera texto o un resultado estructurado con tipo a partir de instrucciones personalizadas solo de texto o multimodales, o administra tu propio historial de chat de varios turnos directamente con un objeto List<Content> con roles USER y MODEL y un valor sessionId, y administra las declaraciones de herramientas directamente.
  • Flujos de trabajo de agentes (con la clase AgentRunner): Se basan en la clase GenerativeModel y automatizan la administración de sesiones de varios turnos (incluido el historial de conversaciones en la memoria) y los bucles de llamadas a herramientas de varios pasos.

Voz y audio

Transcribe, traduce y sintetiza audio de voz integrado en el dispositivo:

Tareas de texto y de imagen

Usa APIs específicas para tareas optimizadas para tareas comunes de visión, escritura y búsqueda sin ingeniería de instrucciones:

  • Descripción de la imagen: Genera una descripción breve de una imagen determinada.
  • Resumen: Resume artículos o conversaciones de chat como una lista con viñetas.
  • Revisión de texto: Pule el contenido breve mejorando la gramática y corrigiendo los errores ortográficos.
  • Reescritura: Reescribe mensajes cortos en diferentes tonos o estilos.
  • Embeddings: Genera embeddings de vectores para texto e imágenes con la API de Embeddings y vincúlalos con AppSearch de AndroidX para encontrar contenido por significado.

Beneficios de las APIs de IA generativa

Al igual que otras funciones existentes de ML Kit, las APIs de IA generativa se ejecutan por completo integrado en el dispositivo y, por lo tanto, proporcionan los siguientes beneficios:

  • Los datos de entrada, inferencia y salida se procesan de forma local
  • La funcionalidad sigue siendo la misma sin una conexión a Internet confiable
  • No se genera ningún costo adicional del servidor por cada llamada a la API.

Además, como las APIs de IA generativa se compilan sobre AICore y se basan en Gemini Nano, las apps y las APIs específicas de tareas comparten el mismo modelo base de Gemini Nano subyacente en el dispositivo. Esto evita tener que esperar a que se descargue un modelo independiente si Gemini Nano ya existe en un dispositivo y, a su vez, conserva espacio de almacenamiento. Obtén más información sobre cómo AICore aísla las solicitudes para proteger la privacidad.

Transmisión frente a no transmisión

Las APIs de IA generativa de ML Kit ofrecen opciones de transmisión y no transmisión para recibir resultados. La API de transmisión entrega respuestas de forma incremental a medida que se generan, lo que proporciona un flujo continuo de datos. En cambio, la API que no es de transmisión espera hasta que se complete toda la respuesta antes de devolverla como un solo bloque.

Elige la API de transmisión para respuestas largas, ya que permite obtener comentarios iniciales más rápidos. La API sin transmisión es más adecuada para respuestas cortas o cuando se procesan resultados en lotes.

Dispositivos compatibles

La compatibilidad de los dispositivos con la generación personalizada, los agentes y las APIs de tareas de texto e imagen se describe en las siguientes secciones. Para conocer las funciones que no se mencionan en esta sección, consulta las páginas de funciones individuales para obtener información sobre la compatibilidad con dispositivos.

Asistencia para la generación personalizada y los dispositivos de agentes

El acceso directo al modelo y los flujos de trabajo de agentes son compatibles con los siguientes dispositivos:

Gemini Nano 2

  • POCO: POCO F7 Ultra, POCO F8 Pro, POCO F8 Ultra, POCO X7 Pro y POCO X8 Pro
  • realme: realme GT 7
  • Redmi: Redmi Turbo 5
  • vivo: vivo T4 Ultra y vivo X200 FE
  • Xiaomi: Leitzphone con tecnología de Xiaomi, Xiaomi 15, Xiaomi 15T, Xiaomi 15 Ultra, Xiaomi 17, Xiaomi 17T y Xiaomi 17 Ultra

Gemini Nano 3

  • Acer: Acer Googlebook 14
  • ASUS: ASUS Googlebook 14
  • Dell: XPS Googlebook
  • Google: Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL y Pixel 9 Pro Fold
  • HP: HP Googlebook 14
  • Lenovo: Lenovo Googlebook 15
  • OPPO: Reno 14 Pro 5G, Reno 15 Pro 5G, Reno 15 Pro Mini 5G, Reno 15 Pro Max 5G y Reno 16 Pro 5G
  • realme: realme GT 7T

Gemini Nano 4

  • Google: Pixel 11, Pixel 11 Pro, Pixel 11 Pro XL, Pixel 11 Pro Fold, Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL y Pixel 10 Pro Fold
  • Honor: Honor 600 Pro, Magic 7, Magic 7 Pro, Porsche Design Magic 7 RSR, Magic 8 Pro, Magic V5, Magic V6, MagicPad 4
  • iQOO: iQOO 13, iQOO 15
  • Lenovo: Lenovo Idea Tab Pro Gen 2, Lenovo Legion Tab Gen 5(8.8"), Lenovo Yoga Tab Plus Gen 2
  • Motorola: Edge 70 Pro, Edge 70 Pro+, Razr 60 Ultra, Razr Ultra 2025, Razr Fold, Signature
  • OnePlus: OnePlus 13, OnePlus 13s, OnePlus 15, OnePlus 15R, OnePlus Pad 3
  • OPPO: Find N5, Find N6, Find X8, Find X8 Pro, Find X9, Find X9 Pro, Find X9s, Find X9 Ultra, Find X10, Find X10 Pro Max
  • POCO: POCO F9 Pro y POCO X8 Pro Max
  • realme: realme GT 7 Pro y realme GT 8 Pro
  • Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Edge, Galaxy S25 Ultra, Galaxy S26, Galaxy S26+, Galaxy S26 FE, Galaxy S26 Ultra, Galaxy Tab S12+, Galaxy Tab S12 Ultra, Galaxy Z Flip7, Galaxy Z Flip8, Galaxy Z Fold7, Galaxy Z Fold8, Galaxy Z Fold8 Ultra, Galaxy Z TriFold
  • Sharp: AQUOS R11
  • Sony: Xperia 1 VIII
  • vivo: vivo X200, vivo X200 Pro, vivo X200T, vivo X300, vivo X300 FE, vivo X300 Pro, vivo X300 Ultra, vivo X500 Pro, vivo X500 Pro Max, vivo X Fold3 Pro, vivo X Fold5 y vivo X Fold6
  • Xiaomi: Xiaomi 15T Pro, Xiaomi 17T Pro y Xiaomi Pad Mini

La disponibilidad y la versión del modelo pueden variar según la configuración de la RAM del dispositivo, la versión del SO y el estado de actualización de AICore. Para verificar la versión activa del modelo en un dispositivo, consulta Recupera la versión de Gemini Nano.

Compatibilidad de dispositivos con tareas de texto e imagen

Las APIs de descripción de imágenes, resumen, revisión de texto y reescritura están disponibles en los siguientes dispositivos, y se planea expandir la compatibilidad a más dispositivos:

  • Acer: Acer Googlebook 14
  • ASUS: ASUS Googlebook 14
  • Dell: XPS Googlebook
  • Google: Pixel 11, Pixel 11 Pro, Pixel 11 Pro XL, Pixel 11 Pro Fold, Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL, Pixel 10 Pro Fold, Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL y Pixel 9 Pro Fold
  • Honor: Honor 400 Pro, Honor 600 Pro, Magic 7, Magic 7 Pro, Porsche Design Magic 7 RSR, Magic 8 Pro, Magic V5, Magic V6 y MagicPad 4
  • HP: HP Googlebook 14
  • iQOO: iQOO 13, iQOO 15
  • Lenovo: Lenovo Googlebook 15, Lenovo Idea Tab Pro Gen 2, Lenovo Legion Tab Gen 5(8.8"), Lenovo Yoga Tab Plus Gen 2
  • Motorola: Edge 70 Pro, Edge 70 Pro+, Razr 60 Ultra, Razr Ultra 2025, Razr Fold, Signature
  • OnePlus: OnePlus 13, OnePlus 13s, OnePlus 15, OnePlus 15R y OnePlus Pad 3
  • OPPO: Find N5, Find N6, Find X8, Find X8 Pro, Find X9, Find X9 Pro, Find X9s, Find X9 Ultra, Find X10, Find X10 Pro Max, Reno 14 Pro 5G, Reno 15 Pro 5G, Reno 15 Pro Mini 5G, Reno 15 Pro Max 5G, Reno 16 Pro 5G
  • POCO: POCO F7 Ultra, POCO F8 Pro, POCO F8 Ultra, POCO F9 Pro, POCO X7 Pro, POCO X8 Pro y POCO X8 Pro Max
  • realme: realme GT 7, realme GT 7 Pro, realme GT 7T y realme GT 8 Pro
  • Redmi: Redmi Turbo 5
  • Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Edge, Galaxy S25 Ultra, Galaxy S26, Galaxy S26+, Galaxy S26 FE, Galaxy S26 Ultra, Galaxy Tab S12+, Galaxy Tab S12 Ultra, Galaxy Z Flip7, Galaxy Z Flip8, Galaxy Z Fold7, Galaxy Z Fold8, Galaxy Z Fold8 Ultra, Galaxy Z TriFold
  • Sharp: AQUOS R11
  • Sony: Xperia 1 VIII
  • vivo: vivo T4 Ultra, vivo X200, vivo X200 FE, vivo X200 Pro, vivo X200T, vivo X300, vivo X300 FE, vivo X300 Pro, vivo X300 Ultra, vivo X500 Pro, vivo X500 Pro Max, vivo X Fold3 Pro, vivo X Fold5 y vivo X Fold6
  • Xiaomi: Leitzphone con tecnología de Xiaomi, Xiaomi 15, Xiaomi 15T, Xiaomi 15T Pro, Xiaomi 15 Ultra, Xiaomi 17, Xiaomi 17T, Xiaomi 17T Pro, Xiaomi 17 Ultra y Xiaomi Pad Mini

La disponibilidad de la compatibilidad con idiomas específicos puede variar según la configuración del dispositivo en particular y los modelos que se hayan descargado en él.

Recupera la versión de Gemini Nano

Se ejecutan diferentes versiones de Gemini Nano en distintos dispositivos. Para devolver la versión de Gemini Nano en un dispositivo, usa el método getBaseModelName().

Cuota por aplicación

AICore aplica una cuota de inferencia por app. Si realizas demasiadas solicitudes a la API de IA generativa en un período breve, se generará una respuesta ErrorCode.BUSY. Cuando recibas un error de este tipo, considera usar la retirada exponencial para volver a intentar la solicitud. Además, se puede devolver ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED si una app supera una cuota de larga duración (por ejemplo, una cuota diaria).

Uso en segundo plano

La inferencia de la API de GenAI solo se permite cuando la app es la aplicación en primer plano principal. Si usas la API cuando la app no está en primer plano, incluido el uso de un servicio en primer plano, se generará una respuesta ErrorCode.BACKGROUND_USE_BLOCKED.

Código de muestra

Para obtener este código, consulta los siguientes ejemplos: