امنح تدفقات Activepieces مزوّد AI متوافقاً مع OpenAI.

إجابة سريعة: مُدخَل مزوّد واحد في إعداد AI الخاص بالمسؤول.

في لوحة تحكم Activepieces الخاصة بالمسؤول، افتح صفحة إعداد AI وأضف مزوّداً من نوع OpenAI Compatible. يأخذ النموذج Display Name، وAPI Key، وBase URL، وAPI Key Header، ورؤوساً افتراضية اختيارية، وقائمة نماذج حيث كل مُدخَل له Model ID، وModel Name، وModel Type. القيم الخاصة بـ APIsRouter: Base URL هو https://api.apisrouter.com/v1 (نفس الشكل الذي يستخدمه الكود الأساسي لمزوّديه المتوافقين المدمجين)، وAPI Key Header هو Authorization، وحقل المفتاح يأخذ مفتاح البوابة الخاص بك. تفصيل تنفيذي يستحق المعرفة: يرسل Activepieces المفتاح في ذلك الرأس بالضبط كما كتبته، دون إضافة بادئة Bearer تلقائياً، لذا أدخله كـ "Bearer sk-..." للشكل القياسي؛ يقبل APIsRouter أيضاً المفتاح عارياً في رأس Authorization، لذا كلتا الصياغتين تعملان هنا. ثم أضف كل نموذج تريد أن تراه التدفقات، بحيث يطابق Model ID الكتالوج تماماً.

Admin Console -> AI setup -> Add AI Provider
  -> OpenAI Compatible

Display Name:   APIsRouter
Base URL:       https://api.apisrouter.com/v1
API Key Header: Authorization
API Key:        Bearer sk-YOUR-APISROUTER-KEY

Models (Add Model):
  Model ID: claude-haiku-4-5-20251001  Type: TEXT
  Model ID: deepseek-v4-flash          Type: TEXT
  Model ID: claude-sonnet-4-6          Type: TEXT

كيف يستخدم Activepieces مزوّداً مخصصاً.

Activepieces (بنحو 23 ألف نجمة على GitHub) هو منصة الأتمتة مفتوحة المصدر الرائدة بدون كود: تدفقات مبنية من مُحفِّزات وقِطَع، بنفس شكل Zapier لكن قابلة للاستضافة الذاتية، مع إطار قِطَع مرخّص بموجب MIT وكتالوج مجتمعي كبير. قدرات AI فيه (خطوات توليد نص، وكلاء، قِطَع أدوات AI مساعِدة) تحل نموذجها عبر مزوّدي AI المُعَدّين في المنصة، وهذا ما يجعل مُدخَل المزوّد قراراً توجيهياً لكل تدفق في آن واحد. تحت الغطاء، يبني مزوّد OpenAI Compatible عميلاً قياسياً مقابل Base URL الخاص بك ويُرفِق مفتاحك تحت اسم الرأس الذي اخترته، بالإضافة إلى رؤوس بيانات وصفية لكل تشغيل تُعرِّف المشروع والتدفق. يُمرَّر Model ID الذي سجّلته كسلسلة النموذج في طلبات chat-completions. لا يوجد اكتشاف تلقائي للنماذج لهذا النوع من المزوّدين: يمكن للتدفقات اختيار بالضبط النماذج التي أضفتها إلى القائمة، مما يُبقي المنتقي مقصوداً بدلاً من مُغرَق. إعداد المزوّد على مستوى المنصة. يُعرِّفه المسؤول مرة واحدة، وكل مشروع وتدفق على النسخة يختار من النماذج المُسجَّلة. هذا المركزة هو مكسب الحوكمة: مكان واحد لتقرير النماذج الموجودة، مفتاح واحد لقياس كل خطوات AI، وبيانات وصفية لكل تدفق في كل طلب تجعل الاستخدام قابلاً للإسناد عند قراءة السجلات.

الإعداد الكامل وتحذير وقت الحفظ.

يُحفَظ النموذج دون التحقق من الاتصال؛ تنفيذ المزوّد يتخطى صراحة فحوصات الاتصال لنوع OpenAI Compatible. هذا مريح (لا فحص لنقطة النهاية عند الحفظ) لكنه يعني أن Base URL خاطئاً أو مفتاحاً مشوَّهاً يفشل لاحقاً، عند أول تشغيل تدفق يلامس خطوة AI. تحقق من نقطة النهاية يدوياً مرة واحدة قبل ربطها بتدفقات الإنتاج، وعامل أول تشغيل كجزء من الإعداد. Model Type يهم بالنسبة لما يمكن للقِطَع استخدامه: خطوات النص تريد نماذج TEXT. سجّل المعرّف بالضبط كما يهجّئه الكتالوج؛ Model Name هو تسمية عرض ويمكن أن يكون أي شيء مقروء. إذا أردت نفس النموذج الأساسي بمستويين مختلفين من السعر والأداء لفرق مختلفة، سجّله مرة لكل Model ID؛ أسماء العرض تُبقيها مميّزة في المنتقي.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

اختيار النماذج لخطوات الأتمتة.

لأن المزوّد على مستوى المنصة، حوكمة النموذج هي شاشة واحدة: أضف المعرّفات التي تُقرّها، راقب أسبوعاً من الاستخدام لكل مفتاح، واحذف ما لا ينبغي لأحد استخدامه. يحتفظ منشئو التدفقات بحريتهم داخل القائمة التي نسّقتها.

• AI الأتمتة عمل حجمي بمُدخَلات قصيرة: تصنيف تذكرة، استخراج حقول، صياغة رسالة، تلخيص حمولة webhook. claude-haiku-4-5-20251001 وgpt-5.4-mini وdeepseek-v4-flash تغطي معظم الخطوات بأسعار الحجم.
• احتفظ بمعرّف أقوى لخطوات الحُكم. تدفق يصوغ ردوداً تواجه العملاء أو يتخذ قرارات توجيه يستحق claude-sonnet-4-6، مُختاراً لكل خطوة في منشئ التدفق.
• يسعّر MiniMax-M2.7 وعائلة DeepSeek بشكل ممتاز لتدفقات التحويل الجماعي (تغذيات، تنظيف بيانات مسحوبة، إثراء) حيث آلاف التشغيلات يومياً هي أمر عادي.
• التدفقات تعمل دون إشراف، لذا التكلفة هي جدول مضروب في عدد tokens لكل تشغيل. سجل الاستخدام يعطيك رقم كل تشغيل؛ الجدول لك.
• سجّل نماذج قليلة عن قصد. المنتقي يُظهر بالضبط ما أضفته، وقائمة مُنسَّقة تمنع مئة منشئ تدفقات من الاختيار كل بطريقته.

ادفع حسب الاستخدام · أقل من السعر الرسمي

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

أنماط الفشل الخاصة بـ Activepieces.

حفظ صامت، وتشغيل أول صاخب. لأن مزوّد OpenAI Compatible يتخطى التحقق من الاتصال، كل خطأ في الربط (Base URL خاطئ، /v1 مفقود، مفتاح سيّئ، اسم رأس خاطئ) يظهر كخطوة AI فاشلة في تشغيل تدفق بدلاً من خطأ في النموذج. عندما تفشل خطوة AI مباشرة بعد تغييرات المزوّد، اشتبه في مُدخَل المزوّد قبل التدفق. مسألة بادئة Bearer. يُرسَل المفتاح حرفياً تحت الرأس الذي اخترته. نقاط النهاية التي تتطلب بادئة Bearer الحرفية تحتاجها مكتوبة في حقل المفتاح؛ يقبل APIsRouter كلا الشكلين، لكن إذا أعدت توجيه هذا المزوّد إلى مكان آخر يوماً ما، تذكّر أن المنصة لن تضيف البادئة نيابة عنك. معرّفات النموذج دقيقة. معرّف مُسجَّل بخطأ إملائي يمرّ عبر النموذج (التسميات نص حر) ويفشل وقت التشغيل بخطأ model-not-found؛ مخرجات /v1/models الخاصة بالبوابة هي الهجاء المرجعي. غياب الاكتشاف التلقائي ميزة، لا عيب. إذا كان نموذج مفقوداً من منتقي تدفق ما، فهو لم يُسجَّل على المزوّد؛ أضفه في لوحة تحكم المسؤول بدلاً من البحث عنه في منشئ التدفق. وأبقِ اتصالات مستوى القِطَع منفصلة في ذهنك: قِطَع فردية مثل قطعة OpenAI يمكن أن تحمل بيانات اعتماد خاصة بها لكل اتصال، بينما مُدخَل المزوّد الموصوف هنا يُشغِّل قدرات AI الشاملة للمنصة. إذا استخدم تدفق ما قطعة خاصة ببائع معين باتصالها الخاص، تلك الحركة لا تمرّ عبر مُدخَل بوابتك.

من يوجّه Activepieces عبر بوابة.

• فرق الاستضافة الذاتية التي توحّد AI عبر عشرات التدفقات، حيث يستبدل مُدخَل مزوّد واحد ومفتاح واحد بيانات اعتماد مبعثرة لكل قطعة.
• مسؤولو المنصات الذين يريدون حوكمة نموذج: قائمة نماذج مُنسَّقة، استخدام لكل مفتاح، وإمكانية تبديل نقطة النهاية الخلفية دون لمس التدفقات.
• الوكالات التي تشغّل أتمتة العملاء على نسخة واحدة، تقيس استخدام AI لكل عميل بمفاتيح منفصلة على نفس الكتالوج.
• المُنشِئون الذين تمزج تدفقاتهم خطوات حجمية وخطوات حُكم، يقرنون معرّفات سريعة بمعرّفات حديثة لكل خطوة عبر نقطة نهاية واحدة.
• المطورون الذين لا يملكون وصولاً إلى فوترة بائع معيّن. الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على التسجيل لكل مزوّد.

تحقق من نقطة النهاية وصحّح أخطاء خطوة AI الأولى.

شغّل أمري curl أعلاه قبل حفظ المزوّد؛ يثبتان المفتاح وBase URL ومعرّف النموذج معاً، وهو بالضبط ما لن يتحقق منه النموذج نيابة عنك. عندما تفشل خطوة AI في تدفق بعد الإعداد، اقرأ خطأ الخطوة. فشل المصادقة يعني أن حقل المفتاح أو اسم الرأس خاطئ (أو أن بادئة Bearer مفقودة على نقطة نهاية تتطلبها). خطأ model-not-found هو معرّف مُسجَّل لا يطابق الكتالوج. خطأ اتصال عادة يعني أن Base URL فقد /v1 الخاص به. إذا لم تجد الخطوة أي نموذج لاختياره، فقد حُفظ المزوّد لكن قائمة النماذج فارغة لذلك النوع من النماذج. بمجرد تشغيل التدفقات، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. الأتمتة المجدولة تتراكم بهدوء، وعرض الاستخدام لكل مفتاح هو كيف يرى مسؤول المنصة أي التدفقات تستحق tokensها قبل أن تصله الفاتورة.

الأسئلة الشائعة