هل يمتلك OpenWebUI واجهة برمجة تطبيقات؟ نعم، باتجاهين

واجهتا برمجة تطبيقات مختلفتان يُقصد بهما

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

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

إذن، الإجابة المختصرة هي نعم لكلا الاتجاهين. يوثق المشروع واجهة برمجة تطبيقات تحتوي على نقطة نهاية للمحادثات على غرار OpenAI، ويدعم الاتصال بأي خادم يتكلم بروتوكول OpenAI. يمكن أن تتغير التفاصيل مثل المسارات الدقيقة ومعالجة المفاتيح بين الإصدارات، لذا تحقق من التوثيق للإصدار الذي تشغله.

يوفر هذا الموقع النموذج في الجانب الصادر: واجهة برمجة تطبيقات للنصوص متوافقة مع OpenAI تحتوي على معرف نموذج واحد uncensored. إنها ليست Open WebUI ولا تقوم بتشغيلها لك. Open WebUI هو برنامج تستضيفه بنفسك.

استخدام واجهة برمجة التطبيقات الخاصة بـ Open WebUI

تتيح Open WebUI للمستخدم المسجل إنشاء مفتاح API في إعدادات حسابه. باستخدام هذا المفتاح، يمكنك استدعاء نقاط النهاية الخاصة بها من السكربتات. تتبع نقطة نهاية المحادثات شكل OpenAI، لذا يمكن غالباً توجيه كود العميل الحالي إليها. المسار الذي وثقه المشروع وقت الكتابة هو /api/chat/completions؛ تحقق من ذلك مقابل إصدارك.

Copy# Open WebUI running locally on port 3000, key created in Settings > Account
curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer $OPENWEBUI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Summarize this scene in one line."}]}'

لاحظ أن اسم النموذج هنا هو أي نموذج سجلته Open WebUI. إذا قمت بتوصيل هذه الواجهة كواجهة خلفية، فإن هذا الاسم هو uncensored. المفتاح في هذا الطلب هو مفتاح Open WebUI، وليس مفتاح واجهة برمجة تطبيقات النموذج. إنها بيانات اعتماد منفصلة لها وظيفتان منفصلتان.

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

استخدام واجهة برمجة تطبيقات خارجية كواجهة خلفية

الاتجاه الآخر هو ما يحتاجه معظم الناس. تحتوي Open WebUI على قسم لاتصالات متوافقة مع OpenAI حيث تدخل عنوان URL ومفتاحاً. بالنسبة لهذه الخدمة، تكون القيم:

• عنوان URL: https://api.nsfwvideo.top/v1
• المفتاح: هو الموجود في صفحة المفاتيح
• النموذج: uncensored، يتم اكتشافه تلقائياً عبر GET /v1/models

خطوة بخطوة: افتح إعدادات المسؤول، انتقل إلى الاتصالات، أضف اتصال واجهة برمجة تطبيقات OpenAI، الصق عنوان URL والمفتاح، احفظ، واختر النموذج في محادثة جديدة. إذا كنت تفضل بدء تشغيل سطر الأوامر، فقم بتعيين متغيرات البيئة OPENAI_API_BASE_URL و OPENAI_API_KEY عند تشغيل الحاوية.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.nsfwvideo.top/v1 \
  -e OPENAI_API_KEY=$API_KEY \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

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

ربط الاتجاهين

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

يضيف ذلك خطوة وسيطة. الآن يعبر كل طلب خادم Open WebUI الخاص بك قبل الوصول إلى واجهة برمجة تطبيقات النموذج، لذا هناك عنصر إضافي يجب تشغيله وتحديثه وحمايته. تتراكم حدود المعدل أيضًا بطريقة غير واضحة: يسمح مفتاح الخادم الخلفي بـ 8 طلبات متزامنة و300 طلب في الدقيقة للمفتاح الكامل، ويشارك كل مستخدم وبرنامج نصي يمر عبر مثيل Open WebUI الخاص بك هذا المخصص. إذا أجاب الخادم الخلفي بـ HTTP 429، أو رمز الخطأ rate_limited أو concurrency، فستظهر الفشل عادةً كخطأ في Open WebUI وفي المتصل الخاص بك.

متى تتخطى Open WebUI وتستدعي واجهة برمجة التطبيقات مباشرة

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

Copyimport os
from openai import OpenAI

client = OpenAI(base_url="https://api.nsfwvideo.top/v1", api_key=os.environ["API_KEY"])

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write concise shot lists for short films."},
        {"role": "user", "content": "Shot list for a ninety second chase through a night market."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

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

دليل قرار سريع

• تريد نافذة دردشة لنفسك أو لفريق: قم بتشغيل Open WebUI وأضف الاتصال الصادر.
• إذا كنت تريد إعادة استخدام النصوص البرمجية لإعدادات أو حسابات Open WebUI: استخدم واجهة برمجة التطبيقات الواردة الخاصة بها بمفتاح Open WebUI.
• تريد توليد نص دفعي: اتصل بواجهة برمجة تطبيقات النموذج مباشرة باستخدام OpenAI SDK وتخطى الطبقة الإضافية.
• تريد صوراً أو صوتاً: لا تنتج Open WebUI ولا واجهة برمجة التطبيقات النصية هذه أيًا منهما بمفردها. اربط أدوات منفصلة لتلك الخطوة.

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

ملاحظات أمنية لتعريض أي واجهة برمجة تطبيقات

عامل كلا المفتاحين ككلمات سر. يمنح مفتاح Open WebUI أي صلاحية يمكن للمستخدم الذي أنشأه القيام بها داخل مثيلك؛ يستهلك مفتاح واجهة برمجة تطبيقات النموذج رصيدك المسبق الدفع. لا تلصق أيًا منهما في الكود من جانب العميل أو المستودعات العامة.

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

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

تكلفة تشغيل هذا الإعداد

Open WebUI هو برنامج مجاني تستضيفه؛ تكلفتك هي الخادم بالإضافة إلى الرموز. تُحتسب تكلفة الرموز بمعدل $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، من رصيد مسبق الدفع بدون اشتراك. خذ دور دردشة بـ 3,000 رمز مدخل و500 رمز مخرج: 3,000 × $0.15 / 1M = $0.00045 للإدخال و500 × $0.50 / 1M = $0.00025 للمخرج، بإجمالي $0.0007. تكلفة ألف مثل هذه الأدوار هي $0.70.

شحن الرصيد هو أي مبلغ صحيح من $20 إلى $500، مع +5% من $50، و+10% من $100، و+15% من $200. الدفع بالعملات المشفرة، USDT على TRC20 أو USDC على Base. لا يتم فرض رسوم على الطلبات الفاشلة أو المرفوضة، ولا ينتهي الرصيد. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي بقيمة $0.50 لمدة 7 أيام بنقرة واحدة وبدون تفاصيل الدفع. انظر صفحة التسعير للحصول على الصورة الكاملة.

تذكير بالمحتوى: النموذج مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، ولا يُسمح أبدًا بالمحتوى الجنسي الذي يتضمن القاصرين.

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

• واجهة برمجة تطبيقات LLM بدون رقابة لخطوط أنابيب الفيديو غير المناسبة للعمل