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 sohbet 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.
- Semantik arama: Embedding API'yi kullanarak metin ve resimler için vektör yerleştirmeleri oluşturun ve içeriği anlama göre bulmak için bunları AndroidX AppSearch ile eşleştirin.
Üretken yapay zeka API'lerinin avantajları
Mevcut diğer ML Kit özelliklerine benzer şekilde, GenAI API'leri 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 bir internet bağlantısı olmasa bile işlevler aynı kalır.
- Her API çağrısı için ek sunucu maliyeti yoktur.
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ışlı hem de akışsız 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ı tamamlanana kadar bekler ve ardından yanıtı tek bir blok olarak döndürür.
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, temsilciler, metin ve resim Tasks 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 içerik üretme ve temsilci cihaz desteği
Doğrudan model erişimi ve temsilci tabanlı iş akışları aşağıdaki cihazlarda desteklenir:
nano-v2 |
|
nano-v3 |
|
nano-v4 |
|
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:
- 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, Magic 7, Magic 7 Pro, Magic 8 Pro, Magic V5
- iQOO: iQOO 13, iQOO 15
- Lenovo: Lenovo Idea Tab Pro 2. Nesil, Lenovo Legion Tab 5. Nesil(8,8 inç)
- 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 Flip8, Galaxy Z Fold8, Galaxy Z Fold8 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
Belirli dillerde destek, cihazın yapılandırmasına ve cihaza indirilen modellere bağlı olarak değişiklik gösterebilir.
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ı (örneğin, 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: