نظرة عامة على واجهات برمجة التطبيقات الذكاء الاصطناعي التوليدي في ML Kit

تستفيد واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة من إمكانات Gemini Nano لمساعدة تطبيقاتك في تنفيذ مهام الذكاء الاصطناعي التوليدي على الجهاز فقط. تستند واجهات برمجة التطبيقات هذه إلى AICore، وهي خدمة تابعة لنظام التشغيل Android تدير النماذج الأساسية على الجهاز فقط وتسرّع عملية الاستدلال مع الحفاظ على خصوصية بيانات المستخدمين.

تنطبق بنود الخدمة الإضافية الخاصة بواجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة على استخدام واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي. يتحمّل المطوّرون وحدهم مسؤولية أمان عميل واجهة برمجة التطبيقات وتجربة المستخدم في تطبيقاتهم.

الإمكانات الأساسية

تنظّم "حزمة تعلّم الآلة" إمكانات الذكاء الاصطناعي التوليدي في الفئات التالية:

إنشاء مخصّص ووكلاء

يمكنك العمل مباشرةً مع نموذج Gemini Nano الأساسي لإنشاء طلبات مخصّصة وسير عمل مستقل مستند إلى الذكاء الاصطناعي الوكيل:

  • الوصول المباشر إلى النموذج (باستخدام فئة GenerativeModel): يمكنك إنشاء نص أو مخرجات منظَّمة مكتوبة من طلبات مخصّصة نصية فقط أو متعددة الوسائط، أو إدارة سجلّ المحادثات المتعددة الأدوار مباشرةً باستخدام عنصر List<Content> مع دورَي USER وMODEL وقيمة sessionId، وإدارة تعريفات الأدوات مباشرةً.
  • مهام سير العمل المستندة إلى الوكلاء (باستخدام فئة AgentRunner): تم إنشاؤها استنادًا إلى فئة GenerativeModel، وهي تتيح أتمتة إدارة الجلسات المتعددة الردود (بما في ذلك سجلّ المحادثات في الذاكرة) وحلقات استدعاء الأدوات المتعددة الخطوات.

الكلام والصوت

تحويل الكلام إلى نص وترجمته وتوليفه على الجهاز فقط:

مهام النصوص والصور

استخدِم واجهات برمجة التطبيقات المخصّصة لمهام معيّنة والمحسّنة لمهام الرؤية والكتابة والبحث الشائعة بدون هندسة الطلبات:

  • وصف الصورة: يمكنك إنشاء وصف قصير لصورة معيّنة.
  • التلخيص: يمكنك تلخيص المقالات أو محادثات Chat في شكل قائمة نقطية.
  • التدقيق اللغوي: يمكنك تحسين المحتوى القصير من خلال تحسين القواعد النحوية وتصحيح الأخطاء الإملائية.
  • إعادة الكتابة: إعادة كتابة الرسائل القصيرة بأساليب أو نبرات مختلفة
  • البحث الدلالي: يمكنك إنشاء تضمينات متّجهات للنصوص والصور باستخدام واجهة Embedding API وربطها بواجهة AndroidX AppSearch للعثور على المحتوى حسب المعنى.

مزايا واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي

على غرار ميزات "حزمة تعلّم الآلة" الحالية الأخرى، تعمل واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي بالكامل على الجهاز فقط، وبالتالي توفّر المزايا التالية:

  • تتم معالجة بيانات الإدخال والاستنتاج والإخراج على الجهاز
  • تظل الوظيفة كما هي بدون اتصال إنترنت موثوق
  • عدم تحمُّل أي تكلفة إضافية للخادم مقابل كل طلب بيانات من واجهة برمجة التطبيقات

بالإضافة إلى ذلك، بما أنّ واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي تستند إلى AICore وتعمل من خلال Gemini Nano، فإنّ التطبيقات وواجهات برمجة التطبيقات الخاصة بالمهام تشارك نموذج Gemini Nano الأساسي نفسه على الجهاز. يؤدي ذلك إلى تجنُّب الانتظار حتى يتم تنزيل نموذج منفصل إذا كان Gemini Nano متوفّرًا على الجهاز، وبالتالي يحافظ على مساحة التخزين. مزيد من المعلومات حول كيفية عزل AICore للطلبات من أجل حماية الخصوصية

البث مقابل عدم البث

توفّر واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة خيارات بث وغير بث لتلقّي النتائج. تقدّم واجهة برمجة التطبيقات الخاصة بالبث الردود بشكل تدريجي فور إنشائها، ما يوفّر تدفقًا مستمرًا للبيانات. في المقابل، تنتظر واجهة برمجة التطبيقات التي لا تستخدم ميزة البث حتى يكتمل الردّ بالكامل قبل عرضه ككتلة واحدة.

اختَر واجهة برمجة تطبيقات البث للردود الطويلة، لأنّها تتيح الحصول على ملاحظات أولية أسرع. تُعدّ واجهة برمجة التطبيقات غير المخصّصة لعرض الردود بشكل متواصل أكثر ملاءمةً للردود القصيرة أو عند معالجة النتائج على دفعات.

دعم الجهاز

يتم توضيح توافق الأجهزة مع ميزات إنشاء المحتوى المخصّص والوكلاء وواجهات برمجة التطبيقات لمهام النصوص والصور في الأقسام التالية. بالنسبة إلى أي ميزات غير مُدرَجة في هذا القسم، يُرجى الاطّلاع على صفحات الميزات الفردية للحصول على معلومات حول الأجهزة المتوافقة.

إنشاء مخصّص ودعم أجهزة الوكلاء

تتوفّر ميزتا الوصول المباشر إلى النموذج وسير العمل المستند إلى الذكاء الاصطناعي الوكيل على الأجهزة التالية:

nano-v2
  • ‫Honor: ‏Magic V5 وMagic 7 وMagic 7 Pro
  • iQOO: iQOO 13
  • ‫Motorola: Razr 60 Ultra وRazr Ultra 2025
  • ‫OnePlus: ‏ OnePlus 13 وOnePlus 13s
  • ‫OPPO: ‏Find N5
  • ‫POCO: ‏POCO F7 Ultra وPOCO F8 Pro وPOCO F8 Ultra وPOCO X7 Pro وPOCO X8 Pro
  • ‫realme: هاتف realme GT 7 Pro
  • ‫Samsung: Galaxy Z Fold7 وGalaxy Z TriFold
  • ‫vivo: ‏vivo X200 FE وvivo T4 Ultra
  • ‫Xiaomi: ‏ Xiaomi 14T Pro وXiaomi 15 وXiaomi 15T وXiaomi 15T Pro وXiaomi 15 Ultra وXiaomi 17 وXiaomi 17 Ultra وXiaomi Pad Mini

nano-v3
  • ‫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 Magic 8 Pro
  • iQOO: iQOO 15
  • ‫Lenovo: ‏Lenovo Idea Tab Pro Gen 2 وLenovo Legion Tab Gen 5(8.8")‎
  • Motorola: Signature
  • ‫OnePlus: ‏ OnePlus 15 وOnePlus 15R
  • ‫OPPO: ‏Find X9 وFind X9 Pro وFind X8 وFind X8 Pro وReno 14 Pro 5G وReno 15 Pro 5G وReno 15 Pro Mini 5G وReno 15 Pro Max 5G
  • ‫realme: ‏realme GT 7T
  • ‫Samsung: ‏Galaxy S26 وGalaxy S26+‎ وGalaxy S26 Ultra
  • ‫Sharp: AQUOS R11
  • Sony: Xperia 1 VIII
  • ‫vivo‏: vivo X200T وvivo X200 وvivo X200 Pro وvivo X300 وvivo X300 Pro

nano-v4
  • ‫Google: ‏Pixel 11 وPixel 11 Pro وPixel 11 Pro XL وPixel 11 Pro Fold
  • ‫Samsung: Galaxy Z Flip8 وGalaxy Z Fold8 وGalaxy Z Fold8 Ultra

الأجهزة المتوافقة مع مهام النصوص والصور

تتوفّر واجهات برمجة التطبيقات وصف الصورة والتلخيص والتدقيق اللغوي وإعادة الكتابة على الأجهزة التالية، مع خطط لتوسيع نطاق إتاحتها على أجهزة إضافية:

  • ‫Google: ‏ Pixel 11 وPixel 11 Pro وPixel 11 Pro XL وPixel 11 Pro Fold و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 7 وMagic 7 Pro وMagic 8 Pro وMagic V5
  • ‫iQOO: ‏ iQOO 13 وiQOO 15
  • ‫Lenovo: ‏Lenovo Idea Tab Pro Gen 2 وLenovo Legion Tab Gen 5(8.8")‎
  • ‫Motorola: ‏Razr 60 Ultra وRazr Ultra 2025 وSignature
  • ‫OnePlus: ‏ OnePlus 15 وOnePlus 15R وOnePlus 13 وOnePlus 13s
  • ‫OPPO: ‏ Find N5 وFind X9 وFind X9 Pro وFind X8 وFind X8 Pro وReno 14 Pro 5G وReno 15 Pro 5G وReno 15 Pro Mini 5G وReno 15 Pro Max 5G
  • ‫POCO: ‏POCO F7 Ultra وPOCO F8 Pro وPOCO F8 Ultra وPOCO X7 Pro وPOCO X8 Pro
  • ‫realme: ‏realme GT 7 Pro وrealme GT 7T
  • ‫Samsung: ‏Galaxy S25 وGalaxy S25+‎ وGalaxy S25 Ultra وGalaxy S26 وGalaxy S26+‎ وGalaxy S26 Ultra وGalaxy Z Flip8 وGalaxy Z Fold8 وGalaxy Z Fold8 Ultra وGalaxy Z Fold7 وGalaxy Z TriFold
  • ‫Sharp: AQUOS R11
  • Sony: Xperia 1 VIII
  • ‫vivo: ‏vivo X200T وvivo X200 FE وvivo X200 وvivo X200 Pro وvivo X300 وX300 Pro وvivo X Fold3 Pro وvivo X Fold5 وvivo T4 Ultra
  • ‫Xiaomi: ‏ Xiaomi 14T Pro وXiaomi 15 وXiaomi 15T وXiaomi 15T Pro وXiaomi 15 Ultra وXiaomi 17 وXiaomi 17 Ultra وXiaomi Pad Mini

قد يختلف مدى توفّر لغة معيّنة حسب إعدادات الجهاز والنماذج التي تم تنزيلها عليه.

استرداد إصدار Gemini Nano

تعمل إصدارات مختلفة من Gemini Nano على أجهزة مختلفة. لإرجاع إصدار Gemini Nano على جهاز، استخدِم طريقة getBaseModelName().

الحصة لكل تطبيق

تفرض AICore حصة استدلال لكل تطبيق. سيؤدي إرسال عدد كبير جدًا من طلبات البيانات من واجهة برمجة التطبيقات للذكاء الاصطناعي التوليدي في فترة قصيرة إلى ظهور استجابة ErrorCode.BUSY. عند تلقّي هذا الخطأ، ننصحك باستخدام التراجع الأسي لإعادة محاولة إرسال الطلب. ويمكن أيضًا عرض ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED إذا تجاوز أحد التطبيقات حصة طويلة المدة (على سبيل المثال، حصة يومية).

الاستخدام في الخلفية

يُسمح باستنتاج واجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي فقط عندما يكون التطبيق هو التطبيق الرئيسي الذي يعمل في المقدّمة. سيؤدي استخدام واجهة برمجة التطبيقات عندما لا يكون التطبيق في المقدّمة، بما في ذلك استخدام خدمة تعمل في المقدّمة، إلى ظهور استجابة ErrorCode.BACKGROUND_USE_BLOCKED.

نموذج الرموز البرمجية

للحصول على هذا الرمز، اطّلِع على النماذج التالية: