با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
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 در دستگاه‌های زیر در دسترس هستند و برنامه‌هایی برای گسترش پشتیبانی به دستگاه‌های دیگر وجود دارد:
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 می‌شود.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["| This API is offered in beta, and is not subject to any SLA or deprecation policy. Changes may be made to this API that break backward compatibility.\n\nML Kit's GenAI APIs harness the power of [Gemini Nano](https://developer.android.com/ai/gemini-nano/) to help your apps\nperform tasks. These APIs provide out-of-the-box quality for popular use cases\nthrough a high-level interface. The ML Kit GenAI APIs are built on top of\n[AICore](https://android-developers.googleblog.com/2023/12/a-new-foundation-for-ai-on-android.html), an Android system service that enables on-device execution of GenAI\nfoundation models to facilitate features such as enhanced app functionality and\nimproved user privacy by processing data locally.\n\nThe ML Kit GenAI APIs support the following features:\n\n- [**Summarization**](/ml-kit/genai/summarization/android): Summarize articles or chat conversations as a bulleted list.\n- [**Proofreading**](/ml-kit/genai/proofreading/android): Polish short content by refining grammar and fixing spelling errors.\n- [**Rewriting**](/ml-kit/genai/rewriting/android): Rewrite short messages in different tones or styles.\n- [**Image description**](/ml-kit/genai/image-description/android): Generate a short description of a given image.\n\nBenefits of GenAI APIs\n\nSimilar to other existing ML Kit features, GenAI APIs run entirely on-device and\nthus provide the following benefits:\n\n- Input, inference, and output data is processed locally\n- Functionality remains the same without reliable internet connection\n- No additional server cost incurred for each API call\n\nIn addition, since GenAI APIs are built on top of AICore and powered by Gemini\nNano, every app is able to use the shared Gemini Nano model that is on the\ndevice. This avoids the need to have to wait for a model to be downloaded if it\nalready exists on a device, and in turn conserves storage space. Learn [more\nabout how AICore isolates requests to protect privacy](https://android-developers.googleblog.com/2024/10/introduction-to-privacy-and-safety-gemini-nano.html).\n\nStreaming versus non-streaming\n\nML Kit GenAI APIs offer both streaming and non-streaming options for receiving\nresults. The streaming API delivers responses incrementally as they are\ngenerated, providing a continuous flow of data. In contrast, the non-streaming\nAPI waits until the entire response is complete before returning it as a single\nblock.\n\nChoose the streaming API for lengthy responses, as it allows for quicker initial\nfeedback. The non-streaming API is more suitable for short responses or when\nprocessing results in batches.\n\nDevice support\n\nThe ML Kit GenAI APIs are available on the following devices, with\nplans to expand support to additional devices:\n\n- 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\n- Honor: Honor 400 Pro, Magic 6 Pro, Magic 6 RSR, Magic 7, Magic 7 Pro, Magic V3\n- iQOO: iQOO 13\n- Motorola: Razr 60 Ultra\n- OnePlus: OnePlus 13, OnePlus 13s\n- OPPO: Find N5, Find X8, Find X8 Pro\n- POCO: POCO F7 Ultra\n- realme: realme GT 7 Pro\n- Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Ultra\n- vivo: vivo X200, vivo X200 Pro, vivo X Fold3 Pro, vivo X Fold5\n- Xiaomi: Xiaomi 15 Ultra, Xiaomi 15\n\nAvailability of specific language support may vary depending on the particular\ndevice's configuration and the models that have been downloaded to the device.\n\nQuota per application\n\nAICore enforces an inference quota per app. This means that making too many\nGenAI API requests in a short period will result in an `ErrorCode.BUSY`\nresponse. When receiving such an error, consider using exponential backoff to\nretry the request.\n\nBackground usage\n\nGenAI API inference is permitted only when the app is the top foreground\napplication. Using the API when the app is not in the foreground, including\nusing a foreground service, will result in an `ErrorCode.BUSY` response due to\nthe current lack of background usage quota.\n\nSample code\n\nTo get this code, check out the following samples:\n\n- [ML Kit GenAI Samples](https://github.com/googlesamples/mlkit/tree/master/android/genai)\n- [Android AI Catalog Sample](https://github.com/android/ai-samples/tree/main/ai-catalog)"]]
