API GenAI ML Kit memanfaatkan kemampuan 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 fungsi aplikasi yang ditingkatkan dan privasi pengguna yang lebih baik 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 poin.
- Perbaiki draf: Perbaiki konten singkat dengan menyempurnakan tata bahasa dan memperbaiki kesalahan ejaan.
- Penulisan ulang: Menulis ulang pesan singkat dengan gaya atau nada yang berbeda.
- Deskripsi gambar: Membuat deskripsi singkat dari gambar tertentu.
- **Pengenalan ucapan**: Mentranskripsikan konten audio ke teks.
- Perintah: Membuat konten teks berdasarkan perintah multimodal atau khusus teks kustom.
Manfaat API GenAI
Mirip dengan fitur ML Kit lainnya yang 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 dikenakan untuk setiap panggilan API
Selain itu, karena API GenAI 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 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. API streaming memberikan respons secara bertahap saat dibuat, 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 memungkinkan masukan awal yang lebih cepat. API non-streaming lebih cocok untuk respons singkat atau saat memproses hasil dalam batch.
Dukungan perangkat
API khusus fitur GenAI (Ringkasan, Koreksi, 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 Ringkasan, Koreksi, Penulisan Ulang, dan Deskripsi Gambar 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 7, Magic 7 Pro, Magic 8 Pro, Magic V5
- iQOO: iQOO 13, iQOO 15
- Lenovo: Lenovo Idea Tab Pro Gen 2, Lenovo Legion Tab Gen 5(8.8")
- Motorola: Razr 60 Ultra, Razr Ultra 2025, Signature
- OnePlus: OnePlus 15, OnePlus 15R, OnePlus 13, OnePlus 13s
- OPPO: Find N5, Find X9, Find X9 Pro, Find X8, Find X8 Pro, Reno 14 Pro 5G, Reno 15 Pro 5G, Reno 15 Pro Mini 5G, Reno 15 Pro Max 5G
- POCO: POCO F7 Ultra, POCO F8 Pro, POCO F8 Ultra, POCO X7 Pro, POCO X8 Pro
- realme: realme GT 7 Pro, realme GT 7T
- Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Ultra, Galaxy S26, Galaxy S26+, Galaxy S26 Ultra, Galaxy Z Fold7, Galaxy Z TriFold
- Sharp: AQUOS R11
- Sony: Xperia 1 VIII
- vivo: vivo X200T, vivo X200 FE, vivo X200, vivo X200 Pro, vivo X300, X300 Pro, vivo X Fold3 Pro, vivo X Fold5, vivo T4 Ultra
- Xiaomi: Xiaomi 14T Pro, Xiaomi 15, Xiaomi 15T, Xiaomi 15T Pro, Xiaomi 15 Ultra, Xiaomi 17, Xiaomi 17 Ultra, 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 didukung di perangkat berikut:
nano-v2 |
|
nano-v3 |
|
Dukungan perangkat Speech Recognition API
Speech Recognition API didukung di perangkat berikut:
| Mode Dasar | Menggunakan model pengenalan ucapan di perangkat tradisional, yang tersedia di sebagian besar perangkat Android dengan API level 31 dan yang lebih tinggi. |
|---|---|
| Mode Lanjutan | Memanfaatkan model GenAI untuk kualitas yang lebih tinggi dan cakupan bahasa yang lebih luas. Didukung oleh perangkat Pixel 10, dengan lebih banyak perangkat yang sedang dikembangkan. |
Mengambil versi Gemini Nano
Versi Gemini Nano yang berbeda 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 API GenAI dalam waktu singkat akan menghasilkan respons ErrorCode.BUSY. Saat menerima error tersebut, pertimbangkan untuk menggunakan backoff eksponensial untuk mencoba kembali permintaan. Selain itu, ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED dapat ditampilkan jika aplikasi melebihi kuota durasi panjang (misalnya, kuota harian).
Penggunaan latar belakang
Inferensi API GenAI 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: