مقدمة
Grok هو خدمة دردشة AI مقدمة من Ace Data Cloud، وهو جزء من سلسلة نماذج اللغة الكبيرة xAI Grok. من خلال واجهة برمجة التطبيقات الموحدة لـ Ace Data Cloud، يمكنك استخدام JavaScript لدمج Grok بسرعة، وتحقيق وظائف مثل المحادثات متعددة الجولات، وإرشادات النظام، والإخراج المتدفق، ووضع إخراج JSON، والفهم البصري.المتطلبات الأساسية
- امتلاك حساب في Ace Data Cloud والحصول على رمز API
- بيئة Node.js 18+ أو متصفح حديث
الاستخدام الأساسي
نقطة النهاية الرئيسية لاستدعاء واجهة برمجة تطبيقات Grok هي:grok-3.
النماذج المتاحة تشمل: grok-4، grok-4-1-fast، grok-3، grok-3-mini، grok-2-vision.
مثال كامل على كود JavaScript:
YOUR_API_TOKEN بالرمز الفعلي الذي حصلت عليه من منصة Ace Data Cloud.
معالجة الاستجابة
يوصى بفحص رمز حالة الاستجابة ومعالجة الأخطاء:تغليف Node.js
يوصى بتغليفه كدالة قابلة لإعادة الاستخدام:معالجة الأخطاء
أكواد الأخطاء الشائعة:| رمز الحالة | الوصف |
|---|---|
| 401 | فشل التوثيق، يرجى التحقق من رمز API |
| 403 | رصيد غير كافٍ أو عدم وجود صلاحية الوصول |
| 429 | تجاوز معدل الطلبات المسموح به |
| 500 | خطأ داخلي في الخادم |
الخطوة التالية
- توجه إلى لوحة تحكم Ace Data Cloud للحصول على رمز API
- اطلع على توثيق API لفهم كامل المعلمات
- اطلع على خطط التسعير لمعرفة التكاليف

