تستفيد واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في ML Kit من إمكانات Gemini Nano لمساعدة تطبيقاتك في تنفيذ المهام. توفّر واجهات برمجة التطبيقات هذه جودة جاهزة للاستخدام لحالات الاستخدام الشائعة من خلال واجهة عالية المستوى. تم إنشاء واجهات برمجة التطبيقات الخاصة بالذكاء الاصطناعي التوليدي في ML Kit استنادًا إلى AICore، وهي خدمة نظام Android تتيح تنفيذ نماذج الذكاء الاصطناعي التوليدي الأساسية على الجهاز لتسهيل ميزات مثل تحسين وظائف التطبيقات وتحسين خصوصية المستخدم من خلال معالجة البيانات على الجهاز.
تنطبق بنود الخدمة الإضافية الخاصة بواجهة برمجة تطبيقات الذكاء الاصطناعي التوليدي في ML Kit على استخدام واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي. يتحمّل المطوّرون وحدهم مسؤولية أمان برنامج واجهة برمجة التطبيقات وتجربة المستخدم في تطبيقاتهم.
الميزات الرئيسية
تتيح واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي في ML Kit الميزات التالية:
- التلخيص: تلخيص المقالات أو محادثات الدردشة في قائمة ذات تعداد نقطي
- التدقيق اللغوي: يمكنك تحسين المحتوى القصير من خلال تصحيح الأخطاء النحوية والإملائية.
- إعادة الكتابة: إعادة كتابة الرسائل القصيرة بأساليب أو نبرات مختلفة
- وصف الصورة: إنشاء وصف قصير لصورة معيّنة
- التعرّف على الكلام: لتحويل المحتوى الصوتي إلى نص.
- الطلب: إنشاء محتوى نصي استنادًا إلى طلب مخصّص نصي فقط أو طلب متعدّد الوسائط
مزايا واجهات برمجة التطبيقات المستندة إلى الذكاء الاصطناعي التوليدي
على غرار ميزات ML Kit الحالية الأخرى، تعمل واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي بالكامل على الجهاز، وبالتالي توفّر المزايا التالية:
- تتم معالجة بيانات الإدخال والاستنتاج والإخراج على الجهاز
- تظل الوظائف كما هي بدون اتصال موثوق بالإنترنت
- عدم تحمّل أي تكلفة إضافية للخادم مقابل كل طلب API
بالإضافة إلى ذلك، بما أنّ واجهات برمجة تطبيقات الذكاء الاصطناعي التوليدي تستند إلى AICore وتعمل باستخدام Gemini Nano، يمكن لكل تطبيق استخدام نموذج Gemini Nano المشترك والمثبّت على الجهاز. يؤدي ذلك إلى تجنُّب الحاجة إلى انتظار تنزيل نموذج إذا كان متوفّرًا على الجهاز، وبالتالي الحفاظ على مساحة التخزين. مزيد من المعلومات حول كيفية عزل AICore للطلبات من أجل حماية الخصوصية
البث المباشر مقابل البث غير المباشر
توفّر واجهات برمجة التطبيقات المستنِدة إلى الذكاء الاصطناعي التوليدي في ML Kit خيارَي البث المباشر وغير المباشر لتلقّي النتائج. تقدّم واجهة برمجة التطبيقات الخاصة بالبث ردودًا بشكل تدريجي أثناء إنشائها، ما يوفّر تدفقًا مستمرًا للبيانات. في المقابل، تنتظر واجهة برمجة التطبيقات غير المتدفقة إلى أن يكتمل الرد بالكامل قبل إرجاعه ككتلة واحدة.
اختَر واجهة برمجة تطبيقات البث للحصول على ردود طويلة، لأنّها تتيح تلقّي ملاحظات أولية بشكل أسرع. تكون واجهة برمجة التطبيقات غير المتدفقة أكثر ملاءمةً للردود القصيرة أو عند معالجة النتائج على دفعات.
دعم الجهاز
تختلف واجهات برمجة التطبيقات الخاصة بميزات الذكاء الاصطناعي التوليدي (التلخيص والتدقيق اللغوي وإعادة الكتابة ووصف الصور) عن واجهة برمجة التطبيقات 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 Z Fold7
- 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.
نموذج التعليمات البرمجية
للحصول على هذا الرمز، اطّلِع على النماذج التالية: