عملية التقديم
للتكامل مع Ace Data Cloud في LobeChat، انتقل أولاً إلى وحدة تحكم Ace Data Cloud، واحصل على API Token الخاص بك، واحتفظ به للاستخدام لاحقاً.
إذا لم تقم بتسجيل الدخول أو التسجيل بعد، فستتم إعادة توجيهك تلقائياً إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد التسجيل وتسجيل الدخول ستعود تلقائياً إلى الصفحة الحالية.
عند التقديم لأول مرة، سيتم منحك رصيد مجاني، ويمكنك تجربة خدمات نماذج Ace Data Cloud مجاناً.
إعداد Ace Data Cloud
ادخل إلى إعدادات التطبيق → نماذج اللغة في LobeChat، واعثر على بطاقة OpenAI وقم بتمكينها، ثم املأ:
عند استخدام واجهة Chat Completions، يرجى إبقاء Responses API Specification معطّلاً.لا يقوم LobeChat تلقائياً بإلحاق
/v1 بـ Base URL، ويكون مسار الطلب مباشرةً {عنوان وكيل API}/chat/completions:
يستدعي LobeChat افتراضياً
/v1/models لجلب النماذج تلقائياً. وعندما يكون عدد النماذج التي يعيدها Ace Data Cloud كبيراً، تصبح الواجهة طويلة جداً، لذا يُنصح بملء allow list يدوياً في «قائمة النماذج → أسماء النماذج المخصصة»، مفصولة بفواصل إنجليزية. إذا كنت تحتاج إلى اسم عرض مخصص، يمكنك استخدام =، بالتنسيق MODEL_ID=اسم العرض.
اختيار النموذج
سيستمر كتالوج النماذج في التحديث. استخدم قائمة النماذج التي يحمّلها العميل تلقائياً كأولوية؛ وعند الحاجة إلى الملء اليدوي، اطلب أولاًGET https://api.acedata.cloud/v1/models للحصول على MODEL ID الحالي، ثم اختر وفقاً لقدرات السياق والصور واستدعاء الأدوات التي يدعمها العميل.
التحقق من التكامل
إذا لم تكن متأكداً مما إذا كانت المشكلة في LobeChat أو في الشبكة، يمكنك أولاً استخدام curl للتحقق مباشرةً من نقطة النهاية (استبدل{token} بـ Token الخاص بك):
chat.completion متوافق مع OpenAI يعني أن Token ونقطة النهاية جاهزان؛ وإذا تم إرجاع HTTP 403 used_up فهذا يعني أن Token صالح لكن الرصيد غير كافٍ، ويمكنك إعادة الشحن من وحدة التحكم.
متقدم: النشر الذاتي باستخدام Docker
إذا كنت ترغب في نشر نسخة خاصة لاستخدام الفريق، يمكنك تشغيلها بأمر Docker من سطر واحد (استبدل{token} بـ Token الخاص بك):
http://IP-الخادم-الخاص-بك:3210، وأدخل ACCESS_CODE للاستخدام، ولا يحتاج أعضاء الفريق إلى ملء Key الخاص بهم. للاطلاع على الوصف الكامل لمتغيرات البيئة مثل OPENAI_API_KEY وOPENAI_PROXY_URL وOPENAI_MODEL_LIST المستخدمة أعلاه، راجع وثائق متغيرات بيئة موفري نماذج LobeChat. إذا كنت تستخدم nginx كوكيل عكسي لإضافة HTTPS، فتأكد من إضافة proxy_buffering off;، وإلا فسيتم تخزين الاستجابات المتدفقة مؤقتاً. لمزيد من أشكال النشر، يرجى الرجوع إلى دليل البدء بالنشر الذاتي لـ LobeChat والنشر باستخدام Docker Compose.
الأسئلة الشائعة
ظهور 404 Not Found
عادةً ما يكون عنوان وكيل API مكتوباً بالشكل.../openai/v1 أو أن /v1 مفقود. غيّره إلى https://api.acedata.cloud/v1.
قائمة النماذج فارغة
فعّل مفتاح «وضع طلب العميل»؛ أو املأ allow list للنماذج يدوياً في «أسماء النماذج المخصصة».ظهور 401 Unauthorized
يرجى التأكد من أن API Key الملصق هو Token الخاص بـ Ace Data Cloud (من دون بادئةBearer ومن دون مسافات إضافية)، وأن رصيد التطبيق التابع له كافٍ.