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