APIهای GenAI کیت ML از قدرت Gemini Nano برای کمک به برنامه‌های شما در انجام وظایف استفاده می‌کنند. این APIها کیفیتی خارج از جعبه را برای موارد استفاده رایج از طریق یک رابط سطح بالا ارائه می کنند. APIهای ML Kit GenAI بر روی AICore ساخته شده‌اند، یک سرویس سیستم اندروید که اجرای مدل‌های پایه GenAI را بر روی دستگاه امکان‌پذیر می‌سازد تا ویژگی‌هایی مانند بهبود عملکرد برنامه و بهبود حریم خصوصی کاربر را با پردازش داده‌ها به صورت محلی تسهیل کند.
API های ML Kit GenAI از ویژگی های زیر پشتیبانی می کنند:
- خلاصه سازی : مقالات یا مکالمات چت را به عنوان یک لیست گلوله ای خلاصه کنید.
- تصحیح : محتوای کوتاه لهستانی با اصلاح دستور زبان و رفع خطاهای املایی.
- بازنویسی : پیام های کوتاه را با رنگ ها یا سبک های مختلف بازنویسی کنید.
- توضیحات تصویر : یک توضیح کوتاه از یک تصویر داده شده ایجاد کنید.
مزایای GenAI API
مشابه سایر ویژگی‌های کیت ML موجود، APIهای GenAI کاملاً روی دستگاه اجرا می‌شوند و بنابراین مزایای زیر را ارائه می‌کنند:
- داده های ورودی، استنتاج و خروجی به صورت محلی پردازش می شوند
- عملکرد بدون اتصال به اینترنت قابل اعتماد یکسان است
- هیچ هزینه سرور اضافی برای هر تماس API متحمل نمی شود
علاوه بر این، از آنجایی که رابط‌های برنامه‌نویسی GenAI بر روی AICore ساخته شده‌اند و توسط Gemini Nano پشتیبانی می‌شوند، هر برنامه می‌تواند از مدل مشترک Gemini Nano که در دستگاه است استفاده کند. این امر از نیاز به صبر کردن برای دانلود یک مدل در صورتی که قبلاً در دستگاهی موجود است، جلوگیری می کند و به نوبه خود باعث صرفه جویی در فضای ذخیره سازی می شود. درباره نحوه جداسازی درخواست ها برای محافظت از حریم خصوصی AICore بیشتر بیاموزید.
پخش جریانی در مقابل عدم پخش جریانی
APIهای ML Kit GenAI گزینه‌های پخش و غیراستریم را برای دریافت نتایج ارائه می‌دهند. API استریم پاسخ‌ها را به‌صورت تدریجی در حین تولید ارائه می‌کند و جریان پیوسته داده‌ها را فراهم می‌کند. در مقابل، API غیر جریانی منتظر می ماند تا کل پاسخ کامل شود و سپس آن را به صورت یک بلوک برگرداند.
API جریان را برای پاسخ‌های طولانی انتخاب کنید، زیرا امکان بازخورد اولیه سریع‌تر را فراهم می‌کند. API غیر جریانی برای پاسخ‌های کوتاه یا زمانی که نتایج پردازش به صورت دسته‌ای انجام می‌شود، مناسب‌تر است.
پشتیبانی دستگاه
APIهای ML Kit GenAI در دستگاه‌های زیر در دسترس هستند و برنامه‌هایی برای گسترش پشتیبانی به دستگاه‌های دیگر وجود دارد:
- گوگل: پیکسل 10، پیکسل 10 پرو، پیکسل 10 پرو XL، پیکسل 10 پرو فولد، پیکسل 9، پیکسل 9 پرو، پیکسل 9 پرو XL، پیکسل 9 پرو فولد
- Honor: Honor 400 Pro، Magic 6 Pro، Magic 6 RSR، Magic 7، Magic 7 Pro، Magic V3
- iQOO: iQOO 13
- موتورولا: Razr 60 Ultra
- OnePlus: OnePlus 13، OnePlus 13s
- OPPO: N5، X8، X8 Pro را بیابید
- POCO: POCO F7 Ultra
- realme: realme GT 7 Pro
- سامسونگ: Galaxy S25، Galaxy S25+، Galaxy S25 Ultra
- vivo: vivo X200، vivo X200 Pro، vivo X Fold3 Pro، vivo X Fold5
- شیائومی: Xiaomi 15 Ultra، Xiaomi 15
در دسترس بودن پشتیبانی زبان خاص ممکن است بسته به پیکربندی دستگاه خاص و مدل هایی که در دستگاه دانلود شده اند متفاوت باشد.
سهمیه در هر درخواست
AICore یک سهمیه استنتاج در هر برنامه را اعمال می کند. این به این معنی است که درخواست های GenAI API بیش از حد در یک دوره کوتاه منجر به پاسخ ErrorCode.BUSY می شود. هنگام دریافت چنین خطایی، استفاده از عقب نشینی نمایی را برای امتحان مجدد درخواست در نظر بگیرید.
استفاده از پس زمینه
استنتاج GenAI API تنها زمانی مجاز است که برنامه، برنامه پیش‌زمینه برتر باشد. استفاده از API زمانی که برنامه در پیش‌زمینه نیست، از جمله استفاده از سرویس پیش‌زمینه، به دلیل کمبود فعلی سهمیه استفاده از پس‌زمینه، منجر به پاسخ ErrorCode.BUSY می‌شود.
کد نمونه
برای دریافت این کد، نمونه های زیر را بررسی کنید: