إعداد واجهة SillyTavern API: خطوات الاتصال بتوافق OpenAI
نوضح في إعدادات SillyTavern API نقاط الارتباط، والمفاتيح، وأسماء النماذج، وقيم نافذة السياق التي قد تسبب الارتباك، مع الأوامر اللازمة للتحقق.
تاريخ التحديث
ملاحظات
- اختر طريقة الاتصال المخصصة (متوافق مع OpenAI) الخاصة بـ Chat Completion
- الرابط هو https://api.mukenetsuapi.com/v1 واسم النموذج هو uncensored
- يمكن أن تصل نافذة السياق إلى 100,000 رمز، ولكن من الواقعي تقييدها نظرًا للتكلفة والسرعة
- رمز الخطأ 401 يشير إلى المفتاح، و404 يشير إلى URL، و429 يشير إلى تجاوز حدّ المعدل أو الطلبات المتزامنة

3 عناصر أساسية تحتاجها
إعداد واجهة sillytavern API يتضمن خطوات قصيرة، وتكمن معظم الأخطاء في القيم المدخلة. جهّز الـ 3 عناصر التالية:
- مفتاح API: يتم إصداره من صفحة الحصول على مفتاح API. يمكنك الحصول على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة بعد التسجيل.
- الرابط الأساسي:
https://api.mukenetsuapi.com/v1 - اسم النموذج:
uncensored
SillyTavern هو واجهة أمامية تتيح إضافة نقاط نهاية متوافقة مع OpenAI. بما أن هذه الواجهة البرمجية متوافقة مع OpenAI، لا داعي لاختيار OpenAI الرسمي، بل يمكنك تسجيلها كنقطة نهاية مخصصة.
خطوات الاتصال
قد تختلف تسميات القائمة حسب الإصدار. نذكر هنا المسار العام. إذا كان مختلفاً، يرجى الرجوع أيضاً إلى مستندات SillyTavern نفسها.
- افتح خيار "API Connections" (أيقونة القابس) في الأعلى.
- اختر "Chat Completion" كنوع للـ API.
- من قائمة المصادر، اختر الاتصال المخصص المتوافق مع OpenAI (Custom).
- أدخل
https://api.mukenetsuapi.com/v1في حقل URL الخاص بنقطة النهاية. لا تضيف/chat/completionsفي النهاية. - الصق المفتاح الذي أصدرته في حقل مفتاح API. تأكد من عدم وجود مسافات فارغة قبله أو بعده.
- اجعل اسم النموذج
uncensored. إذا أمكن الاختيار من القائمة، فاختره؛ وإذا أدخلته يدوياً، فاكتبه كما هو. - اضغط على زر الاتصال وتأكد من ظهور رسالة النجاح.
قبل الاتصال، تحقق من صحة المفتاح وURL في الطرفية لتسهيل عزل السبب في حال وجود مشكلة.
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'إذا تم استلام الاستجابة، فهذا يعني أن المفتاح وURL واسم النموذج صحيحون. إذا فشل SillyTavern في هذه الحالة، يمكنك الشك في مدخلات التطبيق.
تحديد طول السياق والاستجابة
يمكن استخدام ما يصل إلى 100,000 رمز للسياق في هذه الـ API، بما في ذلك الموجه والإخراج. ومع ذلك، لا يُنصح بتعيين حجم سياق SillyTavern إلى الحد الأقصى، لأن إرسال إعداد الشخصية، والعالم، وسجل المحادثات في كل مرة يزيد من حجم الإدخال لكل طلب.
مثال حساب التكلفة
إذا تم استخدام 16,000 رمز للسياق، وكانت الاستجابة 300 رمز، فإن التكلفة لكل رسالة تكون كما يلي:
- الإدخال: 16,000 ÷ 1,000,000 × $0.15 = $0.0024
- الإخراج: 300 ÷ 1,000,000 × $0.50 = $0.00015
- المجموع: $0.00255
100 رسالة تكلف $0.255. إذا قمت بتقليل السياق إلى 8,000، سينخفض جانب الإدخال إلى النصف تقريباً. لمزيد من التفاصيل حول الأسعار، يرجى زيارة صفحة الأسعار.
تقديري
في القصص الطويلة أو مشاهد الشخصيات المتعددة، ابدأ بـ 8,000 إلى 16,000 رمز، ثم زد العدد إذا شعرت أن الشخصية تنسى الأحداث السابقة. حدد أقصى طول للاستجابة بما يتناسب مع طول الرد الذي ترغب في قراءته. max_tokens اختياري، لكن يُنصح بتحديد حد أقصى من جانب SillyTavern لتجنب الردود الطويلة جداً.
مفهوم إعدادات أخذ العينات
يتم تمرير temperature، وtop_p، وstop، وseed، وأنواع الغرامات (penalties) المختلفة مباشرة إلى API. يمكن ضبطها باستخدام القوالب الجاهزة في SillyTavern.
- استمرار نفس العبارات: زيادة عقوبات التكرار والحضور قليلاً.
- رد مشتت: قم بخفض قيمة temperature.
- رتابة: قم بزيادة قيمة temperature قليلاً.
- المقارنة: ثبّت seed وغيّر القيم واحدة تلو الأخرى.
تختلف أسماء عناصر القوالب الجاهزة حسب إصدار SillyTavern. إذا لم تُطبَّق الإعدادات، تحقق من التوافق مع طريقة الاتصال المستخدمة أو راجع مستندات SillyTavern.
الأخطاء الشائعة وحلولها
| الأعراض | الأسباب المحتملة | الحل |
|---|---|---|
| 401 | المفتاح غير صحيح أو يحتوي على فراغات | أعد لصق المفتاح وجربه عبر curl. |
| 404 | URL غير صحيح | تحقق من أن المسار ينتهي بـ /v1. |
| النموذج غير موجود | تهجئة اسم النموذج | أدخله بحروف صغيرة: uncensored. |
429 (concurrency) | عدد كبير جداً من الطلبات المتزامنة | قلل من النقرات المتكررة أو التوليد المتزامن في محادثات المجموعات. |
429 (rate_limited) | تجاوز الحد المسموح به من الطلبات في الدقيقة | انتظر قليلاً. |
429 (مرفق بـ Retry-After: 5) | ازدحام مؤقت | انتظر 5 ثوانٍ ثم أعد المحاولة. |
حدّ المفاتيح الكاملة هو 8 متزامنة، 300 في الدقيقة؛ والمفتاح التجريبي 2 متزامنة، 60 في الدقيقة. يستغرق الرد المتدفق إطار اتصال واحد متزامن حتى ينتهي. تشغيل دردشة جماعية بالمفتاح التجريبي يملأ الإطار بسرعة.
يمكنك التحقق من توفر الرصيد باستخدام الأمر التالي:
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"يمكن أيضًا قراءة الرصيد من رأس الاستجابة X-Balance-USD. لعرض قائمة النماذج، استخدم GET /v1/models.
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"ملاحظات الاستخدام
تدعم هذه الواجهة النصوص فقط. إذا كنت تريد استخدام ميزات توليد الصور أو الصوت في SillyTavern، ستحتاج إلى خدمة أخرى. المحتوى يفترض أنه خيال مثل الروايات، ولعب الأدوار، وتطبيقات الرفيق ضمن نطاق الاستخدام القانوني للبالغين. لن يتم إنتاج محتوى جنسي يتضمن القاصرين بأي إعداد. لا تُستخدم الموجّهات في تدريب النموذج.
لمزيد من التفاصيل حول المعاملات، راجع التوثيق. للدفع، يمكنك استخدام USDT (TRC20) أو USDC (Base) بمبالغ صحيحة (أعداد صحيحة) تتراوح بين $20 و$500.
دلائل أخرى
الأسئلة الشائعة
ما اسم النموذج المستخدم في SillyTavern؟
uncensored. أدخله بحروف صغيرة، كما هو.
هل يجب إضافة /chat/completions إلى نهاية URL؟
ليس ضروريًا. يجب أن يكون Base URL حتى /v1، ويضيف التطبيق باقي المسار.
هل يكفي مفتاح التجربة؟
يكفي للتحقق من الاتصال وإجراء محادثات قصيرة. ومع ذلك، يُقيد مفتاح التجربة بـ 2 طلب متزامن و60 طلبًا في الدقيقة، وتكون صلاحيته لمدة 7 أيام فقط، لذا إذا كنت تريد استخدام دردشة المجموعات، يرجى الشحن إلى مفتاح عادي.
هل يمكن توليد الصور أيضًا؟
لا يمكن ذلك. هذه الواجهة مخصصة للنصوص فقط، ولا تدعم توليد الصور أو الصوت أو الفيديو.
ما هو حجم نافذة السياق المناسب؟
الحد الأقصى هو 100,000 رمز (token)، لكن من الواقعي البدء بـ 8,000 إلى 16,000 رمز. كلما زاد الحجم، زادت تكلفة كل إدخال.
يمكن الحصول على مفتاح API عبر نموذج واحد فقط
إنشاء حساب، نسخ المفتاح، تغيير Base URL. بهذه الخطوات البسيطة تكتمل الإعدادات.