تستفيد واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في ML Kit من إمكانات Gemini Nano لمساعدة تطبيقاتك في تنفيذ المهام. توفّر واجهات برمجة التطبيقات هذه جودة جاهزة للاستخدام لحالات الاستخدام الشائعة من خلال واجهة عالية المستوى. تم إنشاء واجهات برمجة التطبيقات الخاصة بالذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة استنادًا إلى AICore، وهي خدمة تابعة لنظام التشغيل Android تتيح تنفيذ نماذج الذكاء الاصطناعي التوليدي الأساسية على الجهاز فقط لتسهيل ميزات مثل تحسين وظائف التطبيقات وتحسين خصوصية المستخدم من خلال معالجة البيانات على الجهاز.
تنطبق بنود الخدمة الإضافية الخاصة بواجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة على استخدام واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي. يتحمّل المطوّرون وحدهم مسؤولية أمان برنامج واجهة برمجة التطبيقات وتجربة المستخدم في تطبيقاتهم.
الميزات الرئيسية
تتيح واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة الميزات التالية:
- التلخيص: تلخيص المقالات أو محادثات Chat في قائمة ذات تعداد نقطي
- التدقيق اللغوي: يمكنك تحسين المحتوى القصير من خلال تنقيح القواعد النحوية وتصحيح الأخطاء الإملائية.
- إعادة الكتابة: إعادة كتابة الرسائل القصيرة بأساليب أو نبرات مختلفة
- وصف الصورة: إنشاء وصف قصير لصورة معيّنة
- التعرّف على الكلام: لتحويل المحتوى الصوتي إلى نص.
- الطلب: إنشاء محتوى نصي استنادًا إلى طلب مخصّص نصي فقط أو طلب متعدّد الوسائط
مزايا واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي
على غرار ميزات حزمة تعلّم الآلة الحالية الأخرى، تعمل واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي على الجهاز فقط، وبالتالي توفّر المزايا التالية:
- تتم معالجة بيانات الإدخال والاستنتاج والإخراج على الجهاز
- تظل الوظائف كما هي بدون اتصال موثوق بالإنترنت
- عدم تحمّل أي تكلفة إضافية للخادم مقابل كل طلب بيانات من واجهة برمجة التطبيقات
بالإضافة إلى ذلك، بما أنّ واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي تستند إلى 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 6 Pro وMagic 6 RSR وMagic 7 وMagic 7 Pro وMagic V3 وMagic V5
- iQOO: iQOO 13 وiQOO 15
- Motorola: Razr 60 Ultra
- OnePlus: OnePlus 13 وOnePlus 13s وOnePlus Pad 3
- هواتف OPPO: Find N5 وFind X8 وFind X8 Pro وReno 14 Pro
- POCO: POCO F7 Ultra وPOCO X7 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 X200 وvivo X200 Pro وvivo X300 وX300 Pro وvivo X Fold3 Pro وvivo X Fold5
- Xiaomi: Xiaomi 15 Ultra وXiaomi 15 وXiaomi 15T Pro وXiaomi 15T وXiaomi Pad Mini
قد يختلف مدى توفّر اللغات حسب إعدادات الجهاز والطُرز التي تم تنزيلها عليه.
الأجهزة المتوافقة مع Prompt API
تتوفّر Prompt API على الأجهزة التالية:
nano-v2 |
|
nano-v3 |
|
الأجهزة المتوافقة مع واجهة برمجة التطبيقات Speech Recognition API
تتوفّر واجهة برمجة التطبيقات للتعرّف على الكلام على الأجهزة التالية:
| الوضع الأساسي | يستخدم نموذج التعرّف التقليدي على الكلام على الجهاز فقط، وهو متاح على معظم أجهزة Android التي تعمل بالمستوى 31 لواجهة برمجة التطبيقات والإصدارات الأحدث. |
|---|---|
| الوضع المتقدم | تستفيد هذه الميزة من نموذج الذكاء الاصطناعي التوليدي لتقديم ترجمة بجودة أعلى وبلغات أكثر. متاحة على أجهزة Pixel 10، ويجري العمل على توفيرها على المزيد من الأجهزة. |
استرداد إصدار Gemini Nano
تتوفّر إصدارات مختلفة من Gemini Nano على أجهزة مختلفة. للعودة إلى إصدار Gemini Nano على جهاز، استخدِم getBaseModelName().
الحصة لكل تطبيق
يفرض AICore حصة استنتاج لكل تطبيق، وسيؤدي إرسال عدد كبير جدًا من طلبات GenAI API في فترة قصيرة إلى ظهور الرد ErrorCode.BUSY. عند تلقّي خطأ من هذا النوع، ننصحك باستخدام التراجع الدليلي لإعادة محاولة تنفيذ الطلب. يمكن أيضًا عرض الرمز ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED إذا تجاوز أحد التطبيقات حصة طويلة المدة (مثل الحصة اليومية).
الاستخدام في الخلفية
يُسمح باستنتاج GenAI API فقط عندما يكون التطبيق هو تطبيق المقدّمة الأعلى. سيؤدي استخدام واجهة برمجة التطبيقات عندما لا يكون التطبيق في المقدّمة، بما في ذلك استخدام خدمة تعمل في المقدّمة، إلى ظهور الردّ ErrorCode.BACKGROUND_USE_BLOCKED.
نموذج التعليمات البرمجية
للحصول على هذا الرمز، اطّلِع على النماذج التالية: