ML Kit GenAI API'lerine genel bakış

ML Kit'in üretken yapay zeka API'leri, uygulamalarınızın görevleri yerine getirmesine yardımcı olmak için Gemini Nano'nun gücünden yararlanır. Bu API'ler, üst düzey bir arayüz aracılığıyla popüler kullanım alanları için kullanıma hazır kalite sunar. ML Kit üretken yapay zeka API'leri, verileri yerel olarak işleyerek gelişmiş uygulama işlevselliği ve kullanıcı gizliliğini iyileştirme gibi özellikleri kolaylaştırmak için cihaz üzerinde üretken yapay zeka temel modellerinin yürütülmesini sağlayan bir Android sistem hizmeti olan AICore üzerine kurulmuştur.

GenAI API'lerinin kullanımı ML Kit GenAI API Ek Hizmet Şartları'na tabidir. Geliştiriciler, API istemcilerinin güvenliğinden ve uygulamalarının kullanıcı deneyiminden tamamen sorumludur.

Temel özellikler

ML Kit Üretken Yapay Zeka API'leri aşağıdaki özellikleri destekler:

  • Özetleme: Makaleleri veya sohbet görüşmelerini madde işaretli liste olarak özetleyin.
  • Yazı denetimi: Dil bilgisini iyileştirerek ve yazım hatalarını düzelterek kısa içerikleri daha iyi hale getirin.
  • Yeniden yazma: Kısa mesajları farklı tonlarda veya stillerde yeniden yazın.
  • Resim açıklaması: Belirli bir resmin kısa açıklamasını oluşturun.
  • İstem: Yalnızca metin içeren veya çok formatlı özel bir isteme dayalı olarak metin içeriği oluşturun.

Üretken yapay zeka API'lerinin avantajları

Mevcut diğer ML Kit özelliklerine benzer şekilde, üretken yapay zeka API'leri tamamen cihaz üzerinde çalışır ve bu nedenle aşağıdaki avantajları sunar:

  • Giriş, çıkarım ve çıkış verileri yerel olarak işlenir.
  • İşlevler, güvenilir bir internet bağlantısı olmadan da aynı şekilde çalışır.
  • Her API çağrısı için ek sunucu maliyeti oluşmaz.

Ayrıca, üretken yapay zeka API'leri AICore'un üzerine kurulup Gemini Nano tarafından desteklendiğinden her uygulama, cihazdaki paylaşılan Gemini Nano modelini kullanabilir. Bu sayede, cihazda zaten bulunan bir modelin indirilmesini bekleme ihtiyacı ortadan kalkar ve depolama alanı korunur. 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 artımlı olarak sunar ve sürekli bir veri akışı sağlar. Bunun aksine, akış olmayan API, yanıtın tamamı gelene 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, daha hızlı ilk geri bildirim sağlar. Akış yapılmayan API, kısa yanıtlar veya sonuçları toplu olarak işleme için daha uygundur.

Cihaz desteği

GenAI özelliğine özgü API'ler (Özetleme, Yazım Denetimi, Yeniden Yazma ve Resim Açıklaması), aşağıdaki bölümlerde açıklandığı gibi Prompt API'den farklı cihaz desteğine sahiptir.

Özelliğe özel API cihaz desteği

Özetleme, Yazım Denetimi, Yeniden Yazma ve Resim Açıklaması API'leri aşağıdaki cihazlarda kullanılabilir. Desteklenen cihazların kapsamı genişletilecektir:

  • 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
  • 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, vivo X Fold3 Pro, vivo X Fold5
  • Xiaomi: Xiaomi 15 Ultra, Xiaomi 15

Belirli dil desteğinin kullanılabilirliği, cihazın yapılandırmasına ve cihaza indirilen modellere göre değişebilir.

Prompt API cihaz desteği

Prompt API şu anda aşağıdaki cihazlarda desteklenmektedir:

nano-v2

  • Google: Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL, Pixel 9 Pro Fold
  • Honor: Magic V5, Magic 7, Magic 7 Pro
  • iQOO: iQOO 13
  • Motorola: Razr 60 Ultra
  • OnePlus: OnePlus 13, OnePlus 13s, OnePlus Pad 3
  • OPPO: Find N5
  • POCO: POCO F7 Ultra
  • realme: realme GT 7 Pro
  • Samsung: Galaxy Z Fold7
  • Xiaomi: Xiaomi 15 Ultra, Xiaomi 15

nano-v3

  • Google: Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL, Pixel 10 Pro Fold

Gemini Nano sürümünü alma

Gemini Nano'nun farklı sürümleri farklı cihazlarda çalışır. Bir cihazda Gemini Nano sürümünü geri yüklemek için getBaseModelName() kullanın.

Uygulama başına kota

AICore, uygulama başına çıkarım kotası uygular. Kısa süre içinde çok fazla GenAI API isteği gönderilmesi ErrorCode.BUSY yanıtına neden olur. Bu tür bir hata aldığınızda, isteği yeniden denemek için eksponansiyel geri yükleme kullanmayı düşünebilirsiniz. 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 plan kullanımı

Üretken yapay zeka 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ılması 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: