تستفيد واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في ML Kit من إمكانات Gemini Nano لمساعدة تطبيقاتك في تنفيذ المهام. توفّر واجهات برمجة التطبيقات هذه جودة جاهزة للاستخدام لحالات الاستخدام الشائعة من خلال واجهة عالية المستوى. تم إنشاء واجهات برمجة التطبيقات الخاصة بالذكاء الاصطناعي التوليدي في ML Kit استنادًا إلى AICore، وهي خدمة نظام Android تتيح تنفيذ نماذج الذكاء الاصطناعي التوليدي الأساسية على الجهاز لتسهيل ميزات مثل تحسين وظائف التطبيقات وتحسين خصوصية المستخدم من خلال معالجة البيانات على الجهاز.
تنطبق بنود الخدمة الإضافية الخاصة بواجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي في ML Kit على استخدام واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي. يتحمّل المطوّرون وحدهم مسؤولية أمان برنامج واجهة برمجة التطبيقات وتجربة المستخدم في تطبيقاتهم.
الميزات الرئيسية
تتيح واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي في ML Kit الميزات التالية:
- التلخيص: تلخيص المقالات أو محادثات الدردشة في قائمة ذات تعداد نقطي
- التدقيق اللغوي: يمكنك تحسين المحتوى القصير من خلال تصحيح الأخطاء النحوية والإملائية.
- إعادة الكتابة: إعادة كتابة الرسائل القصيرة بأساليب أو نبرات مختلفة
- وصف الصورة: إنشاء وصف موجز لصورة معيّنة
- الطلب: إنشاء محتوى نصي استنادًا إلى طلب مخصّص نصي فقط أو طلب متعدّد الوسائط
مزايا واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي
على غرار ميزات ML Kit الحالية الأخرى، تعمل واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي بالكامل على الجهاز، وبالتالي توفّر المزايا التالية:
- تتم معالجة بيانات الإدخال والاستنتاج والإخراج على الجهاز
- تظل الوظائف كما هي بدون اتصال موثوق بالإنترنت
- عدم تحمّل أي تكلفة إضافية للخادم مقابل كل طلب API
بالإضافة إلى ذلك، بما أنّ واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي تستند إلى AICore وتعمل من خلال Gemini Nano، يمكن لكل تطبيق استخدام نموذج Gemini Nano المشترك والمثبّت على الجهاز. يؤدي ذلك إلى تجنُّب الحاجة إلى انتظار تنزيل نموذج إذا كان متوفّرًا على الجهاز، وبالتالي الحفاظ على مساحة التخزين. مزيد من المعلومات حول كيفية عزل AICore للطلبات من أجل حماية الخصوصية
البث المباشر مقابل البث غير المباشر
توفّر واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في ML Kit خيارَي البث وغير البث لتلقّي النتائج. تقدّم واجهة برمجة التطبيقات الخاصة بالبث الردود بشكل تدريجي أثناء إنشائها، ما يوفّر تدفقًا مستمرًا للبيانات. في المقابل، تنتظر واجهة برمجة التطبيقات غير المتدفقة إلى أن يكتمل الرد بالكامل قبل إرجاعه ككتلة واحدة.
اختَر واجهة برمجة تطبيقات البث للحصول على ردود طويلة، لأنّها تتيح تلقّي ملاحظات أولية بشكل أسرع. تكون واجهة برمجة التطبيقات غير المخصّصة للبث أكثر ملاءمةً للردود القصيرة أو عند معالجة النتائج على دفعات.
دعم الجهاز
تختلف واجهات برمجة التطبيقات الخاصة بميزات الذكاء الاصطناعي التوليدي (التلخيص والتدقيق اللغوي وإعادة الكتابة ووصف الصور) عن واجهة برمجة التطبيقات Prompt API من حيث الأجهزة المتوافقة، كما هو موضّح في الأقسام التالية.
توافُق الأجهزة مع واجهات برمجة التطبيقات الخاصة بالميزات
تتوفّر واجهات برمجة التطبيقات التلخيص والتدقيق اللغوي وإعادة الكتابة ووصف الصور على الأجهزة التالية، مع خطط لتوسيع نطاق التوافق ليشمل أجهزة إضافية:
- 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
قد يختلف مدى توفّر اللغات حسب إعدادات الجهاز والطُرز التي تم تنزيلها عليه.
الأجهزة المتوافقة مع Prompt API
تتوفّر Prompt API حاليًا على الأجهزة التالية:
nano-v2 |
|
nano-v3 |
|
استرداد إصدار Gemini Nano
تتوفّر إصدارات مختلفة من Gemini Nano على أجهزة مختلفة. للعودة إلى إصدار Gemini Nano على جهاز، استخدِم getBaseModelName().
الحصة لكل تطبيق
يفرض AICore حصة استنتاج لكل تطبيق، ما يعني أنّ إرسال عدد كبير جدًا من الطلبات إلى GenAI API في فترة قصيرة سيؤدي إلى ظهور الرد ErrorCode.BUSY. عند تلقّي خطأ من هذا النوع، ننصحك باستخدام التراجع الدليلي لإعادة محاولة إرسال الطلب.
الاستخدام في الخلفية
يُسمح باستنتاج GenAI API فقط عندما يكون التطبيق هو تطبيق المقدّمة الأعلى. سيؤدي استخدام واجهة برمجة التطبيقات عندما لا يكون التطبيق في المقدّمة، بما في ذلك استخدام خدمة تعمل في المقدّمة، إلى ظهور الرد ErrorCode.BUSY بسبب عدم توفّر حصة استخدام في الخلفية حاليًا.
نموذج التعليمات البرمجية
للحصول على هذا الرمز، اطّلِع على النماذج التالية: