خطوات إعداد واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة لـ SillyTavern

ما تحتاجه قبل البدء

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

اجمع هذه القيم:

• عنوان URL الأساسي: https://api.ornith.top/v1
• معرف النموذج: uncensored
• مفتاح API: تم إنشاؤه في صفحة مفتاح API بعد تسجيل دخولك باستخدام Google أو باستخدام البريد الإلكتروني وكلمة المرور.

يمكن للحسابات الجديدة المطالبة برصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة في تلك الصفحة. لا يتطلب الأمر بطاقة، وهو حصري لكل شخص، ويصمد لمدة 7 أيام. وهذا كافٍ لاختبار بطاقة شخصية، لأن تكلفة دور محادثة نموذجي هي جزء من سنت واحد (الحساب مفصل في الأسفل).

اختبر المفتاح باستخدام curl أولاً

قبل التعامل مع SillyTavern، أرسل طلبًا واحدًا من سطر الأوامر. إذا نجح، فإن أي فشل لاحق هو إعداد واجهة أمامية؛ إذا فشل، فإن المشكلة هي المفتاح أو الشبكة.

Copycurl https://api.ornith.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in one short sentence."}]
  }'

يجب أن تحصل على JSON يحتوي على مصفوفة choices. انظر أيضًا إلى رؤوس الاستجابة: يُظهر X-Balance-USD رصيدك المتبقي، وX-Request-Id هو ما يجب ذكره إذا تواصلت مع الدعم الفني. يمكنك أيضًا عرض النماذج باستخدام GET /v1/models:

Copycurl https://api.ornith.top/v1/models \
  -H "Authorization: Bearer $API_KEY"

يعرض القائمة معرف النموذج الذي يجب استخدامه في SillyTavern، وهو uncensored.

ربط SillyTavern خطوة بخطوة

1. افتح SillyTavern وانقر على أيقونة التوصيل في الأعلى لفتح اتصالات API.
2. من القائمة المنسدلة لـ API، اختر إكمال الدردشة.
3. في القائمة المنسدلة مصدر إكمال الدردشة، اختر مخصص (متوافق مع OpenAI).
4. في نقطة النهاية المخصصة (عنوان URL الأساسي) أدخل https://api.ornith.top/v1. توقف عند /v1. لا تضيف /chat/completions، لأن تطبيق العميل يضيف هذا المسار تلقائيًا.
5. الصق مفتاحك في حقل مفتاح API المخصص.
6. في معرف النموذج اكتب uncensored.
7. اضغط على Connect. يعني الحالة الخضراء مع اسم النموذج أن المصافحة نجحت.

تتغير تسميات القوائم قليلاً بين إصدارات SillyTavern، لذا إذا اختلف الاسم في إصدارك، ابحث عن الفكرة نفسها: مصدر متوافق مع OpenAI، حقل نقطة النهاية، حقل المفتاح وحقل النموذج. إذا فشل الاتصال، كرر اختبار curl. يعني خطأ المصادقة من curl أن المفتاح خاطئ؛ يعني نجاح curl مع فشل الاتصال عادةً وجود خطأ مطبعي في عنوان URL، مثل فقدان /v1 أو مسار زائد.

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

الإعدادات المهمة لألعاب الأدوار

حجم السياق

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

البث المتدفق

فعّل البث المتدفق في إعدادات إكمال الدردشة. تدعم الـ API تقنية SSE مع stream: true، مما يسمح بظهور النص أثناء توليده ويمكنك إيقاف الرد السيئ مبكراً. يتم الإبلاغ عن الاستخدام في نهاية البث.

أخذ العينات

يتم تمرير درجة الحرارة وtop_p وسلاسل الإيقاف والبذرة وعقوبات التكرار والحضور مباشرةً إلى النموذج. للمحادثة الإبداعية، تكون درجة الحرارة حول 0.8 إلى 1.0 مع top_p قريب من 0.9 نقطة بداية شائعة. إذا كانت الردود تتشعب أو تتكرر، خفّف درجة الحرارة قليلاً وأضف عقوبة تكرار صغيرة. غيّر إعداداً واحداً في كل مرة لترى تأثيره.

موجه النظام وبطاقة الشخصية

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

التكلفة لكل رسالة، محسوبة

التسعير هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج، من رصيد مسبق الدفع بدون اشتراك. نظرًا لأن SillyTavern يعيد إرسال البطاقة والسجل في كل دور، فإن الإدخال هو الغالب.

افترض أن دور المحادثة يرسل 6,000 رمز من السياق ويسترد 400 رمز:

• الإدخال: 6,000 بسعر $0.15 لكل مليون يساوي $0.0009.
• الإخراج: 400 بسعر $0.50 لكل مليون يساوي $0.0002.
• المجموع: $0.0011 لكل دور.

تتكلف جلسة مكونة من 200 دور $0.22. يغطي رصيد التجربة المجاني بقيمة $0.50 حوالي 450 دورًا من هذا النوع. الطلبات الفاشلة أو المرفوضة لا تُحاسب. عند إضافة رصيد، يعمل أي مبلغ صحيح من $20 إلى $500، مع +5% من $50، و+10% من $100، و+15% من $200، عبر البطاقة (Visa، Mastercard، Apple Pay، Google Pay) أو العملات المشفرة (USDT على TRC20، USDC على Base). الرصيد لا ينتهي. صفحة التسعير تحتوي على التفاصيل.

إصلاح الأخطاء الشائعة

العرض	السبب المحتمل	الحل
يفشل الاتصال فورًا	عنوان URL الأساسي أو المفتاح غير صحيح	استخدم https://api.ornith.top/v1 بدون مسار إضافي؛ وأعد اختبار curl
HTTP 429، الكود rate_limited	طلبات كثيرة جداً في الدقيقة	أبطئ؛ تسمح المفاتيح التجريبية بـ 60 طلب في الدقيقة، والمفاتيح الكاملة بـ 300
HTTP 429، الكود concurrency	عدد كبير من الطلبات في آن واحد	انتظر انتهاء الرد الجاري؛ تتيح المفاتيح التجريبية 2 في آنٍ واحد، والمفاتيح الكاملة 8
HTTP 429 مع Retry-After: 5	حمل زائد مؤقت	أعد المحاولة بعد 5 ثوانٍ
الطلب كبير جدًا	جسم الطلب يتجاوز 8 ميجابايت	قلل حجم نافذة السياق أو قم بتقليص كتاب lorebook
طول نافذة السياق كبير جداً	الموجّه زائد الرد يتجاوز 100,000 رمز (token)	قلل حجم نافذة السياق أو طول الرد

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

لمعرفة جميع المعاملات وأشكال الأخطاء الدقيقة، اقرأ وثائق API.

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

• LLM غير خاضع للرقابة: ماذا يعني وكيف تستخدم واحداً
• أفضل LLM بدون رقابة للتشغيل محلياً مع Ollama
• دليل API LLM مفتوح المصدر: الإعداد، التكاليف والخيارات البديلة