تستفيد واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة من إمكانات Gemini Nano لمساعدة تطبيقاتك في تنفيذ مهام الذكاء الاصطناعي التوليدي على الجهاز فقط. تستند واجهات برمجة التطبيقات هذه إلى AICore، وهي خدمة تابعة لنظام التشغيل Android تدير النماذج الأساسية على الجهاز فقط وتسرّع عملية الاستدلال مع الحفاظ على خصوصية بيانات المستخدمين.
تنطبق بنود الخدمة الإضافية الخاصة بواجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة على استخدام واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي. يتحمّل المطوّرون وحدهم مسؤولية أمان عميل واجهة برمجة التطبيقات وتجربة المستخدم في تطبيقاتهم.
الإمكانات الأساسية
تنظّم "حزمة تعلّم الآلة" إمكانات الذكاء الاصطناعي التوليدي في الفئات التالية:
إنشاء مخصّص ووكلاء
يمكنك العمل مباشرةً مع نموذج Gemini Nano الأساسي لإنشاء طلبات مخصّصة وتنفيذ مهام وكيل مستقلة:
- الوصول المباشر إلى النموذج (باستخدام فئة
GenerativeModel): يمكنك إنشاء نص أو مخرجات منظَّمة مكتوبة من طلبات مخصّصة نصية فقط أو متعددة الوسائط، أو إدارة سجلّ المحادثات المتعددة الأدوار مباشرةً باستخدام عنصرList<Content>مع دورَيUSERوMODELوقيمةsessionId، وإدارة تعريفات الأدوات مباشرةً. - مهام سير العمل المستندة إلى الوكلاء (باستخدام فئة
AgentRunner): تم إنشاؤها استنادًا إلى فئةGenerativeModel، وهي تتيح أتمتة إدارة الجلسات المتعدّدة الردود (بما في ذلك سجلّ المحادثات في الذاكرة) وحلقات استدعاء الأدوات المتعدّدة الخطوات.
الكلام والصوت
تحويل الكلام الصوتي إلى نص وترجمته وتوليفه على الجهاز فقط:
- التعرّف على الكلام: تحويل المحتوى الكلامي الصوتي إلى نص باللغة نفسها
- ترجمة الكلام: تتيح لك هذه الميزة ترجمة المحتوى الكلامي الصوتي إلى نص بلغة أخرى في الوقت الفعلي.
- تحويل النص إلى كلام: يمكنك إنشاء صوت كلام طبيعي من النص.
مهام النصوص والصور
استخدِم واجهات برمجة التطبيقات المخصّصة لمهام معيّنة والمحسّنة لمهام الرؤية والكتابة والبحث الشائعة بدون هندسة الطلبات:
- وصف الصورة: يمكنك إنشاء وصف قصير لصورة معيّنة.
- التلخيص: تلخيص المقالات أو محادثات Chat في شكل قائمة نقطية
- التدقيق اللغوي: يمكنك تحسين المحتوى القصير من خلال تحسين القواعد النحوية وتصحيح الأخطاء الإملائية.
- إعادة الكتابة: يمكنك إعادة كتابة الرسائل القصيرة بأساليب أو نبرات مختلفة.
- التضمينات: يمكنك إنشاء تضمينات متّجهات للنصوص والصور باستخدام واجهة Embeddings API وربطها بواجهة AppSearch في AndroidX للعثور على المحتوى حسب المعنى.
مزايا واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي
على غرار ميزات "حزمة تعلّم الآلة" الحالية الأخرى، تعمل واجهات برمجة التطبيقات الخاصة بالذكاء الاصطناعي التوليدي بالكامل على الجهاز فقط، وبالتالي توفّر المزايا التالية:
- تتم معالجة بيانات الإدخال والاستنتاج والإخراج محليًا
- تظل الوظيفة كما هي بدون اتصال إنترنت موثوق
- عدم تحمُّل أي تكلفة إضافية للخادم مقابل كل طلب بيانات من واجهة برمجة التطبيقات
بالإضافة إلى ذلك، بما أنّ واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي تستند إلى AICore وتعمل من خلال Gemini Nano، فإنّ التطبيقات وواجهات برمجة التطبيقات الخاصة بالمهام تشارك نموذج Gemini Nano الأساسي نفسه على الجهاز. يؤدي ذلك إلى تجنُّب الانتظار حتى يتم تنزيل نموذج منفصل إذا كان Gemini Nano متوفّرًا على الجهاز، وبالتالي يحافظ على مساحة التخزين. مزيد من المعلومات حول كيفية عزل AICore للطلبات من أجل حماية الخصوصية
البث مقابل عدم البث
توفّر واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في "حزمة تعلّم الآلة" خيارات بث وغير بث لتلقّي النتائج. تقدّم واجهة برمجة التطبيقات الخاصة بالبث الردود بشكل تدريجي فور إنشائها، ما يوفّر تدفقًا مستمرًا للبيانات. في المقابل، تنتظر واجهة برمجة التطبيقات التي لا تستخدم ميزة البث حتى يكتمل الردّ بالكامل قبل عرضه ككتلة واحدة.
اختَر واجهة برمجة تطبيقات البث للردود الطويلة، لأنّها تتيح الحصول على ملاحظات أولية أسرع. تُعدّ واجهة برمجة التطبيقات غير المخصّصة للبث أكثر ملاءمةً للردود القصيرة أو عند معالجة النتائج على دفعات.
دعم الجهاز
يتم توضيح مدى توافق الأجهزة مع ميزات الإنشاء المخصّص والوكلاء وواجهات برمجة التطبيقات لمهام النصوص والصور في الأقسام التالية. بالنسبة إلى أي ميزات غير مُدرَجة في هذا القسم، يُرجى الاطّلاع على صفحات الميزات الفردية للحصول على معلومات حول الأجهزة المتوافقة.
إنشاء مخصّص ودعم أجهزة الوكلاء
تتوفّر ميزتا الوصول المباشر إلى النموذج وسير العمل المستند إلى الذكاء الاصطناعي الوكيل على الأجهزة التالية:
Gemini Nano 2 |
|
Gemini Nano 3 |
|
Gemini Nano 4 |
|
قد يختلف مدى توفّر النموذج وإصداره حسب إعدادات ذاكرة الوصول العشوائي (RAM) في الجهاز وإصدار نظام التشغيل وحالة تحديث AICore. لمعرفة إصدار النموذج النشط على جهاز معيّن، يُرجى الاطّلاع على استرداد إصدار Gemini Nano.
الأجهزة التي تتيح تنفيذ المهام النصية والصورية
تتوفّر واجهات برمجة التطبيقات وصف الصورة والتلخيص والتدقيق اللغوي وإعادة الكتابة على الأجهزة التالية، مع خطط لتوسيع نطاق إتاحتها على أجهزة إضافية:
- Acer: جهاز Acer Googlebook 14
- ASUS: ASUS Googlebook 14
- Dell: XPS Googlebook
- 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 وHonor 600 Pro وMagic 7 وMagic 7 Pro وPorsche Design Magic 7 RSR وMagic 8 Pro وMagic V5 وMagic V6 وMagicPad 4
- HP: جهاز HP Googlebook 14
- iQOO: iQOO 13 وiQOO 15
- Lenovo: Lenovo Googlebook 15 وLenovo Idea Tab Pro Gen 2 وLenovo Legion Tab Gen 5(8.8") وLenovo Yoga Tab Plus Gen 2
- Motorola: Edge 70 Pro وEdge 70 Pro+ وRazr 60 Ultra وRazr Ultra 2025 وRazr Fold وSignature
- OnePlus: OnePlus 13 وOnePlus 13s وOnePlus 15 وOnePlus 15R وOnePlus Pad 3
- OPPO: Find N5 وFind N6 وFind X8 وFind X8 Pro وFind X9 وFind X9 Pro وFind X9s و Find X9 Ultra وFind X10 وFind X10 Pro Max وReno 14 Pro 5G وReno 15 Pro 5G و Reno 15 Pro Mini 5G وReno 15 Pro Max 5G وReno 16 Pro 5G
- POCO: POCO F7 Ultra وPOCO F8 Pro وPOCO F8 Ultra وPOCO F9 Pro وPOCO X7 Pro وPOCO X8 Pro وPOCO X8 Pro Max
- realme: realme GT 7 وrealme GT 7 Pro وrealme GT 7T وrealme GT 8 Pro
- Redmi: Redmi Turbo 5
- Samsung: Galaxy S25 وGalaxy S25+ وGalaxy S25 Edge وGalaxy S25 Ultra وGalaxy S26 وGalaxy S26+ وGalaxy S26 FE وGalaxy S26 Ultra وGalaxy Tab S12+ وGalaxy Tab S12 Ultra وGalaxy Z Flip7 وGalaxy Z Flip8 وGalaxy Z Fold7 وGalaxy Z Fold8 وGalaxy Z Fold8 Ultra وGalaxy Z TriFold
- Sharp: AQUOS R11
- Sony: Xperia 1 VIII
- vivo: vivo T4 Ultra وvivo X200 وvivo X200 FE وvivo X200 Pro وvivo X200T وvivo X300 وvivo X300 FE وvivo X300 Pro وvivo X300 Ultra وvivo X500 Pro وvivo X500 Pro Max وvivo X Fold3 Pro وvivo X Fold5 وvivo X Fold6
- Xiaomi: Leitzphone powered by Xiaomi وXiaomi 15 وXiaomi 15T وXiaomi 15T Pro وXiaomi 15 Ultra وXiaomi 17 وXiaomi 17T وXiaomi 17T Pro و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.
نموذج الرموز البرمجية
للحصول على هذا الرمز، اطّلِع على النماذج التالية: