مروری بر ML Kit GenAI API

رابط‌های برنامه‌نویسی کاربردی GenAI کیت ML، قدرت Gemini Nano را برای کمک به برنامه‌های شما در انجام وظایفشان مهار می‌کنند. این رابط‌های برنامه‌نویسی کاربردی، کیفیت آماده‌ای را برای موارد استفاده رایج از طریق یک رابط سطح بالا فراهم می‌کنند. رابط‌های برنامه‌نویسی کاربردی GenAI کیت ML بر پایه AICore ، یک سرویس سیستم اندروید، ساخته شده‌اند که امکان اجرای مدل‌های پایه GenAI را روی دستگاه فراهم می‌کند تا ویژگی‌هایی مانند عملکرد پیشرفته برنامه و بهبود حریم خصوصی کاربر را با پردازش داده‌ها به صورت محلی تسهیل کند.

شرایط خدمات اضافی ML Kit GenAI API برای استفاده از APIهای GenAI اعمال می‌شود. توسعه‌دهندگان صرفاً مسئول ایمنی کلاینت API و تجربه کاربری برنامه خود هستند.

ویژگی‌های کلیدی

رابط‌های برنامه‌نویسی کاربردی (API) ML Kit GenAI از ویژگی‌های زیر پشتیبانی می‌کنند:

  • خلاصه‌سازی : مقالات یا مکالمات چت را به صورت فهرست نقطه‌ای خلاصه کنید.
  • تصحیح : محتوای کوتاه را با اصلاح دستور زبان و رفع خطاهای املایی، اصلاح کنید.
  • بازنویسی : پیام‌های کوتاه را با لحن‌ها یا سبک‌های مختلف بازنویسی کنید.
  • توضیحات تصویر : توضیحی کوتاه برای تصویر داده شده ایجاد کنید.
  • اعلان : تولید محتوای متنی بر اساس یک اعلان متنی سفارشی یا چندوجهی.

مزایای رابط‌های برنامه‌نویسی کاربردی GenAI

مشابه سایر ویژگی‌های موجود کیت یادگیری ماشین، رابط‌های برنامه‌نویسی کاربردی GenAI کاملاً روی دستگاه اجرا می‌شوند و بنابراین مزایای زیر را ارائه می‌دهند:

  • داده‌های ورودی، استنتاج و خروجی به صورت محلی پردازش می‌شوند
  • عملکرد بدون اتصال به اینترنت قابل اعتماد یکسان است
  • بدون هزینه اضافی سرور برای هر فراخوانی API

علاوه بر این، از آنجایی که APIهای GenAI بر پایه AICore ساخته شده‌اند و توسط Gemini Nano پشتیبانی می‌شوند، هر برنامه‌ای قادر به استفاده از مدل مشترک Gemini Nano موجود در دستگاه است. این امر از نیاز به انتظار برای دانلود مدلی که از قبل در دستگاه وجود دارد، جلوگیری می‌کند و به نوبه خود فضای ذخیره‌سازی را حفظ می‌کند. درباره نحوه جداسازی درخواست‌ها توسط AICore برای محافظت از حریم خصوصی بیشتر بدانید.

پخش زنده در مقابل عدم پخش زنده

APIهای ML Kit GenAI هر دو گزینه‌ی استریمینگ و غیر استریمینگ را برای دریافت نتایج ارائه می‌دهند. API استریمینگ پاسخ‌ها را به صورت تدریجی و همزمان با تولید آنها ارسال می‌کند و جریان پیوسته‌ای از داده‌ها را فراهم می‌کند. در مقابل، API غیر استریمینگ منتظر می‌ماند تا کل پاسخ کامل شود و سپس آن را به عنوان یک بلوک واحد بازگرداند.

برای پاسخ‌های طولانی، API استریمینگ را انتخاب کنید، زیرا امکان بازخورد اولیه سریع‌تر را فراهم می‌کند. API غیر استریمینگ برای پاسخ‌های کوتاه یا هنگام پردازش نتایج به صورت دسته‌ای مناسب‌تر است.

پشتیبانی دستگاه

APIهای مختص GenAI (خلاصه‌سازی، تصحیح، بازنویسی و توصیف تصویر) پشتیبانی دستگاهی متفاوتی نسبت به Prompt API دارند، همانطور که در بخش‌های بعدی توضیح داده شده است.

پشتیبانی از دستگاه API با ویژگی‌های خاص

رابط‌های برنامه‌نویسی کاربردی (API) خلاصه‌سازی ، تصحیح ، بازنویسی و توصیف تصویر در دستگاه‌های زیر موجود است و برنامه‌هایی برای گسترش پشتیبانی به دستگاه‌های دیگر نیز در نظر گرفته شده است:

  • گوگل: پیکسل ۱۰، پیکسل ۱۰ پرو، پیکسل ۱۰ پرو ایکس‌ال، پیکسل ۱۰ پرو فولد، پیکسل ۹، پیکسل ۹ پرو، پیکسل ۹ پرو ایکس‌ال، پیکسل ۹ پرو فولد
  • آنر: آنر ۴۰۰ پرو، مجیک ۶ پرو، مجیک ۶ آر اس آر، مجیک ۷، مجیک ۷ پرو، مجیک وی ۳، مجیک وی ۵
  • آی‌کیو او او: آی‌کیو او ۱۳
  • موتورولا: ریزر ۶۰ اولترا
  • وان‌پلاس: وان‌پلاس ۱۳، وان‌پلاس ۱۳s، وان‌پلاس پد ۳
  • اوپو: فایند N5، فایند X8، فایند X8 پرو، رینو 14 پرو
  • POCO: POCO F7 Ultra، POCO X7 Pro
  • ریلمی: ریلمی GT 7 پرو، ریلمی GT 7T
  • سامسونگ: گلکسی S25، گلکسی S25+، گلکسی S25 اولترا، گلکسی Z فولد 7
  • vivo: vivo X200، vivo X200 Pro، vivo X Fold3 Pro، vivo X Fold5
  • شیائومی: شیائومی ۱۵ اولترا، شیائومی ۱۵، شیائومی ۱۵تی پرو، شیائومی ۱۵تی، شیائومی پد مینی

در دسترس بودن پشتیبانی از زبان‌های خاص ممکن است بسته به پیکربندی دستگاه خاص و مدل‌هایی که در دستگاه دانلود شده‌اند، متفاوت باشد.

پشتیبانی سریع دستگاه API

API Prompt در حال حاضر در دستگاه‌های زیر پشتیبانی می‌شود:

نانو-v2

  • گوگل: پیکسل ۹، پیکسل ۹ پرو، پیکسل ۹ پرو ایکس‌ال، پیکسل ۹ پرو فولد
  • آنر: مجیک V5، مجیک 7، مجیک 7 پرو
  • آی‌کیو او او: آی‌کیو او ۱۳
  • موتورولا: ریزر ۶۰ اولترا
  • وان‌پلاس: وان‌پلاس ۱۳، وان‌پلاس ۱۳s، وان‌پلاس پد ۳
  • اوپو: N5 را پیدا کنید
  • پوکو: پوکو F7 اولترا
  • ریلمی: ریلمی GT 7 پرو
  • سامسونگ: گلکسی زد فولد ۷
  • شیائومی: شیائومی ۱۵ اولترا، شیائومی ۱۵

نانو-v3

  • گوگل: پیکسل ۱۰، پیکسل ۱۰ پرو، پیکسل ۱۰ پرو ایکس‌ال، پیکسل ۱۰ پرو فولد

نسخه نانو جمینی را بازیابی کنید

نسخه‌های مختلف Gemini Nano روی دستگاه‌های مختلف اجرا می‌شوند. برای بازگرداندن نسخه Gemini Nano روی یک دستگاه، از getBaseModelName() استفاده کنید.

سهمیه به ازای هر درخواست

AICore سهمیه استنتاج را برای هر برنامه اعمال می‌کند. ارسال درخواست‌های زیاد GenAI API در یک دوره کوتاه منجر به پاسخ ErrorCode.BUSY خواهد شد. هنگام دریافت چنین خطایی، استفاده از backoff نمایی را برای امتحان مجدد درخواست در نظر بگیرید. همچنین، ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED می‌تواند در صورتی که یک برنامه از سهمیه طولانی مدت (مثلاً سهمیه روزانه) تجاوز کند، بازگردانده شود.

استفاده در پس‌زمینه

استنتاج API مربوط به GenAI فقط زمانی مجاز است که برنامه در صدر برنامه‌های پیش‌زمینه باشد. استفاده از API زمانی که برنامه در پیش‌زمینه نیست، از جمله استفاده از یک سرویس پیش‌زمینه، منجر به پاسخ ErrorCode.BACKGROUND_USE_BLOCKED خواهد شد.

کد نمونه

برای دریافت این کد، نمونه‌های زیر را بررسی کنید: