ML Kit'in üretken yapay zeka API'leri, uygulamalarınızın cihaz üzerinde üretken yapay zeka görevleri gerçekleştirmesine yardımcı olmak için Gemini Nano'nun gücünden yararlanır. Bu API'ler, cihaz üzerinde temel modelleri yöneten ve kullanıcı verilerini gizli tutarken çıkarımı hızlandıran bir Android sistem hizmeti olan AICore üzerine kurulmuştur.
GenAI API'lerinin kullanımı, ML Kit GenAI API Ek Hizmet Şartları'na tabidir. API istemcilerinin güvenliğinden ve uygulamalarının kullanıcı deneyiminden yalnızca geliştiriciler sorumludur.
Temel özellikler
ML Kiti, üretken yapay zeka özelliklerini aşağıdaki kategorilerde düzenler:
Özel içerik üretme ve temsilciler
Özel istemler ve otonom temsilci iş akışları için doğrudan Gemini Nano temel modeliyle çalışın:
- Doğrudan model erişimi (
GenerativeModelsınıfını kullanarak): Özel salt metin veya çok formatlı istemlerden metin ya da yazılı yapılandırılmış çıkış oluşturun veyaUSERveMODELrollerine vesessionIddeğerine sahip birList<Content>nesnesi kullanarak kendi çok turlu sohbet geçmişinizi doğrudan yönetin ve araç bildirimlerini doğrudan yönetin. - Temsilci iş akışları (
AgentRunnersınıfını kullanarak):GenerativeModelsınıfı üzerine inşa edilmiştir. Çok aşamalı oturum yönetimini (bellek içi görüşme geçmişi dahil) ve çok adımlı araç çağırma döngülerini otomatikleştirir.
Konuşma ve ses
Konuşma sesini cihaz üzerinde metne dönüştürme, çevirme ve sentezleme:
- Konuşma tanıma: Seslendirilmiş içerikleri aynı dilde metne dönüştürün.
- Konuşma çevirisi: Seslendirilmiş içeriği anlık olarak başka bir dilde metne çevirin.
- Metin Okuma: Metinden kulağa doğal gelen konuşma sesi sentezleyin.
Metin ve resim görevleri
Yaygın görüntü, yazma ve arama görevleri için optimize edilmiş, göreve özel API'leri istem mühendisliği olmadan kullanın:
- Resim açıklaması: Belirli bir resim için kısa bir açıklama oluşturun.
- Özetleme: Makaleleri veya sohbet görüşmelerini madde işaretli liste olarak özetleyin.
- Gözden geçirme: Dil bilgisini iyileştirip yazım hatalarını düzelterek kısa içerikleri daha iyi hale getirin.
- Yeniden yazma: Kısa mesajları farklı üslup veya stillerde yeniden yazın.
- Yerleştirmeler: Embeddings API'yi kullanarak metin ve resimler için vektör yerleştirmeleri oluşturun ve içeriği anlamlarına göre bulmak için bunları AndroidX AppSearch ile eşleştirin.
Üretken yapay zeka API'lerinin avantajları
Mevcut diğer ML Kit özellikleri gibi GenAI API'leri de tamamen cihaz üzerinde çalışır ve bu nedenle aşağıdaki avantajları sağlar:
- Giriş, çıkarım ve çıkış verileri yerel olarak işlenir.
- Güvenilir internet bağlantısı olmasa bile işlevler aynı kalır.
- Her API çağrısı için ek sunucu maliyeti oluşmaz.
Ayrıca, üretken yapay zeka API'leri AICore üzerine inşa edildiğinden ve Gemini Nano tarafından desteklendiğinden, uygulamalar ve göreve özel API'ler cihazda aynı Gemini Nano temel modelini paylaşır. Bu sayede, cihazda Gemini Nano zaten mevcutsa ayrı bir modelin indirilmesini beklemeniz gerekmez ve depolama alanından tasarruf edilir. AICore'un gizliliği korumak için istekleri nasıl izole ettiği hakkında daha fazla bilgi edinin.
Yayın ve yayın dışı
ML Kit GenAI API'leri, sonuçları almak için hem akış hem de akış dışı seçenekler sunar. Akış API'si, yanıtları oluşturuldukça kademeli olarak sunarak sürekli bir veri akışı sağlar. Buna karşılık, akış dışı API, yanıtın tamamını tek bir blok olarak döndürmeden önce tamamlanmasını bekler.
Uzun yanıtlar için akış API'sini seçin. Bu API, ilk geri bildirimin daha hızlı alınmasını sağlar. Akış dışı API, kısa yanıtlar veya sonuçları toplu olarak işlemek için daha uygundur.
Cihaz desteği
Özel üretim ve temsilciler ile metin ve resim görevi API'leri için cihaz desteği aşağıdaki bölümlerde açıklanmıştır. Bu bölümde listelenmeyen özellikler için cihaz desteği bilgilerini ilgili özellik sayfalarında bulabilirsiniz.
Özel üretim ve temsilci cihaz desteği
Doğrudan model erişimi ve temsilci tabanlı iş akışları aşağıdaki cihazlarda desteklenir:
Gemini Nano 2 |
|
Gemini Nano 3 |
|
Gemini Nano 4 |
|
Model kullanılabilirliği ve sürümü, cihazın RAM yapılandırmasına, OS sürümüne ve AICore güncelleme durumuna bağlı olarak değişebilir. Cihazdaki etkin model sürümünü kontrol etmek için Gemini Nano sürümünü alma başlıklı makaleyi inceleyin.
Metin ve resim görevleri için cihaz desteği
Image Description, Summarization, Proofreading ve Rewriting API'leri aşağıdaki cihazlarda kullanılabilir. Bu API'lerin daha fazla cihazda desteklenmesi planlanmaktadır:
- 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, 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, MagicPad 4
- HP: HP Googlebook 14
- iQOO: iQOO 13, iQOO 15
- Lenovo: Lenovo Googlebook 15, Lenovo Idea Tab Pro 2. Nesil, Lenovo Legion Tab 5. Nesil (8,8 inç), Lenovo Yoga Tab Plus 2. Nesil
- 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, 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, POCO X8 Pro Max
- realme: realme GT 7, realme GT 7 Pro, realme GT 7T, 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, vivo X Fold6
- Xiaomi: Xiaomi destekli Leitzphone, Xiaomi 15, Xiaomi 15T, Xiaomi 15T Pro, Xiaomi 15 Ultra, Xiaomi 17, Xiaomi 17T, Xiaomi 17T Pro, Xiaomi 17 Ultra, Xiaomi Pad Mini
Belirli dillerin desteklenip desteklenmediği, cihazın yapılandırmasına ve cihaza indirilen modellere bağlı olarak değişebilir.
Gemini Nano sürümünü alma
Farklı cihazlarda Gemini Nano'nun farklı sürümleri çalışır. Bir cihazdaki Gemini Nano sürümünü döndürmek için getBaseModelName() yöntemini kullanın.
Uygulama başına kota
AICore, uygulama başına bir çıkarım kotası uygular. Kısa bir süre içinde çok fazla GenAI API isteği gönderilirse ErrorCode.BUSY yanıtı alınır. Böyle bir hata aldığınızda, isteği yeniden denemek için eksponansiyel geri yükleme kullanabilirsiniz. Ayrıca, bir uygulama uzun süreli bir kotayı (ör. günlük kota) aşarsa ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED döndürülebilir.
Arka planda kullanım
GenAI API çıkarımına yalnızca uygulama en üstteki ön plan uygulaması olduğunda izin verilir. Uygulama ön planda değilken API'nin kullanılması (ön plan hizmeti kullanımı dahil) ErrorCode.BACKGROUND_USE_BLOCKED yanıtına neden olur.
Örnek kod
Bu kodu almak için aşağıdaki örneklere göz atın: