تخطَّ إلى المحتوى
موارد المطورين
موارد المطورين

Open WebUI

ثبّت Open WebUI، أضف RunAPI كاتصال متوافق مع OpenAI، حدد نموذجاً، وتحقق من الدردشة.

عرض Markdown

اربط Open WebUI بـ RunAPI عبر الاتصال المتوافق مع OpenAI. تحتاج إلى صلاحية مسؤول Open WebUI ومفتاح API قياسي لـ RunAPI من دليل المصادقة.

تثبيت Open WebUI

اتبع الدليل السريع الرسمي لـ Open WebUI الخاص بمنصتك. لتثبيت Docker محلي، يمكن تشغيل الصورة الرسمية بالأمر:

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

افتح التطبيق وأنشئ حساب المسؤول وسجّل الدخول قبل إضافة الاتصال.

إضافة اتصال RunAPI

  1. افتح إعدادات المسؤول ← الاتصالات ← OpenAI، ثم حدد إضافة اتصال.
  2. اضبط URL على https://runapi.ai/v1 وأدخل مفتاح API الخاص بك في RunAPI.
  3. اترك معرّفات النماذج (التصفية) فارغةً في محاولة الاتصال الأولى لتتمكن Open WebUI من اكتشاف النماذج المتاحة.
  4. احفظ الاتصال وانتظر حتى تكتمل عملية التحقق.

يُرسل Open WebUI فحص الاتصال من الواجهة الخلفية ويستخدم GET /v1/models للاكتشاف. عنوان URL الخاص بـ RunAPI هو HTTPS عام، لذا لا تحتاج عملية تثبيت Docker إلى host.docker.internal لهذا الاتصال.

اختر نموذجاً

افتح محادثة جديدة وحدد نموذج RunAPI من محدِّد نموذج المحادثة. استخدم كتالوج النماذج للتحقق من معرّف النموذج الحالي وإمكانياته.

إذا لم يملأ الاكتشاف المحدد، قم بتحرير الاتصال وأضف المعرّف الدقيق ضمن Model IDs (Filter). خطأ اكتشاف النموذج وخطأ Chat Completions إشارتان منفصلتان؛ اختبر النموذج المضاف يدوياً قبل إزالة الاتصال.

التحقق من الاتصال

أرسل موجهاً قصيراً مثل Reply with the word connected. تؤكد الاستجابة العادية المتدفقة أو الكاملة أن Open WebUI يمكنه استخدام نموذج RunAPI المحدد.

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

  • يُعيد التحقق 401 أو 403: استبدل مفتاح API في الاتصال بمفتاح قياسي صالح من دليل المصادقة.
  • لا يظهر أي نموذج RunAPI: تأكد من أن URL ينتهي بـ /v1، ثم أضف معرّفاً حالياً واحداً إلى Model IDs (Filter) وأعد المحادثة.
  • النموذج مرئي لكن المحادثة تفشل: تأكد من أن المعرّف يدعم Chat Completions المتوافق مع OpenAI في كتالوج النماذج، ثم افحص سجلات الواجهة الخلفية لـ Open WebUI للاطلاع على حالة الطلب.
  • يعمل عنوان URL المحلي في المتصفح لكن لا يعمل في Open WebUI: تنشأ اتصالات Open WebUI من واجهتها الخلفية. لا يؤثر هذا على عنوان URL العام https://runapi.ai/v1، لكنه مهم للاتصالات المحلية الأخرى.

للاطلاع على سلوك البروتوكول المشترك، استخدم البدء السريع لـ LLM API . للاطلاع على حقول الطلب والاستجابة، استخدم مرجع Chat Completions API .