نقاط نهاية واجهة برمجة تطبيقات Open WebUI: ربط نموذج LLM بدون رقابة

القيم التي تحتاجها

يحتاج Open WebUI فقط إلى ثلاثة أشياء من هذه الخدمة. الأول هو عنوان URL الأساسي، https://api.dolphinllm.com/v1. الثاني هو مفتاح API من حسابك. الثالث هو معرف النموذج، uncensored، الذي يقرأه Open WebUI من قائمة النماذج تلقائيًا بمجرد عمل الاتصال.

تتضمن العملية نقطتي نهاية. يملأ GET /v1/models قائمة اختيار النموذج، بينما يحمل POST /v1/chat/completions كل رسالة ترسلها. لا حاجة لشيء آخر للدردشة. بما أن هذه واجهة برمجة نصية، فإن ميزات الصور والصوت والتضمين في Open WebUI ليس لها ما تتصل به هنا.

لا تحتاج إلى بطاقة لتجربته. بعد التسجيل، يمكنك الحصول على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة في صفحة المفتاح. يستمر لمدة 7 أيام.

أضف الاتصال في لوحة الإدارة

إذا كان Open WebUI قيد التشغيل بالفعل، فهذه هي أسرع طريقة.

1. سجّل الدخول كمشرف وافتح إعدادات المشرف، ثم الاتصالات.
2. في قسم OpenAI API، انقر فوق زر الإضافة لإضافة اتصال.
3. الصق https://api.dolphinllm.com/v1 كعنوان URL ومفتاحك كمفتاح.
4. استخدم زر التحقق بجانب الحقول. تعني علامة التأكيد الخضراء أن قائمة النماذج قد عادت.
5. احفظ، افتح دردشة جديدة، واختر uncensored من قائمة اختيار النموذج.

تتغير أسماء القوائم قليلاً بين إصدارات Open WebUI. إذا لم تتمكن من العثور على الاتصالات، ابحث في الإعدادات عن "OpenAI". الحقول هي نفسها دائمًا: URL، المفتاح، وأحيانًا فلتر النموذج.

إعداده باستخدام متغيرات البيئة في Docker

للتركيب الجديد، يمكنك تخطي شاشة الإدارة وتمرير الاتصال عند بدء تشغيل الحاوية. يقرأ Open WebUI OPENAI_API_BASE_URL و OPENAI_API_KEY عند بدء التشغيل.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
  -e OPENAI_API_KEY="YOUR_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

ثم انتقل إلى http://localhost:3000، وأنشئ الحساب الأول (سيصبح المشرف)، ويجب أن يكون النموذج مدرجًا بالفعل. احتفظ بالمفتاح خارج سجل الأوامر إذا كانت الآلة مشتركة: ضعه في ملف env واستخدم --env-file بدلاً من ذلك.

تعامل بعض إصدارات Open WebUI مع هذه المتغيرات كقيم ابتدائية فقط. بمجرد حفظ اتصال في واجهة المستخدم، تكون القيمة المخزنة هي السائدة. إذا قمت بتغيير المتغير ولم يحدث شيء، قم بتحرير الاتصال في إعدادات المشرف بدلاً من ذلك.

تشغيله لعدة أشخاص

يحتوي Open WebUI على حسابات مستخدمين خاصة به، لذا يمكن لتثبيت واحد خدمة منزل أو فريق صغير بينما يوجد مفتاح API واحد فقط على الخادم. هذا مريح ولكنه أيضًا خطر: ينفق كل مستخدم من نفس الرصيد. قرر من يحصل على حساب، وانظر إلى X-Balance-USD من وقت لآخر، حتى لا تفاجئك عطلة نهاية الأسبوع الطويلة من لعب الأدوار.

احتفظ بالمفتاح في متغير بيئة أو ملف أسرار، وليس في لقطة شاشة أو مستند مشترك. يعيش مفتاحك في صفحة مفتاح API؛ إذا اشتبهت في تسربه، استبدله في Open WebUI بمجرد حصولك على مفتاح جديد. بالنسبة للتثبيت الموجه للجمهور، ضعه خلف HTTPS وأوقف التسجيل المفتوح حتى لا يتمكن الغرباء من إنشاء حسابات واستخدام رصيدك.

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

استخدامات جيدة لهذا الإعداد

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

يساعد Open WebUI في بعض الطرق المحددة. تسمح الموجّهات المحفوظة وتهيئات النموذج لك بالاحتفاظ بشخصية أو شخصية محرر على بعد نقرة واحدة. تتيح لك ميزات تحميل المستندات والبحث عبر الإنترنت، عند تمكينها، إرسال نص إضافي إلى الموجّه، مما يزيد من استخدام الرموز، لذا راقب حجم ما ترفقه. تجعل مجلدات الدردشة والبحث من السهل العودة إلى مشروع طويل.

لن يقوم بإنشاء صور أو كلام أو فيديو من هذا الاتصال، لأن الـ API يدعم النصوص فقط.

اختبر نقطة النهاية قبل إلقاء اللوم على Open WebUI

تأتي معظم الإعدادات الفاشلة من خطأ مطبعي في الـ URL أو مفتاح قديم، وكلاهما يظهر بشكل أسرع في الطرفية. قم بتشغيل هاتين المكالمتين من الجهاز الذي يستضيف Open WebUI.

Copycurl https://api.dolphinllm.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

curl https://api.dolphinllm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

يجب أن تسرد المكالمة الأولى uncensored. يجب أن تُرجع المكالمة الثانية إكمال محادثة عاديًا. تحقق أيضًا من رؤوس الاستجابة: يُظهر X-Balance-USD ما تبقى في حسابك، وهي طريقة مفيدة لتأكيد أن Open WebUI ينفق من المفتاح الذي تعتقد أنه يستخدمه.

القائمة الكاملة للمعاملات موجودة في مستندات API.

الإعدادات التي تستحق التغيير للمحادثة

موجه النظام والعينات

يتيح لك Open WebUI تعيين موجه نظام لكل نموذج أو لكل محادثة. نظرًا لأن النموذج مُعد للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، فإن موجه النظام القصير الذي يحدد النبرة أو الشخصية أو تنسيق المخرجات يفيد أكثر من قائمة طويلة من القواعد. يتم تمرير درجة الحرارة و top_p و stop و seed والعقوبات، لذا فإن أشرطة التمرير في Open WebUI لها تأثير.

طول السياق

النافذة تتسع لـ 100,000 رمز للموجّه والإكمال معًا. الدردشات الطويلة تزيد من حجم الموجّه في كل دورة، وتدفع مقابل كامل السجل في كل مرة. إذا أصبحت السلسلة ثقيلة، ابدأ دردشة جديدة أو لخص القديمة.

الطلبات الخلفية

يمكن لـ Open WebUI إرسال مكالمات إضافية في الخلفية لعناوين الدردشة والوسوم، باستخدام نفس النموذج افتراضيًا. على مفتاح تجريبي، يسمح بـ 2 طلب متزامن و60 في الدقيقة، قد تزاحم هذه المكالمات رسالتك الفعلية. أوقف توليد العناوين والوسوم، أو اقبل تأخيرًا قصيرًا. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة، وهو أكثر من كافٍ لتثبيت شخصي أو لفريق صغير.

البث المتدفق، وضع JSON والأدوات

تتدفق ردود Open WebUI افتراضيًا، وتدعم الواجهة أحداثًا مرسلة من الخادم (stream: true)، مع كتلة استخدام في نهاية التدفق. ترى النص يظهر رمزًا تلو الآخر، ويعكس رأس الرصيد في الاستجابة النهائية ما أنفقته.

استدعاء الدوال مدعوم بواسطة الـ API أيضًا: tools، tool_choice، البث المتدفق لـ tool_calls، والنتائج تُرسل كـ role: "tool". يعتمد مدى تعرض Open WebUI لهذا على إصداره وعلى الأدوات أو الوظائف التي تثبتها، لذا اختبر بأداة صغيرة واحدة قبل بناء سير عمل حولها. وضع JSON (response_format مضبوط على json_object) مفيد عندما تستدعي نفس نقطة النهاية من البرامج النصية بجانب واجهة المحادثة.

النمط العملي هو الاحتفاظ بـ Open WebUI للأشخاص واستخدام المفتاح نفسه من نص برمجي للأعمال الدفعية. كلاهما يمر عبر نفس Base URL، لذا يغطي رصيد واحد كل شيء. تذكر فقط أن الحدود تنطبق لكل مفتاح: 8 طلبات متزامنة على مفتاح كامل، مشتركة بين واجهة المستخدم والنصوص البرمجية الخاصة بك.

الأخطاء الشائعة والحلول

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

كم تكلف واجهة المحادثة على هذا الـ API

التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج، من رصيد مسبق الدفع. خذ دورة نموذجية في دردشة متوسطة الطول: 4,000 رمز من السجل يدخل و500 رمز يخرج. تكلفة الإدخال هي 4,000 × $0.15 / 1,000,000 = $0.0006. تكلفة الإخراج هي 500 × $0.50 / 1,000,000 = $0.00025. تكلفة الدورة هي $0.00085.

بمعدل ذلك، يغطي التجريبي بقيمة $0.50 حوالي 588 دورة، ويغطي الشحن بقيمة $20 حوالي 23,500 دورة. انظر صفحة التسعير للحصول على مكافآت الشحن. إذا كنت تريد استخدام المفتاح نفسه خارج Open WebUI، على سبيل المثال في نصوص برمجية لا تحتاج أبدًا إلى شاشة تسجيل دخول، فإن الصفحة على استخدام LLM بدون قيود تسجيل الدخول تغطي ذلك الجانب.

المزيد من الأدلة

• API للLLM مجاني للمطورين: التجربة مقابل الدفع حسب الاستخدام
• كيفية استخدام LLM دون قيود تسجيل الدخول