Panoramica delle API ML Kit GenAI

Le API GenAI di ML Kit sfruttano la potenza di Gemini Nano per aiutare le tue app a svolgere attività. Queste API forniscono una qualità pronta all'uso per i casi d'uso più comuni tramite un'interfaccia di alto livello. Le API GenAI di ML Kit sono basate su AICore, un servizio di sistema Android che consente l'esecuzione on-device di modelli di base GenAI per facilitare funzionalità come la funzionalità avanzata delle app e una maggiore privacy degli utenti elaborando i dati localmente.

Le API GenAI di ML Kit supportano le seguenti funzionalità:

  • Riepilogo: riassumi articoli o conversazioni di chat come elenco puntato.
  • Correzione di bozze: perfeziona i contenuti brevi migliorando la grammatica e correggendo gli errori ortografici.
  • Riscrivere: riscrivi messaggi brevi con toni o stili diversi.
  • Descrizione dell'immagine: genera una breve descrizione di un'immagine specifica.

Vantaggi delle API GenAI

Analogamente ad altre funzionalità di ML Kit esistenti, le API GenAI vengono eseguite interamente sul dispositivo e pertanto offrono i seguenti vantaggi:

  • I dati di input, inferenza e output vengono elaborati localmente
  • La funzionalità rimane invariata senza una connessione a internet affidabile
  • Nessun costo aggiuntivo del server sostenuto per ogni chiamata API

Inoltre, poiché le API GenAI sono basate su AICore e utilizzano Gemini Nano, ogni app è in grado di utilizzare il modello Gemini Nano condiviso presente sul dispositivo. In questo modo si evita di dover attendere il download di un modello se esiste già su un dispositivo e si risparmia spazio di archiviazione. Scopri di più su come AICore isola le richieste per proteggere la privacy.

Streaming e non streaming

Le API GenAI di ML Kit offrono opzioni di streaming e non streaming per la ricezione dei risultati. L'API di streaming fornisce risposte in modo incrementale man mano che vengono generate, fornendo un flusso continuo di dati. Al contrario, l'API non in streaming attende che l'intera risposta sia completata prima di restituirla come un unico blocco.

Scegli l'API di streaming per le risposte lunghe, in quanto consente un feedback iniziale più rapido. L'API non in streaming è più adatta per risposte brevi o quando i risultati vengono elaborati in batch.

Assistenza per i dispositivi

Le API GenAI di ML Kit sono disponibili sui seguenti dispositivi, con piani per estendere il supporto ad altri dispositivi:

  • Google: Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL, Pixel 10 Pro Fold, Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL, Pixel 9 Pro Fold
  • Honor: Honor 400 Pro, Magic 6 Pro, Magic 6 RSR, Magic 7, Magic 7 Pro, Magic V3
  • iQOO: iQOO 13
  • Motorola: Razr 60 Ultra
  • OnePlus: OnePlus 13, OnePlus 13s
  • OPPO: Find N5, Find X8, Find X8 Pro
  • POCO: POCO F7 Ultra
  • realme: realme GT 7 Pro
  • Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Ultra
  • vivo: vivo X200, vivo X200 Pro, vivo X Fold3 Pro, vivo X Fold5
  • Xiaomi: Xiaomi 15 Ultra, Xiaomi 15

La disponibilità del supporto di lingue specifiche può variare a seconda della configurazione del dispositivo e dei modelli scaricati sul dispositivo.

Quota per applicazione

AICore applica una quota di inferenza per app. Ciò significa che l'invio di troppe richieste API GenAI in un breve periodo di tempo comporterà una risposta ErrorCode.BUSY. Quando ricevi un errore di questo tipo, valuta la possibilità di utilizzare il backoff esponenziale per riprovare a inviare la richiesta.

Utilizzo in background

L'inferenza dell'API GenAI è consentita solo quando l'app è l'applicazione in primo piano principale. L'utilizzo dell'API quando l'app non è in primo piano, incluso l'utilizzo di un servizio in primo piano, genererà una risposta ErrorCode.BUSY a causa dell'attuale mancanza di quota di utilizzo in background.

Codice di esempio

Per ottenere questo codice, consulta i seguenti esempi: