إعداد SillyTavern مع واجهة Ollama API: ربط نقطة نهاية مستضافة
يمكن لـ SillyTavern التحدث مع أي نقطة نهاية متوافقة مع OpenAI من خلال مصدرها المخصص. تشرح هذه الصفحة الإعدادات، القيم التي يجب لصقها، وما يجب فعله عند فشل الاتصال.
محدّث
نقاط رئيسية
- في SillyTavern، اختر إكمال الدردشة، ثم مصدر مخصص (متوافق مع OpenAI).
- عيّن عنوان URL الأساسي إلى https://api.ollamaapi.com/v1 ومعرف النموذج إلى uncensored.
- اختبر باستخدام curl أولاً لتعرف ما إذا كان الفشل في المفتاح أو التطبيق.
- حافظ على حجم نافذة السياق بما يتناسب مع ميزانيتك؛ كل رد يعيد إرسال السجل كمدخلات.
ما تحتاجه قبل البدء
إذا كنت تبحث عن ollama api sillytavern، فغالباً ما تريد استخدام SillyTavern للتحدث مع نموذج عبر عنوان على نمط OpenAI بدلاً من تثبيت Ollama محلياً. هذا ممكن، لأن SillyTavern يتيح لك إضافة أي نقطة نهاية متوافقة مع OpenAI. تربط هذه الصفحة التطبيق بنقطة نهاية مستضافة، مما يعني عدم حاجتك إلى معالج رسومي (GPU) في جانبك.
تحتاج إلى ثلاثة أشياء: تثبيت SillyTavern يعمل، ومفتاح API، وقيم نقطة النهاية. القيم هي:
- عنوان URL الأساسي:
https://api.ollamaapi.com/v1 - معرف النموذج:
uncensored - Authorization: مفتاحك، يُرسل كرمز حامل (يقوم SillyTavern بذلك نيابةً عنك)
بالنسبة إلى المفتاح، سجّل باستخدام Google أو باستخدام البريد الإلكتروني وكلمة المرور وافتح صفحة مفتاح API. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد التجربة بنقرة واحدة هناك. العرض واحد لكل شخص، صالح لمدة 7 أيام، ولا يتطلب بطاقة. مفاتيح التجربة محدودة بـ 2 طلبات متزامنة و60 طلبًا في الدقيقة، وهو ما يكفي لمحادثة واحدة.
قاعدة المحتوى: النموذج مُعدّ للإجابة بدون رفضات المحتوى للاستخدام القانوني للبالغين، مما يناسب الخيال الأدبي، لعب الأدوار، وإعدادات الرفقة للبالغين. لا يُسمح بأي شيء يتضمن القاصرين، وهناك حدّ صارم على ذلك في نقطة النهاية.
اختبر المفتاح باستخدام curl أولاً
اختبار لمدة خمس ثوانٍ يوفر الكثير من التخمين. إذا أعاد هذا الأمر استجابة، فإن المفتاح، وURL، ومعرف النموذج صحيحون، وأي مشكلة لاحقة تكون في إعدادات SillyTavern.
curl https://api.ollamaapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one short sentence."}],
"max_tokens": 40
}'يمكنك أيضاً سرد النماذج باستخدام GET https://api.ollamaapi.com/v1/models باستخدام نفس الرأس. تعني الاستجابة 401 أن المفتاح خاطئ أو مفقود. تعني الرد الذي يحتوي على نص في choices[0].message.content أنك جاهز لتكوين التطبيق.
ربط SillyTavern خطوة بخطوة
قد تتغير أسماء القوائم قليلاً بين إصدارات SillyTavern، لكن المسار ثابت. افتح أيقونة الإضافة (plug) في الأعلى، وهي لوحة اتصالات API.
- اضبط API على Chat Completion. لا تستخدم Text Completion لهذه نقطة النهاية، لأنها توفر إكمالات المحادثة فقط.
- حدد مصدر إكمال الدردشة إلى مخصص (متوافق مع OpenAI).
- في Custom Endpoint (Base URL)، أدخل
https://api.ollamaapi.com/v1. لا تضف أي مسار لاحق مثل/chat/completions. - الصق مفتاحك في Custom API Key.
- في Model ID، اكتب
uncensored. إذا كان الحقل يوفر قائمة منسدلة مملوءة عبر مسار النماذج، اختر نفس الإدخال. - اضغط على Connect. يعني الحالة الخضراء مع اسم النموذج أن المصافحة نجحت.
افتح بطاقة شخصية وأرسل رسالة قصيرة. إذا ظهر النص متدفقاً، فقد أنهيت الاتصال. تغطي الأقسام المتبقية الضبط، لأن الإعدادات الافتراضية ليست دائماً الأنسب لنموذج مستضاف ذو نافذة سياق كبيرة.
تذكير إذا كنت قادمًا من Ollama: اتصال SillyTavern الخاص بـ Ollama يستخدم عنواناً محلياً ومسار Text Completion. يشير هذا المسار إلى جهازك الخاص. هنا تستخدم مسار Chat Completion وعنوان HTTPS عام بدلاً من ذلك، لذا لا يختلط الإعدادان.
إعدادات تستحق التغيير
حجم السياق
النافذة هي 100,000 رمز، للموجه والإكمال. يتيح لك SillyTavern ضبط حجم السياق في لوحة المولد، ويقوم التطبيق بإزالة الرسائل الأقدم عندما يتجاوز حجم المحادثة هذا الحد. القيمة الأكبر تتذكر المزيد من القصة وتكلف أيضاً أكثر، لأن كل السجل يُرسل كمدخل في كل استجابة.
إليك مثال عملي. دورة محادثة ترسل 8,000 رمز من السجل وتستقبل استجابة بـ 300 رمز تكلف 8,000 × $0.15 لكل مليون = $0.0012 للمدخلات، بالإضافة إلى 300 × $0.50 لكل مليون = $0.00015 للمخرجات. هذا $0.00135 لكل دورة، لذا فإن 100 دورة تكلف $0.135. ادفع السجل إلى 60,000 رمز وتكون تكلفة المدخلات وحدها $0.009 لكل دورة، لذا فإن 100 دورة تكلف $0.90 بالإضافة إلى $0.015 للمخرجات، أو $0.915 في المجموع. معظم المحادثات لا تحتاج إلى ذلك، وملخص الأحداث القديمة يعمل عادةً بشكل أفضل من السجل الخام.
الحد الأقصى لطول الرد
max_tokens اختياري. ضبط طول الاستجابة بين 300 و500 رمز يجعل الردود مرتبة ويحد من تكلفة المخرجات. ارفعها إذا كانت الشخصية تميل إلى الانقطاع في منتصف الجملة.
الاستمطار
تمرير درجة الحرارة (Temperature)، top_p، تسلسلات التوقف، البذرة (seed) وعقوبات التكرار والوجود إلى النموذج. ابدأ بالقرب من الإعدادات الافتراضية لبروتوكول المحادثة، وغير قيمة واحدة في كل مرة. إذا كررت الردود العبارات، ارفع العقوبات قليلاً بدلاً من درجة الحرارة.
البث المتدفق
اترك البث المتدفق مفعلاً. يظهر النص كما يتم إنشاؤه، باستخدام SSE. يُبلغ عن الاستخدام في نهاية التدفق. لاحظ أن طلب البث المتدفق يحتل فتحة تزامن حتى ينتهي، لذا فإن الضغط على إعادة التوليد مرتين بسرعة على مفتاح تجريبي (2 طلب متزامن) قد ينتج خطأً.
استكشاف الأخطاء وإصلاحها
| العرض | السبب المحتمل | الحل |
|---|---|---|
| 401 غير مصرح | مفتاح خاطئ أو مفقود | الصق المفتاح مرة أخرى وتحقق من وجود مسافات في أي من الطرفين |
| 404 غير موجود | مسار خاطئ في عنوان URL الأساسي | استخدم بالضبط https://api.ollamaapi.com/v1، لا شيء بعده |
| النموذج غير موجود | معرف النموذج غير صحيح | اكتب uncensored بحروف صغيرة |
429 مع concurrency | عدد كبير من الطلبات في آن واحد | انتظر انتهاء الرد الجاري؛ وتجنّب محادثات المجموعات باستخدام مفتاح تجريبي |
429 مع rate_limited | تجاوز حد الطلبات في الدقيقة | أبطئ؛ يسمح المفتاح الكامل بـ 300 طلب في الدقيقة |
| 429 مع Retry-After 5 | إحمال مؤقت | أعد المحاولة بعد خمس ثوانٍ |
| رسالة CORS للمتصفح | تشغيل SillyTavern على جهاز آخر أو عبر وسيط | فعّل مسار طلبات الخادم أو شغّله على جهاز واحد |
تستحق المحادثات الجماعية ملاحظة. يمكن لـ SillyTavern إرسال عدة ردود للشخصيات بالتتابع أو في الوقت نفسه. إذا رأيت أخطاء التزامن مع المجموعات، قلّل عدد الشخصيات النشطة أو ترقَّ من المفتاح التجريبي. يسمح المفتاح الكامل بـ 8 طلبات متزامنة.
عندما يكون الرد فارغًا أو مقتطعًا، افحص إعداد طول الاستجابة أولاً، ثم تسلسلات التوقف. قد يؤدي تطابق سلسلة التوقف مع كلمة شائعة إلى إنهاء الرد مبكرًا دون ظهور خطأ.
شحن الرصيد والحفاظ على قابلية التنبؤ بالتكاليف
يُكفي رصيد التجربة لتجربة الإعداد وتقييم جودة الكتابة. بتكلفة كل دور من المثال أعلاه، $0.50 تغطي حوالي 370 دورًا في دردشة بطول 8,000 رمز (0.50 مقسومة على 0.00135). بعد ذلك، قم بشحن الرصيد بحد أدنى $20، بأي مبلغ صحيح يصل إلى $500. تُقبل البطاقات (Visa, Mastercard, Apple Pay, Google Pay) والعملات المشفرة (USDT على TRC20, USDC على Base). الشحنات الأكبر تحصل على مكافأة: +5% من $50، +10% من $100 و+15% من $200. لا تنتهي صلاحية الرصيد، ولا يتجدد أي شيء تلقائيًا، ولا تُحسب تكاليف الطلبات الفاشلة أو المرفوضة. انظر صفحة التسعير للحصول على الجدول الكامل.
يظهر الرصيد بعد كل استدعاء في رأس الاستجابة X-Balance-USD، ويمكنك أيضًا التحقق من لوحة التحكم. يشرح التوثيق حقول الطلب إذا أردت الانتقال من SillyTavern إلى سكربتاتك الخاصة لاحقًا. لا تُستخدم الموجّهات للتدريب.
المزيد من الأدلة
أسئلة وأجوبة
أي مصدر SillyTavern يجب أن أختار؟
إكمال الدردشة مع المصدر المخصص (متوافق مع OpenAI). أدخل عنوان URL الأساسي https://api.ollamaapi.com/v1, ومفتاحك ومعرف النموذج uncensored.
هل هذا مثل توصيل SillyTavern بخادم Ollama المحلي؟
لا. يشير الاتصال المحلي بـ Ollama إلى جهازك الخاص. هذا نقطة نهاية مستضافة تُصل عبر HTTPS، ولا يعمل أي نموذج على جهازك.
لماذا يُعيد التوليد أحيانًا خطأً على المفتاح التجريبي؟
يسمح المفتاح التجريبي بـ 2 طلب متزامن. يحافظ الرد المتدفق على دوره حتى ينتهي، لذا يمكن أن يؤدي إعادة التوليد الثانية السريعة إلى تجاوز الحد.
هل يمكنني استخدامه لألعاب الأدوار ودردشات الشخصيات؟
نعم، للاستخدام القانوني للبالغين مثل الخيال الأدبي، وألعاب الأدوار، وتطبيقات الرفقة. لا يُسمح بمحتوى جنسي يتضمن القاصرين.
مفتاحك على بُعد نموذج تعبئة واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.
