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 offrono qualità pronta all'uso per i casi d'uso più comuni tramite un'interfaccia di alto livello. Le API ML Kit GenAI sono basate su AICore, un servizio di sistema Android che consente l'esecuzione on-device dei modelli di base GenAI per semplificare funzionalità come la funzionalità avanzata delle app e la sicurezza della privacy degli utenti mediante l'elaborazione dei dati localmente.

Le API ML Kit GenAI supportano le seguenti funzionalità:

  • Riassunto: riassume gli articoli o le conversazioni di chat sotto forma di elenco puntato.
  • Correzione bozza: perfeziona i contenuti brevi perfezionando la grammatica e correggendo gli errori ortografici.
  • Riscrivi: riscrivere messaggi brevi in toni o stili diversi.
  • Descrizione immagine: genera una breve descrizione di una determinata immagine.

Vantaggi delle API di IA generativa

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, di inferenza e di output vengono elaborati localmente
  • La funzionalità rimane invariata senza una connessione a internet affidabile
  • Nessun costo aggiuntivo per il server per ogni chiamata API

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

Streaming e non streaming

Le API ML Kit GenAI offrono opzioni sia in streaming che non in streaming per la ricezione risultati. L'API di streaming fornisce le risposte in modo incrementale man mano che vengono generate, fornendo un flusso continuo di dati. Al contrario, l'API non in streaming attende il completamento dell'intera risposta prima di restituirla come singolo 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 le risposte brevi o per l'elaborazione dei risultati in batch.

Assistenza per i dispositivi

Le API ML Kit GenAI sono disponibili sui seguenti dispositivi, con piani di espansione del supporto ad altri dispositivi:

  • Google: Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL, Pixel 9 Pro Fold
  • Honor: Magic 7 Pro, Magic 7
  • 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
  • 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 se invii troppe richieste all'API GenAI in un breve periodo di tempo, riceverai una risposta ErrorCode.BUSY. Quando ricevi questo errore, ti consigliamo di utilizzare il backoff esponenziale per eseguire nuovamente la richiesta.

Utilizzo in background

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

Codice di esempio

Per ottenere questo codice, dai un'occhiata ai seguenti esempi: