صِل Open WebUI بنقطة نهاية مخصصة متوافقة مع OpenAI.

إجابة سريعة: اتصال واحد في Admin Settings.

كمسؤول، افتح Admin Settings، اذهب إلى Connections، وتحت قسم OpenAI API انقر لإضافة اتصال. حقلان يهمان: الـ URL، مضبوط على https://api.apisrouter.com/v1، ومفتاح API. احفظ، ويستعلم Open WebUI عن قائمة /v1/models الخاصة بنقطة النهاية لملء منتقي النموذج؛ تحقق بعنصر التحقق الخاص بالاتصال، ثم اختر أي معرّف كتالوج في محادثة جديدة. الاتصالات المُضافة بهذه الطريقة تكون على مستوى مساحة العمل بأكملها: كل مستخدم لنسختك من Open WebUI يرى النماذج، وفق ضوابط الوصول إلى النموذج التي تُعِدّها. يمكن لنفس القيم أن تُشحَن كمتغيرات بيئة عند وقت النشر بدلاً من ذلك، OPENAI_API_BASE_URL وOPENAI_API_KEY، وهو المسار الأنظف عندما يُهيَّأ النسخة عبر ملفات compose بدلاً من النقر عليها.

URL:      https://api.apisrouter.com/v1
API Key:  sk-YOUR-APISROUTER-KEY

Save → models auto-populate from /v1/models
(optional) Model IDs allowlist to curate the selector

كيف يستخدم Open WebUI اتصالات OpenAI.

Open WebUI (بنحو 145 ألف نجمة على GitHub) هو الواجهة الأمامية الافتراضية ذاتية الاستضافة لمحادثة AI: عميل ويب كامل الميزات بمستخدمين وأذونات، ومجموعات RAG ومعرفة، واستدعاء أدوات، وإدارة نماذج، مقترن تقليدياً بـ Ollama للنماذج المحلية لكنه مرتاح بنفس القدر في التحدث إلى APIs بعيدة. نموذج الاتصال فيه تراكمي. قسم Ollama يغطي بيئات التشغيل المحلية؛ قسم OpenAI API يغطي أي نقطة نهاية تتحدث لهجة chat-completions القياسية، ويمكنك إضافة عدة اتصالات جنباً إلى جنب. كل اتصال يساهم بقائمة نماذجه في المنتقي المشترك، لكل واحد مفتاحه الخاص، ويمكن إطفاء كل واحد دون حذف إعداده. الطلبات تحمل معرّف النموذج كسلسلة نصية عادية إلى أي اتصال يخدمه. هذا التصميم يعني أن اتصال بوابة لا يُزيح أي شيء: نماذجك المحلية تستمر في العمل عبر Ollama بدون تكلفة لكل token، بينما تصبح claude-sonnet-4-6 وgpt-5.5 وgemini-3.5-flash وdeepseek-v4-pro مدخلات منتقي للمحادثات التي تحتاج جودة حديثة. مفتاح واحد يغطيها جميعاً، ويبقى الاستخدام من جانب المسؤول قابلاً للقراءة لأن حركة السحابة تخرج عبر مكان واحد بالضبط.

الإعداد عند وقت النشر: متغيرات البيئة.

بالنسبة لنشرات docker-compose وKubernetes، يمكن أن يكون الاتصال جزءاً من البيان (manifest). OPENAI_API_BASE_URL يأخذ نقطة النهاية وOPENAI_API_KEY المفتاح؛ تبدأ النسخة والاتصال موجود بالفعل. الأشكال متعددة الأشكال (OPENAI_API_BASE_URLS وOPENAI_API_KEYS بقيم مفصولة بفواصل منقوطة) مدعومة إذا شغّلت أكثر من مصدر بعيد واحد. ملاحظتان تشغيليتان. أولاً، القيم المضبوطة عبر الواجهة تستمر في قاعدة بيانات Open WebUI ولها الأسبقية على افتراضات البيئة بعد أول إقلاع، وهو سلوك موثّق يفاجئ بانتظام المشغّلين الذين يغيّرون البيئة ولا يرون شيئاً يحدث؛ عدّل الاتصالات الموجودة في Admin Settings، أو اضبط ENABLE_PERSISTENT_CONFIG=false إذا أردت أن تبقى البيئة هي المرجع. ثانياً، إذا كانت قائمة نماذج نقطة النهاية كبيرة، استخدم قائمة سماح Model IDs الخاصة بالاتصال لتنسيق ما يراه مستخدموك؛ منتقي بأربعة عناصر يُستخدَم، بينما منتقي بمئتي عنصر يُمرَّر فقط. ملاحظة إصدار: صياغة القوائم انحرفت عبر وتيرة إصدارات المشروع السريعة (Settings مقابل Admin Settings، أسماء الأقسام داخل Connections)، لذا في الإصدارات الأقدم ابحث عن زوج base URL ومفتاح OpenAI API أينما تعيش الاتصالات.

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    environment:
      - OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
      - OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
    ports:
      - "3000:8080"

اختيار النماذج لمساحة عمل متعددة المستخدمين.

مع فوترة كل نموذج سحابي عبر مفتاح واحد، اختبار A/B هو مجرد اختيار منتقي. شغّل نفس حِمل عمل الفريق بفارق أسبوعين على افتراضين مرشّحين ودع عرض الاستخدام لكل نموذج في لوحة APIsRouter يحكم، لكل نموذج ولكل يوم، بدلاً من التخمين من المعايير القياسية.

• اختيار النموذج الافتراضي يقوم بمعظم العمل في نسخة مشتركة. claude-haiku-4-5-20251001 أو gemini-3.5-flash كافتراض لمساحة العمل يُبقي تكلفة الاستخدام العرضي لكل محادثة ثابتة.
• مكان claude-sonnet-4-6 وgpt-5.5 في المنتقي للمسوَّدات والتحليل وأسئلة الكود؛ يترقّى المستخدمون عندما تستحق المهمة ذلك.
• خطوط أنابيب RAG تُضاعِف tokens المدخل: كل إجابة تحمل مقاطع مسترجَعة. deepseek-v4-pro يستحق الاختبار كحصان عمل RAG، حيث التعامل مع السياق الطويل لكل token يُنفَق هو السمة الحاسمة.
• أبقِ المواد الخاصة حقاً على النماذج المحلية عبر Ollama ووجّه كل شيء آخر عبر البوابة؛ المنتقي يحمل كلا المسارين بأمانة.
• استخدم قائمة سماح Model IDs كسياسة: ما ليس في المنتقي لا يمكن أن يفاجئك في سجل الاستخدام.

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

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

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

عدم ظهور أي نماذج بعد إضافة الاتصال هو التقرير الأكثر شيوعاً. الأسباب مرتّبة: المفتاح فشل مقابل /v1/models (تحقق بعنصر التحقق الخاص بالاتصال)، أو الـ URL يفتقد لاحقة /v1، أو مفتاح الاتصال مطفأ. يبني Open WebUI المنتقي مما تُعيده القائمة، لذا منتقي فارغ يعني أن استدعاء القائمة فشل أو أعاد لا شيء. تغييرات البيئة التي تبدو مُتجاهَلة هي قاعدة الإعداد المستمر الموصوفة أعلاه: بعد أول إقلاع، تفوز قاعدة البيانات على البيئة للإعدادات التي تديرها الواجهة. عدّل الاتصال في Admin Settings أو عطّل الإعداد المستمر صراحة. نموذج يُسرَد لكن يُخفِق في المحادثة عادة ما يكون معرّفاً تكشفه القائمة لكن مفتاحك لا يستطيع استخدامه، أو خطأ إملائي أُدخل بتعديل قائمة سماح Model IDs يدوياً؛ قارن مقابل مخرجات /v1/models الخام. وأبقِ المسارات واضحة عند التصحيح: مشاكل اتصال Ollama ومشاكل اتصال OpenAI تبدو متطابقة من نافذة المحادثة. صفحة Connections تُظهر إلى أي مسار ينتمي نموذج؛ اختبر المسار الفاشل مباشرة قبل افتراض أن النسخة بأكملها معطَّلة.

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

• الفرق التي تستضيف ذاتياً واجهة محادثة واحدة للجميع وتريد نماذج حديثة متاحة دون إصدار مفاتيح بائعين للمستخدمين الأفراد.
• مستخدمو Ollama الذين يحتفظون بنماذج محلية للعمل الخاص لكنهم يريدون جودة Claude وGPT في نفس المنتقي للمحادثات التي تحتاجها.
• المسؤولون الذين يحتاجون فاتورة سحابة مقروءة: اتصال واحد، مفتاح واحد، وسجل استخدام لكل نموذج بدلاً من إيصالات من أربعة بائعين.
• المشغّلون في مناطق تكون فيها بعض تسجيلات البائعين مؤلمة؛ الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على كل مزوّد.
• هواة المختبرات المنزلية الذين يشغّلون Open WebUI للعائلة، حيث رصيد مدفوع مسبقاً واحد أسهل في التفكير به من أي اشتراك.

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

أثبت صحة نقطة النهاية من الخادم أولاً، خاصة في النشرات المُحوسَبة (containerized) حيث شبكة الحاوية ليست شبكة حاسوبك المحمول. قائمة نماذج وإكمال محادثة واحد من داخل المضيف يؤكدان صحة نصف البوابة قبل أن يدخل Open WebUI الصورة. ثم أضف الاتصال وراقب امتلاء المنتقي. أخطاء المصادقة هي حقل المفتاح؛ منتقي فارغ هو استدعاء القائمة؛ مسار مكرر (/v1/v1/...) في سجلات الخادم يعني أن حقل الـ URL كان يحمل بالفعل /v1 وأضاف شيء آخر واحداً آخر، لذا اقرأ الـ URL بالضبط كما حُفظ. بمجرد تدفّق المحادثات، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. بالنسبة لنسخة متعددة المستخدمين، هذا هو الرقم الذي يهم: أي النماذج يختارها مستخدموك فعلياً، وما التكلفة الحقيقية لأسبوع من مساحة العمل، لكل نموذج، لكل يوم، على صفحة واحدة.

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"}]}'

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