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