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