ما الذي ستبنيه
أي خدمة API تتيح لك إضافة المزيد من نماذج الذكاء الاصطناعي إلى Dify دون إعداد كل موفر بشكل منفصل؟ CometAPI خيار عملي. ثبّت إضافة نموذج Dify الخاصة بـ CometAPI مرة واحدة، واحفظ مفتاح CometAPI واحدًا، واستخدم نماذج من OpenAI وAnthropic وGoogle وDeepSeek في مساحة عمل Dify نفسها.
مفتاح واحد لا يعني تكوين نموذج واحد: يقوم CometAPI بمركزة المصادقة والوصول إلى API، لكن Dify لا يزال بحاجة لمعرفة أي نموذج يجب أن يستدعيه كل عقدة LLM. لذلك قد تُعدِّد تكوينات معرفات النماذج تحت اتصال الموفر نفسه.
بنهاية هذا الدليل، سيكون لديك أربعة نماذج نصية متاحة لـ Dify ضمن اتصال موفر واحد. سيكون لديك أيضًا اختبار Python بسيط للتحقق يستخدم نفس المنفذ والمفتاح خارج Dify، مما يجعل من الأسهل فصل مشكلة تكوين Dify عن مشكلة API.
بعد حفظ اتصال الموفر، أضف أو فعّل كل معرف نموذج كتكوين منفصل قابل للاختيار. هذا يبقي القدرات والحدود وقرارات التوجيه الخاصة بكل نموذج مرئية بينما تظل المصادقة والربط بالفوترة مشتركة.
قبل أن تبدأ
تحتاج إلى مساحة عمل Dify حيث يمكنك تثبيت إضافات النماذج، ومفتاح API من CometAPI، ومعرفات النماذج الحالية. احتفظ بالمفتاح في مخزن بيانات اعتماد Dify أو سر على جهة الخادم؛ لا تضعه في مستودع عام، أو حزمة المتصفح، أو لقطة شاشة، أو تصدير سير عمل مشترك.
عنوان URL الأساسي المتوافق مع OpenAI هو https://api.cometapi.com/v1. يقوم ملحق Dify الخاص بـ CometAPI بتعيين هذه النهاية داخليًا. إذا استخدمت مزود Dify العام المتوافق مع OpenAI API بدلاً من ذلك، أدخل نفس عنوان URL الأساسي يدويًا.
هل يمكنك إضافة نماذج ذكاء اصطناعي متعددة إلى Dify باستخدام مفتاح API واحد؟
نعم. يتيح اتصال موفر CometAPI لـ Dify إعادة استخدام بيانات اعتماد واحدة للنماذج المدعومة من OpenAI وAnthropic وGoogle وDeepSeek وغيرها. لا يزال عليك تكوين كل معرف نموذج بشكل منفصل حتى تعرف كل عقدة LLM أي مسار تستدعيه، لكنك لست بحاجة إلى الحفاظ على بيانات اعتماد upstream وحساب فوترة مختلف لكل عائلة نماذج.
لماذا تستخدم CometAPI بدلاً من ربط كل موفر مباشرة؟
يقلل CometAPI من عبء التكامل من خلال توفير عنوان URL أساسي واحد، ومفتاح API واحد، وحساب استخدام واحد لأحمال عمل الدردشة المتوافقة. هذا يجعل تقييم النماذج والتبديل بينها أسهل داخل Dify مع إبقاء اختيارات النماذج الخاصة مرئية. قد تظل الاتصالات المباشرة بالموفر مفضلة عندما تحتاج إلى ميزة خاصة بالموفر، أو عقد، أو نشر إقليمي، أو ترتيبات دعم، لذا اختبر القدرات الدقيقة للنموذج المطلوبة في سير عملك.
أي نماذج يمكنك إضافتها إلى Dify؟
| العائلة | معرّف نموذج CometAPI | تاريخ نشر CometAPI (UTC) | التسعير المباشر |
|---|---|---|---|
| OpenAI | gpt-5.6 | July 9, 2026 | عرض الأسعار الحالية |
| Claude | claude-opus-5 | July 24, 2026 | عرض الأسعار الحالية |
| Gemini | gemini-3.7-flash | August 13, 2026 | عرض الأسعار الحالية |
| DeepSeek | deepseek-v4-flash | August 12, 2026 | عرض الأسعار الحالية |
تم التحقق من المعرفات الحالية وتواريخ نشر CometAPI أعلاه مقابل Public catalog API بتاريخ August 26, 2026. استخدم صفحة نموذج CometAPI المرتبطة كمصدر تسعير ديناميكي بدلاً من نسخ سعر قد يصبح قديماً. يمكن أن تتغير الإتاحة والوسائط ودعم إضافات Dify أيضًا، لذا أكد النموذج الدقيق في حسابك قبل النشر.
كيفية ربط CometAPI بـ Dify
الخطوة 1 — تثبيت إضافة نموذج CometAPI
افتح Marketplace أو قسم Plugins في Dify وابحث عن CometAPI. ثبّت CometAPI model provider plugin. قد تختلف عناوين التنقل بين إصدارات Dify Cloud والإصدارات ذاتية الاستضافة، لذا استخدم شاشة التكوين الحالية للإضافة بدلاً من الاعتماد على مسار قائمة ثابت.
الخطوة 2 — تكوين موفر CometAPI
افتح شاشة التكوين الحالية لإضافة CometAPI، والصق مفتاح CometAPI الخاص بك، واحفظ بيانات اعتماد الموفر. قد يقوم Dify بالتحقق منه بطلب نموذج صغير. تقوم الإضافة بتوجيه أحمال عمل الدردشة المتوافقة عبر https://api.cometapi.com/v1، لذا لست بحاجة إلى بيانات اعتماد منفصلة لـ OpenAI وAnthropic وGoogle وDeepSeek.
إذا لم يكن بإمكان نشر Dify لديك تثبيت إضافة CometAPI، فثبّت مزود النماذج الرسمي المتوافق مع OpenAI-API-compatible بدلاً من ذلك. أضف كل نموذج كـ LLM في وضع Chat، وأعد استخدام مفتاح CometAPI نفسه، واضبط API Base URL على https://api.cometapi.com/v1. يطلب منك مسار الطوارئ هذا إنشاء إدخال مخصص لكل نموذج، لكنه لا يزال يتجنب حسابات موفر منفصلة.
الخطوة 3 — إضافة معرفات النماذج الأربعة
ارجع إلى موفر CometAPI وابحث عن المعرفات الأربعة في قائمة النماذج. إذا كان أحد المعرفات محددًا مسبقًا، فعِّله. إذا لم يكن مرئيًا بعد في إصدار الإضافة المثبّت لديك، اختر خيار النموذج المخصص للموفر وأدخل المعرف الحالي الدقيق من الجدول أعلاه. اترك Completion mode مضبوطًا على Chat.
عندما يطلب Dify حجم السياق لنموذج مخصص، استخدم القيمة المُتحقق منها بدلاً من قيمة افتراضية مُخمّنة. بالنسبة لمفاتيح الوسائط المتعددة، فعّل فقط القدرات المعروضة في الدليل المباشر. قد يدعم نموذج ما Chat Completions دون دعم الصور أو الأدوات أو المخرجات المهيكلة أو عناصر التحكّم في الاستدلال بالطريقة نفسها لنموذج آخر.
الخطوة 4 — اختيار نموذج في تطبيق Dify الخاص بك
افتح Chatflow أو Workflow أو Agent أو chatbot في Dify Studio. أضف عقدة LLM، واختر CometAPI كموفر، وحدد أحد معرفات النماذج المُكوّنة. استخدم مُطالبة قصيرة مثل "Reply with the model family in one sentence"، ثم شغّل العقدة. كرر ذلك مع النماذج الثلاثة الأخرى. يتغير فقط معرف النموذج المحدد؛ تبقى بيانات اعتماد الموفر كما هي.
كيفية اختبار الاتصال باستخدام Python
استخدم اختبار التحقق المستقل هذا لفحص المسارات الأربعة نفسها قبل إشراك Dify. ثبّت حزمة OpenAI Python SDK، وخزّن COMETAPI_KEY في بيئتك، وشغّل البرنامج النصي من جهاز موثوق. تؤكد النتيجة الناجحة صحة المفتاح والنقطة النهائية ومعرفات النماذج الحالية؛ إنها لا تُغني عن الاختبار داخل سير عمل Dify الفعلي.
import osfrom openai import OpenAIMODELS = { "OpenAI": "gpt-5.6", "Claude": "claude-opus-5", "Gemini": "gemini-3.7-flash", "DeepSeek": "deepseek-v4-flash",}client = OpenAI( api_key=os.environ["COMETAPI_KEY"], base_url="https://api.cometapi.com/v1", timeout=30.0, max_retries=2,)for family, model in MODELS.items(): try: response = client.chat.completions.create( model=model, messages=[ {"role": "user", "content": "Reply with one short sentence."} ], ) text = response.choices[0].message.content or "" print(f"{family}: OK | {response.model} | {text[:80]}") except Exception as error: print(f"{family}: ERROR | {type(error).__name__} | {error}")
احتفظ بهذا الاختبار خارج سير عمل Dify. وظيفته هي التحقق من المفتاح والنقطة النهائية ومعرف النموذج. بمجرد نجاح نموذج هنا، يُرجَّح أن يكون فشل Dify ناجمًا عن تكوين الإضافة أو إعدادات قدرات النموذج أو سير العمل نفسه.
كيفية التحقق من توفر النموذج قبل النشر
يمكنك التحقق من توفر النماذج من خلال دليل نماذج CometAPI الحالي أو Models API قبل النشر. أكد ظهور معرف النموذج الدقيق في حسابك، ثم نفّذ طلبًا صغيرًا مُصدّقًا قبل إضافته إلى سير عمل إنتاجي في Dify.
باستخدام مفتاحك، تُعيد مكالمة غير متدفقة ناجحة كائن Chat Completions. ستختلف الصياغة المُولّدة، لكن يجب أن يحتوي الرد على الحقول التالية:
{ "id": "chatcmpl-...", "object": "chat.completion", "model": "the-routed-model-id", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }}
في Dify، إشارة النجاح المكافئة هي اكتمال عقدة LLM مع نص في لوحة المخرجات. تحقق من سجلات التشغيل في Dify لمعرفة النموذج المحدد والوقت المنقضي واستخدام الرموز وأي خطأ موحّد من الموفر.
كيفية اختيار النموذج المناسب لـ Dify
ابدأ من عبء العمل بدلاً من اسم الموفر. استخدم نموذجًا متقدمًا للمنطق الصعب أو العمل على قواعد شفرات كبيرة أو الإجابات عالية القيمة؛ واختر نموذجًا أسرع للدردشة التفاعلية وخطوات سير العمل المتكررة؛ واستخدم نموذج نص منخفض التكلفة للتصنيف والاستخراج والمهام المقيدة الأخرى. قارن النماذج بنفس مجموعة المطالبات وسجّل جودة الإجابة، وزمن الاستجابة، واستخدام الرموز، وسلوك الأدوات، والتكلفة لكل تشغيل ناجح. أكد أيضًا أن المسار المختار يدعم كل المدخلات والميزات المطلوبة. يُبسّط اتصال CometAPI المشترك التبديل، لكنه لا يجعل حدود السياق والمدخلات متعددة الوسائط والأدوات والمخرجات المهيكلة أو عناصر التحكّم في الاستدلال متطابقة عبر النماذج.
سيناريوهات شائعة لاستكشاف الأخطاء وإصلاحها وحلولها
يرفض Dify بيانات الاعتماد بخطأ 401. انسخ المفتاح مرة أخرى من لوحات CometAPI وأزل أي مسافات في البداية أو النهاية. لا تُضمّن الكلمة Bearer في حقل API Key في Dify؛ إذ تبني الإضافة ترويسة التفويض.
المزود العام يرجع 404 أو HTML. استخدم عنوان URL الأساسي الكامل https://api.cometapi.com/v1. يمكن أن يؤدي حذف /v1 أو إضافة /chat/completions إلى عنوان URL الأساسي في Dify إلى إنشاء مسار نهائي خاطئ.
لا يظهر النموذج في Dify. حدّث إضافة CometAPI، ثم قارن المعرف مع الدليل المباشر. إذا لم يكن المعرف الحالي محددًا مسبقًا، أضِفه كنموذج مخصص تحت موفر CometAPI نفسه. لا تستبدل اسم نموذج مشابه ظاهريًا.
يعمل طلب نصي لكن الصور أو الأدوات تفشل. يصف التوافق مع OpenAI سطح الطلب، وليس سلوك API متطابقًا. أعد التحقق من الوسائط المدعومة للنموذج وإعدادات الرؤية، واستدعاء الأدوات، والمخرجات المهيكلة، وعناصر التحكم في الاستدلال في الإضافة.
يتجاوز الطلب نافذة السياق. أكد حجم السياق الخاص بالنموذج المخصص في Dify، وقلّص الوثائق المُسترجعة وسجل المحادثة، واحتفظ بهامش للإخراج. لا يُزيل سياق أكبر في الدليل حدود سير عمل Dify أو قواعد الرموز الخاصة بالموفر.
تتلقى 429 أو أخطاء 5xx متقطعة. أعد المحاولة لأخطاء 429 والمهل الزمنية وأخطاء الخادم العابرة مع backoff أسي وتذبذب. لا تُعيد المحاولة تلقائيًا لأخطاء المصادقة أو النموذج غير الصالح أو الطلب المشوّه.
ملاحظات الإنتاج
احتفظ بالأسرار على جهة الخادم. استخدم مفاتيح CometAPI منفصلة للتطوير والإنتاج، واضبط حصصًا معقولة، ودوّر المفاتيح المكشوفة، وتجنب تصدير بيانات اعتماد حقيقية مع تطبيقات Dify.
ثبّت معرف نموذج مُختبَر. لا تستبدل نموذجًا بصمت لأن اسمًا أحدث ظهر في الدليل. يمكن أن تتغير القدرات وزمن الاستجابة وأسلوب الإخراج والسعر عبر الإصدارات حتى عندما يكون الموفر نفسه.
قِس لكل مسار. سجّل معرف النموذج، وزمن الاستجابة، واستخدام الرموز، ورمز الخطأ، وإصدار تطبيق Dify لكل استدعاء إنتاج. هذا يجعل من الممكن مقارنة النماذج والتحقيق في تغييرات التكلفة دون الاعتماد على الانطباعات.
صمّم آليات بديلة حسب القدرات. استخدم نموذجًا منخفض التكلفة لحركة المرور الروتينية ونموذجًا أقوى للتصعيد، لكن قرِن فقط النماذج التي تدعم المدخلات نفسها والأدوات المطلوبة. أعد المحاولة للأعطال العابرة قبل التبديل بين النماذج، وحدّد ميزانية زمن استجابة كلية، واختبر كل مسار بديل. راجع دليل المسارات البديلة للنماذج في CometAPI كنمط إنتاجي.
أعد التحقق من الأسعار قبل الإطلاق. الأسعار في هذا المقال لقطة مُؤرّخة، وليست عقدًا. راجع دليل التسعير والدليل المباشر للنماذج قبل تحديد الميزانية أو نشر ادعاءات تكلفة.
الأسئلة الشائعة
كيف تضيف OpenAI إلى Dify عبر CometAPI؟
ثبّت إضافة موفر النماذج CometAPI، واحفظ مفتاح CometAPI الخاص بك، وأضف gpt-5.6 كنموذج LLM قابل للاختيار. اختر وضع Chat عندما يطلب Dify وضع الإكمال، ثم شغّل مُطالبة نصية قصيرة قبل تمكين النموذج في سير عمل إنتاجي. يسرد الدليل الحالي لـ CometAPI المسار لأحمال عمل الدردشة المتوافقة وResponses، لكن دعم إضافات Dify قد يختلف حسب الإصدار. إذا لم يكن المعرف محددًا مسبقًا، حدّث الإضافة أو استخدم خيار النموذج المخصص. اترك بيانات اعتماد الموفر المشتركة دون تغيير وحقق بشكل منفصل من أي مدخلات صور، واستدعاء أدوات، ومخرجات مهيكلة، وإعدادات الاستدلال قبل الاعتماد عليها.
كيف تضيف Claude إلى Dify عبر CometAPI؟
ضمن اتصال موفر CometAPI نفسه، أضف claude-opus-5 كنموذج LLM منفصل واختره في عقدة Dify التي تحتاج Claude. يوثّق دليل CometAPI الحالي مساري Anthropic Messages ومسار دردشة متوافقًا مع OpenAI لهذا النموذج. لا يزال Dify بحاجة إلى إدخال نموذج خاص به لأن معرف Claude والمدخلات المدعومة وحدود الرموز والسلوك تختلف عن مسار OpenAI. اختبر استجابة بسيطة واحدة ومهمة طويلة أو بمساعدة أدوات واحدة تمثلية، ثم افحص سجل تشغيل Dify للنموذج الفعلي، وزمن الاستجابة، واستخدام الرموز، والأخطاء الموحدة قبل جعله الافتراضي.
كيف تضيف Gemini إلى Dify عبر CometAPI؟
أضف gemini-3.7-flash ضمن موفر CometAPI الموجود، ثم اختر ذلك الإدخال في عقدة LLM المعنية في Dify. يسرد دليل CometAPI الحالي مسارًا أصليًا لـ Gemini لتوليد المحتوى ومسار دردشة متوافقًا مع OpenAI. لسير عمل دردشة أساسي في Dify، ابدأ بالنص فقط وتأكد من نجاح التشغيل قبل اختبار الصور أو ملفات PDF أو مدخلات الصوت أو الفيديو. قد تعتمد هذه الوسائط على إصدار الإضافة وتكوين العقدة حتى عندما يسرد دليل النماذج هذه الوسائط. احتفظ بـ Gemini كتكوين نموذج منفصل حتى تتمكن من ضبط حدود مناسبة ومقارنة سرعته وجودته وتكلفته مع المسارات الأخرى.
كيف تضيف DeepSeek إلى Dify عبر CometAPI؟
أنشئ إدخال نموذج منفصل في Dify لـ deepseek-v4-flash مع إعادة استخدام بيانات اعتماد موفر CometAPI نفسها. يسرد دليل CometAPI الحالي هذا المسار لأحمال عمل الدردشة النصية إلى النص، لذا لا تنسخ إعدادات الصور من تكوينات OpenAI أو Claude أو Gemini. اختبر مُطالبة نصية قصيرة أولاً، يليها مهمة البرمجة أو الاستدلال التي تخطط فعليًا لتشغيلها. إذا كان النموذج مفقودًا من Dify، حدّث الإضافة أو أضف المعرف الحالي الدقيق عبر خيار النموذج المخصص. أعد التحقق من صفحة النموذج المباشرة للتسعير الديناميكي والتوافر قبل توجيه حركة الإنتاج.
هل يمكنني استخدام OpenAI وClaude وGemini وDeepSeek في سير عمل Dify نفسه؟
نعم. يمكن لكل عقدة LLM استخدام مزود/تكوين نموذج مختلف. مع CometAPI، يمكن للنماذج المدعومة مشاركة بيانات اعتماد موفر واحدة بينما يختار سير العمل معرفات نماذج مختلفة.
هل يمكن لمفتاح CometAPI واحد فعليًا تغطية OpenAI وClaude وGemini وDeepSeek في Dify؟
نعم. يخزّن ملحق نموذج Dify الخاص بـ CometAPI بيانات اعتماد موفر واحدة ويستخدمها للنماذج المدعومة عبر تلك العائلات. لا يزال عليك اختيار أو إضافة كل معرف نموذج حتى يعرف Dify أي نموذج يستدعي.
هل أحتاج إلى إدخال عنوان URL الأساسي لـ CometAPI في Dify؟
ليس عند استخدام إضافة CometAPI المخصصة؛ فهي تضبط https://api.cometapi.com/v1 داخليًا. أدخل ذلك العنوان الأساسي يدويًا فقط عند استخدام مزود Dify العام المتوافق مع OpenAI API.
هل يدعم Dify Claude عبر API متوافق مع OpenAI؟
يمكن لـ Dify العمل مع موفري نماذج متوافقين مع OpenAI، لكن التوافق لا يجعل سلوك API الخاص بـ Claude مطابقًا لـ OpenAI. تحقق من المعلمات والقدرات المدعومة للنموذج قبل تمكين الأدوات أو المخرجات المهيكلة أو الرؤية أو ميزات الاستدلال الخاصة.
هل يمكنني استخدام إعدادات Dify نفسها لكل نموذج؟
لا. يمكن مشاركة النقطة النهائية والمفتاح، لكن حدود السياق والوسائط ودعم الأدوات وعناصر التحكم في الاستدلال وزمن الاستجابة والأسعار تظل خاصة بكل نموذج. تعامل مع كل مطابقة نموذج كتكوين مُختبَر.
أي نموذج يجب أن أجعله الافتراضي؟
اختر بعد اختبار المطالبات الخاصة بك. يمكن لنموذج منخفض التكلفة التعامل مع التصنيف الروتيني أو إعادة الصياغة، بينما يمكن لنموذج أقوى التعامل مع الاستدلال المعقد أو الاستجابات الأعلى قيمة. تجنب ادعاء "الأفضل" بشكل عام دون بيانات عبء عمل.
الخلاصة
يتيح CometAPI لمساحة عمل Dify استخدام OpenAI وClaude وGemini وDeepSeek عبر بيانات اعتماد موفر واحدة ونقطة نهاية API موحّدة لأحمال عمل الدردشة المتوافقة. الإعداد قصير: ثبّت إضافة النموذج، احفظ المفتاح، اربط معرفات النماذج الحالية، واختبر كل مسار. يبقى العمل التشغيلي خاصًا بكل نموذج—يجب التحقق من القدرات والسياق والتسعير وسلوك المسارات البديلة بدلاً من افتراضها.