API GenAI ML Kit memanfaatkan kecanggihan Gemini Nano untuk membantu aplikasi Anda melakukan tugas. API ini memberikan kualitas siap pakai untuk kasus penggunaan populer melalui antarmuka tingkat tinggi. API GenAI ML Kit dibangun di atas AICore, layanan sistem Android yang memungkinkan eksekusi model dasar GenAI di perangkat untuk memfasilitasi fitur seperti peningkatan fungsi aplikasi dan peningkatan privasi pengguna dengan memproses data secara lokal.
Persyaratan Layanan Tambahan API GenAI ML Kit berlaku untuk penggunaan API GenAI. Developer bertanggung jawab sepenuhnya atas keamanan klien API dan pengalaman pengguna aplikasi mereka.
Fitur utama
API GenAI ML Kit mendukung fitur berikut:
- Ringkasan: Meringkas artikel atau percakapan chat sebagai daftar berbutir.
- Pemeriksaan tata bahasa: Memoles konten singkat dengan memperbaiki tata bahasa dan kesalahan ejaan.
- Penulisan ulang: Menulis ulang pesan singkat dengan gaya bahasa atau gaya yang berbeda.
- Deskripsi gambar: Buat deskripsi singkat dari gambar tertentu.
- Perintah: Buat konten teks berdasarkan perintah multimodal atau khusus teks kustom.
Manfaat API GenAI
Mirip dengan fitur ML Kit lainnya yang sudah ada, API GenAI berjalan sepenuhnya di perangkat dan dengan demikian memberikan manfaat berikut:
- Data input, inferensi, dan output diproses secara lokal
- Fungsi tetap sama tanpa koneksi internet yang andal
- Tidak ada biaya server tambahan yang dikeluarkan untuk setiap panggilan API
Selain itu, karena GenAI API dibangun di atas AICore dan didukung oleh Gemini Nano, setiap aplikasi dapat menggunakan model Gemini Nano bersama yang ada di perangkat. Hal ini menghindari kebutuhan untuk menunggu model didownload jika model tersebut sudah ada di perangkat, dan pada gilirannya menghemat ruang penyimpanan. Pelajari lebih lanjut cara AICore mengisolasi permintaan untuk melindungi privasi.
Streaming versus non-streaming
API GenAI ML Kit menawarkan opsi streaming dan non-streaming untuk menerima hasil. Streaming API memberikan respons secara bertahap saat respons tersebut dihasilkan, sehingga memberikan aliran data yang berkelanjutan. Sebaliknya, API non-streaming menunggu hingga seluruh respons selesai sebelum menampilkannya sebagai satu blok.
Pilih API streaming untuk respons yang panjang, karena API ini memungkinkan umpan balik awal yang lebih cepat. API non-streaming lebih cocok untuk respons singkat atau saat memproses hasil dalam batch.
Dukungan perangkat
API khusus fitur AI Generatif (Ringkasan, Pemeriksaan Ejaan, Penulisan Ulang, dan Deskripsi Gambar) memiliki dukungan perangkat yang berbeda dengan Prompt API, seperti yang dijelaskan di bagian berikut.
Dukungan perangkat API khusus fitur
API Summarization, Proofreading, Rewriting, dan Image Description tersedia di perangkat berikut, dengan rencana untuk memperluas dukungan ke perangkat tambahan:
- 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, Magic V5
- iQOO: iQOO 13
- Motorola: Razr 60 Ultra
- OnePlus: OnePlus 13, OnePlus 13s, OnePlus Pad 3
- OPPO: Find N5, Find X8, Find X8 Pro, Reno 14 Pro
- POCO: POCO F7 Ultra, POCO X7 Pro
- realme: realme GT 7 Pro, realme GT 7T
- Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Ultra, Galaxy Z Fold7
- vivo: vivo X200, vivo X200 Pro, vivo X Fold3 Pro, vivo X Fold5
- Xiaomi: Xiaomi 15 Ultra, Xiaomi 15, Xiaomi 15T Pro, Xiaomi 15T, Xiaomi Pad mini
Ketersediaan dukungan bahasa tertentu dapat bervariasi bergantung pada konfigurasi perangkat tertentu dan model yang telah didownload ke perangkat.
Dukungan perangkat Prompt API
Prompt API saat ini didukung di perangkat berikut:
nano-v2 |
|
nano-v3 |
|
Mengambil versi Gemini Nano
Berbagai versi Gemini Nano berjalan di perangkat yang berbeda. Untuk menampilkan versi Gemini Nano di perangkat, gunakan getBaseModelName().
Kuota per aplikasi
AICore menerapkan kuota inferensi per aplikasi. Membuat terlalu banyak permintaan GenAI API dalam waktu singkat akan menghasilkan respons ErrorCode.BUSY. Saat menerima error tersebut, pertimbangkan untuk menggunakan backoff eksponensial guna mencoba lagi permintaan. Selain itu, ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED dapat ditampilkan jika aplikasi melampaui kuota durasi panjang (misalnya, kuota harian).
Penggunaan latar belakang
Inferensi GenAI API hanya diizinkan jika aplikasi adalah aplikasi latar depan teratas. Menggunakan API saat aplikasi tidak berada di latar depan, termasuk
menggunakan layanan latar depan, akan menghasilkan respons ErrorCode.BACKGROUND_USE_BLOCKED.
Kode contoh
Untuk mendapatkan kode ini, lihat contoh berikut: