مقدمة
Gemini هو خدمة دردشة AI مقدمة من Ace Data Cloud، وهو نموذج لغة كبير من سلسلة Google Gemini. من خلال واجهة برمجة التطبيقات الموحدة لـ Ace Data Cloud، يمكنك استخدام JavaScript للاندماج السريع مع Gemini لتحقيق محادثات متعددة الجولات، تعليمات النظام، الإخراج التدريجي، وضع الإخراج JSON، وغيرها من الميزات.المتطلبات الأساسية
- امتلاك حساب في Ace Data Cloud والحصول على API Token
- بيئة Node.js 18+ أو متصفح حديث
الاستخدام الأساسي
نقطة النهاية الرئيسية لاستدعاء Gemini API هي:gemini-2.5-flash.
النماذج المتاحة تشمل: gemini-2.5-flash، gemini-2.5-pro، gemini-2.0-flash، gemini-3.0-pro.
مثال كامل على كود JavaScript:
YOUR_API_TOKEN بالتوكن الفعلي الذي حصلت عليه من منصة Ace Data Cloud.
معالجة الاستجابة
يوصى بفحص رمز حالة الاستجابة ومعالجة الأخطاء:تغليف Node.js
يوصى بتغليف الوظيفة لتكون قابلة لإعادة الاستخدام:معالجة الأخطاء
أكواد الأخطاء الشائعة:| رمز الحالة | الوصف |
|---|---|
| 401 | فشل التوثيق، يرجى التحقق من API Token |
| 403 | رصيد غير كافٍ أو عدم وجود صلاحية الوصول |
| 429 | تجاوز معدل الطلبات المسموح به |
| 500 | خطأ داخلي في الخادم |
الخطوة التالية
- انتقل إلى لوحة تحكم Ace Data Cloud للحصول على API Token
- اطلع على توثيق API لفهم كامل المعلمات
- اطلع على خطط التسعير لمعرفة التكاليف

