الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يعمل Dify بشكل جيد مع TokenLab من خلال تدفق مزود النموذج المتوافق مع OpenAI. هذا مسار تكامل موجه نحو إكمال المحادثات (chat-completions). لا ينبغي اعتباره ضماناً بأن Dify يكشف عن نفس الاستجابات أو سلوك WebSocket مثل تكاملات Codex المخصصة. بالنسبة لإصدارات Dify الحالية، المسار الأكثر أماناً هو عادةً:
  • اختيار مزود OpenAI المدمج
  • تعيين مفتاح API الخاص بـ TokenLab
  • تعيين عنوان أساسي (Base URL) مخصص هو https://api.tokenlab.sh/v1
تعرض بعض إصدارات Dify الأقدم هذا كـ OpenAI-API-compatible بدلاً من مزود OpenAI المدمج مع حقل عنوان أساسي مخصص. إذا كانت واجهة Dify الخاصة بك تبدو مختلفة، فاستخدم أقرب تدفق مزود مخصص متوافق مع OpenAI متاح في ذلك الإصدار.
النوع: إطار عمل أو منصةالمسار الأساسي: مسار المحادثة المتوافق مع OpenAIمستوى دعم الموثوقية: مدعوم مع حدود للنطاق

​
المتطلبات الأساسية

  • حساب TokenLab مع وصول إلى API
  • Dify Cloud أو نسخة Dify مستضافة ذاتياً

​
خطوات الإعداد

​
الخطوة 1: الحصول على مفتاح API الخاص بك

  1. سجل الدخول إلى TokenLab Dashboard
  2. افتح API Keys
  3. أنشئ أو انسخ مفتاح API يبدأ بـ sk-

​
الخطوة 2: تكوين المزود

1

فتح مزودي النماذج

في Dify، انتقل إلى Settings ← Model Providers
2

اختيار OpenAI

افتح إعدادات مزود OpenAI. إذا كان إصدار Dify الخاص بك لا يوفر عنواناً أساسياً مخصصاً هنا، فاستخدم خيار المزود المخصص المتوافق مع OpenAI الذي يوفره ذلك الإصدار بدلاً من ذلك.
3

إدخال إعدادات TokenLab

استخدم هذه القيم:
الحقلالقيمة
API Keysk-your-tokenlab-key
API Base URL / Custom Base URLhttps://api.tokenlab.sh/v1
4

إضافة النماذج

أضف النماذج التي تريد استخدامها، على سبيل المثال:
  • gpt-5.4
  • gpt-5.4-mini
  • claude-sonnet-5
  • claude-opus-4-8
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • deepseek-v4-flash

​
الخطوة 3: اختبار الاتصال

  1. اختر نموذجاً واحداً مثل gpt-5-mini أو gpt-4o
  2. أرسل رسالة اختبار (prompt)
  3. تأكد من أن Dify يتلقى استجابة صالحة

​
التضمينات (Embeddings) لقواعد المعرفة

بالنسبة لـ RAG وفهرسة قواعد المعرفة، أضف نموذج تضمين مثل:
  • text-embedding-3-small
  • text-embedding-3-large
ثم قم بتعيينه كنموذج التضمين الافتراضي في قاعدة المعرفة ذات الصلة أو إعدادات التطبيق.

​
أدوار النماذج الموصى بها

حالة الاستخدامالنماذج المقترحة
المحادثة الافتراضيةgpt-5.4-mini, gpt-5.4, claude-sonnet-5
الاستنتاج العميقgpt-5.5, gpt-5.4, claude-opus-4-8, deepseek-v4-pro
سريع/رخيصgpt-5.4-mini, gemini-3.5-flash, deepseek-v4-flash
التضميناتtext-embedding-3-small, text-embedding-3-large

​
أفضل الممارسات

في إصدارات Dify الأحدث، عادة ما يكون مزود OpenAI المدمج مع عنوان أساسي مخصص هو الإعداد الأنظف لـ TokenLab.
استخدم gpt-5.4-mini أو gemini-3.5-flash أو deepseek-v4-flash أثناء التكرار، ثم قم بتحويل سير العمل الثقيل إلى نماذج أقوى فقط عند الحاجة.
تستخدم معظم تدفقات Dify سلوك المحادثة المتوافق مع OpenAI. إذا كنت بحاجة إلى استجابات خاصة بـ Codex أو سلوك WebSocket، فاستخدم تكاملات Codex المخصصة بدلاً من Dify.

​
استكشاف الأخطاء وإصلاحها

  • تحقق من أن العنوان الأساسي هو بالضبط https://api.tokenlab.sh/v1
  • قم بإزالة الشرطات المائلة الزائدة إذا كان Dify يكررها
  • تأكد من أن خادم Dify يمكنه الوصول إلى TokenLab عبر الإنترنت العام
  • تحقق جيداً من مفتاح API
  • تأكد من أن المفتاح نشط في لوحة تحكم TokenLab
  • تأكد من أن القيمة التي تم لصقها في Dify لا تحتوي على مسافات إضافية أو فواصل أسطر
  • تحقق من اسم النموذج بدقة
  • أعد إضافة إدخال النموذج إذا قامت واجهة المزود بتخزين قيمة قديمة مؤقتاً
  • تحقق من توفر النموذج الحالي في وثائق TokenLab أو لوحة التحكم