إعداد واجهة برمجة التطبيقات المتوافقة مع OpenAI في Open WebUI خلال 5 دقائق
لاستخدام إعدادات واجهة برمجة التطبيقات المتوافقة مع OpenAI في open webui، أضف اتصالًا واحدًا بعنوان URL أساسي ومفتاح، وسيظهر النموذج في القائمة. إليك الإعداد الدقيق لـ Abliterated API، من Docker إلى أول محادثة.
محدّث

نقاط رئيسية
- عنوان الأساس هو https://api.abliteratedapi.com/v1 ومعرف النموذج هو
uncensored. - أضفه في إعدادات اتصالات لوحة الإدارة، أو مرر OPENAI_API_BASE_URL و OPENAI_API_KEY إلى Docker.
- اختبر المفتاح باستخدام curl أولاً، لتتمكن من التمييز بين مشكلة في المفتاح ومشكلة في واجهة المستخدم.
- Open WebUI هو فقط الواجهة الأمامية: تدفع مقابل كل رمز يقرأه النموذج ويكتبه، ولا حاجة لبطاقة ائتمان للبدء.
النسخة المختصرة
إذا كنت تريد إعداد واجهة برمجة التطبيقات المتوافقة مع OpenAI لـ open webui في فقرة واحدة: افتح إعدادات لوحة الإدارة، أضف اتصالاً بواجهة برمجة تطبيقات OpenAI، اضبط العنوان على https://api.abliteratedapi.com/v1، الصق مفتاحك، احفظ الإعدادات، واختر النموذج المسمى uncensored. هذا كل شيء. تتحدث Open WebUI مع أي شيء يطبق تنسيق إكمال الدردشة الخاص بـ OpenAI، وهذه الواجهة تفعل ذلك.
الخدمة هي واجهة برمجة تطبيقات نصية مستضافة ومتوافقة مع OpenAI تعمل بنموذج واحد مفتوح الأوزان، ومضبوطة للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. تديرها جهة مستقلة وليست الواجهة الرسمية لأي مختبر نماذج. Open WebUI هي مجرد واجهة الدردشة التي توجهها إليها.
قبل أن تبدأ
- مفتاح API. أنشئ واحداً من صفحة مفتاح API. التسجيل يكون عبر Google أو عبر البريد الإلكتروني وكلمة المرور. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة على تلك الصفحة، ساري لمدة 7 أيام ولا يتطلب بطاقة.
- نسخة عاملة من Open WebUI. يعمل كل من التثبيت عبر Docker أو التثبيت عبر pip. تغطي الخطوات أدناه Docker وشاشة الإعدادات.
- اتصال الشبكة من الجهاز الذي يشغّل Open WebUI إلى
api.abliteratedapi.comعبر HTTPS.
تحقق من المفتاح قبل لمس واجهة المستخدم. إذا أرجعت هذه المكالمة قائمة تحتوي على uncensored، فإن المفتاح والعنوان صحيحان:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
ثم أكد أن إكمالاً حقيقياً يعمل:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'الطريقة 1: أضف الاتصال في الإعدادات
هذه هي أسهل طريقة وتعمل على تثبيت قائم. تتحرك تسميات القوائم بين إصدارات Open WebUI، لذا قد تختلف الأسماء أدناه قليلاً.
- سجّل الدخول إلى Open WebUI بصفتك مشرفاً وافتح لوحة الإدارة، ثم الإعدادات، ثم الاتصالات.
- ابحث عن قسم واجهة برمجة تطبيقات OpenAI وأضف اتصالاً جديداً باستخدام زر الزائد.
- أدخل
https://api.abliteratedapi.com/v1في حقل العنوان. توقف عند/v1. لا تضف/chat/completions؛ تضيف Open WebUI المسار تلقائياً. - الصق مفتاحك في حقل المفتاح. يُرسل كـ
Authorization: Bearer <key>. - استخدم زر التحقق بجانب الحقول إذا كانت نسختك تحتوي عليه، ثم احفظ.
افتح دردشة جديدة وافتح قائمة اختيار النموذج. يجب أن يكون النموذج uncensored موجوداً في القائمة، لأن Open WebUI يقرأه من GET /v1/models. إذا ظلت القائمة فارغة، انتقل إلى قسم استكشاف الأخطاء أدناه.
الطريقة 2: اضبطها عند بدء التشغيل باستخدام Docker
لتثبيت جديد، مرر نقطة النهاية كمتغيرات بيئة. تقرأ Open WebUI OPENAI_API_BASE_URL و OPENAI_API_KEY عند بدء التشغيل.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
ثم قم بزيارة http://localhost:3000، وأنشئ الحساب الأول (الذي يصبح المسؤول) وابدأ محادثة. يحفظ الحجم المسمى محادثاتك وإعداداتك عند تحديث الحاوية.
شيء واحد يفاجئ الناس: العديد من إعدادات Open WebUI يتم حفظها في قاعدة البيانات الخاصة بها بعد التشغيل الأول، وقد تطغى القيمة المحفوظة على متغير البيئة اللاحق. إذا قمت بتغيير المفتاح أو العنوان في Docker ولم يحدث شيء، فقم بتغييره في شاشة الاتصالات بدلاً من ذلك، أو أعد تعيين الإعداد المخزن.
إعدادات تستحق التعديل
عندما يعمل الدردشة، تتيح لك بعض الخيارات تحسين التجربة وجعل الفاتورة قابلة للتنبؤ.
استخدم نافذة السياق بحكمة
تبلغ نافذة السياق 100,000 رمز (token)، وهي مشتركة بين الموجّه والرد. يعيد Open WebUI إرسال سجل الدردشة في كل رسالة، لذا تصبح المحادثات الطويلة أكثر تكلفة مع كل دور. تبلغ التكلفة $0.15 لكل مليون رمز مدخل، وتكلفة إرسال سجل بطول 20,000 رمز هو $0.003، وهو مبلغ زهيد، لكنه يتراكم عبر آلاف الرسائل. ابدأ دردشة جديدة لموضوع جديد.
البث المتدفق والعينات
تقوم Open WebUI ببث الردود افتراضياً، وتدعم الـ API البث المتدفق عبر SSE. في المعلمات المتقدمة يمكنك ضبط درجة الحرارة وtop_p ومتوقفات التسلسل وبذرة لإخراج قابل للتكرار والعقوبات. تُمرر هذه القيم إلى النموذج. اترك max_tokens فارغاً ما لم ترد فرض حد أقصى، فهو اختياري.
المهام الخلفية
يمكن لـ Open WebUI إجراء استدعاءات نماذج إضافية في الخلفية لأشياء مثل تسمية محادثة. كل منها طلب حقيقي على رصيدك ويحسب ضمن الحدود. إذا لاحظت استدعاءات لم تكتبها، فراجع إعدادات نموذج المهام وأشر إليها إلى نموذج ترضى دفع ثمنه، أو قم بإيقاف ميزات المساعدة.
الإعدادات المسبقة والموجهات النظامية
يتيح لك Open WebUI حفظ إعداد مسبق للنموذج في قسم مساحة العمل: اسم، نموذج أساسي، موجّه نظامي ومعاملات افتراضية. أنشئ واحدًا فوق uncensored لكل مهمة تقوم بها بشكل متكرر، مثل مساعد التحرير أو مراجع الكود أو شخصية لجلسة خيال تفاعلي. الموجّه النظامي القصير الذي يحدد الدور والنبرة وتنسيق الردود يفيد أكثر من التعليمات الطويلة التي تُلصق في كل دردشة.
هنا يأتي دور ملف النموذج. إنه نموذج مفتوح الأوزان مُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يناسب الخيال الأدبي، لعب الأدوار وتطبيقات الرفقة للبالغين، حيث يكسر الرفض في منتصف المشهد التدفق. لا يغير الحد الصارم: لا محتوى جنسي يتضمن القاصرين، أبدًا. حافظ على الإعدادات المسبقة والنسخ المشتركة ضمن هذه القاعدة والقانون الساري في منطقتك.
إذا استخدم أشخاص آخرون مثيل Open WebUI الخاص بك، فتذكر أنهم يشاركون جميعاً مفتاحك وحدوده. يسمح المفتاح الكامل بـ 8 طلبات متزامنة، لذا فإن عددًا صغيرًا من المستخدمين النشطين أمر مقبول، بينما قد يؤدي عدد كبير من المستخدمين الذين يتحدثون في آن واحد إلى الوصول إلى الحد الأقصى. منح كل شخص أو فريق مفتاحه الخاص يوزع الحمل ويسهل تتبع الرصيد.
تكلفة التشغيل
تدفع مقابل الرموز فقط، من رصيد مسبق الدفع: $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج. الطلبات الفاشلة أو المرفوضة لا تُحسب ولا ينتهي الرصيد المسبق الدفع. تبلغ تكلفة رسالة دردشة نموذجية مع 3,000 رمز من السجل و 400 رمز رد $0.00045 + $0.0002 = $0.00065، لذا فإن $10 من الاستخدام تعادل حوالي 15,000 رسالة.
تعمل عمليات الشحن من $20 إلى $500 بأي مبلغ صحيح، مع +5% من $50، +10% من $100 و +15% من $200. يمكنك الدفع بالعملات المشفرة (USDT على TRC20، USDC على Base). راجع صفحة الأسعار للتفاصيل. يتم إرجاع الرصيد المتبقي في رأس X-Balance-USD من كل استجابة API، إذا أردت مراقبته من نص برمجي.
استكشاف الأخطاء وإصلاحها
| العرض | السبب المحتمل | الحل |
|---|---|---|
| قائمة النماذج فارغة | URL أو مفتاح خاطئ | قم بتشغيل اختبار curl لـ /v1/models. يجب أن ينتهي URL بـ /v1. |
| رفض الاتصال أو انتهاء المهلة من Docker | لا يوجد HTTPS خارجي من الحاوية | تحقق من إعدادات DNS والوكيل وجدار الحماية على المضيف. |
| خطأ مصادقة في كل رسالة | تم لصق المفتاح مع مسافات، أو مفتاح قديم | أعد نسخ المفتاح من صفحة المفاتيح واحفظه مرة أخرى. |
| أخطاء عندما يتحدث عدة أشخاص في آن واحد | حدّ المعدل | يتيح المفتاح الكامل 8 طلبات متزامنة و300 في الدقيقة؛ ويتيح المفتاح التجريبي 2 و60. |
| توقف الدردشة الطويلة عن العمل | نافذة السياق ممتلئة | النافذة تتسع لـ 100,000 رمز. ابدأ محادثة جديدة أو قم بالتلخيص. |
إذا نجح اختبار curl لكن Open WebUI يفشل، فإن المشكلة في إعدادات الواجهة الأمامية. إذا فشل curl، فافحص مفتاحك ورصيدك أولاً. يدرج دليل البدء السريع كل معلمة طلب، وتشرح المقالة عن ما هي واجهة uncensored chat API وما لا تكون نطاق النموذج، بما في ذلك الحد الصارم: لا محتوى جنسي يتضمن قاصرين.
المزيد من الأدلة
أسئلة وأجوبة
ما هو عنوان URL الذي أدخله في Open WebUI؟
استخدم https://api.abliteratedapi.com/v1 ولا تضيف شيئاً بعدها. تضيف Open WebUI /chat/completions و /models تلقائياً.
أي اسم نموذج أختار؟
معرف النموذج هو uncensored. يظهر في قائمة اختيار النموذج بمجرد حفظ الاتصال وتحميل قائمة النماذج.
هل أحتاج إلى بطاقة لتجربته؟
لا. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي بنقرة واحدة في صفحة مفتاح API بعد تسجيل الدخول. الرصيد صالح لمدة 7 أيام ولا يتطلب بطاقة.
هل يمكنني تشغيله إلى جانب النماذج المحلية؟
نعم. تدعم Open WebUI عدة اتصالات في وقت واحد، لذا يمكن لنقطة النهاية هذه أن تعمل جنباً إلى جنب مع النماذج المحلية ويظهر كل منها في قائمة اختيار النموذج نفسها.
هل تُستخدم محادثاتي للتدريب؟
لا. لا تُستخدم الموجّهات المرسلة إلى واجهة API للتدريب. يبقى سجل الدردشة المحفوظ المخزنة بواسطة Open WebUI في تثبيتك الخاص.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.
احصل على مفتاح API