واجهة API متوافقة مع OpenAI لـ SillyTavern: إعداد خطوة بخطوة

قبل البدء

تحتاج إلى ثلاثة أشياء: تثبيت SillyTavern قيد التشغيل، مفتاح API، وتفاصيل نقطة النهاية. للمفتاح، سجّل في صفحة مفتاح API باستخدام Google أو البريد الإلكتروني، ثم احصل على رصيد التجربة بقيمة $0.50 بنقرة واحدة. لا يتطلب طريقة دفع ويستمر لمدة 7 أيام. الشحنات الكاملة تُدفع بالعملات المشفرة (USDT على TRC20 أو USDC على Base)، بدءاً من $20.

القيم التي ستلصقها:

الحقل	القيمة
عنوان URL الأساسي	https://api.nsfwaiapi.com/v1
معرّف النموذج	uncensored
المصادقة	يُرسَل مفتاح Bearer كمفتاح API

لا تضيف /chat/completions إلى عنوان URL الأساسي. يضيف تطبيق SillyTavern المسار تلقائيًا.

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

تحقق من المفتاح خارج التطبيق

اختبار مدته دقيقتان يوفر الكثير من التخمين. إذا نجح curl، فإن أي فشل لاحق هو إعداد في SillyTavern وليس في مفتاحك.

Copycurl https://api.nsfwaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

قائمة JSON التي تتضمن uncensored تعني أن المفتاح وURL صحيحان. بعد ذلك، جرّب إكمالاً حقيقياً:

Copycurl https://api.nsfwaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi in five words."}]}'

يؤكد الرد الذي يحتوي على مصفوفة choices أن التوليد يعمل. يُظهر رأس الاستجابة X-Balance-USD رصيدك المتبقي. مزيد من تفاصيل نقطة النهاية موجود في الوثائق.

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

1. افتح أيقونة التوصيل (API Connections) في الشريط العلوي.
2. اضبط نوع واجهة برمجة التطبيقات على إكمال الدردشة.
3. في القائمة المنسدلة للمصدر، اختر مخصص (متوافق مع OpenAI).
4. في حقل نقطة النهاية المخصصة، الصق https://api.nsfwaiapi.com/v1.
5. الصق مفتاحك في حقل مفتاح API واحفظه.
6. في حقل معرف النموذج، اكتب uncensored. إذا عرض التطبيق قائمة نماذج بعد الاتصال، اختر الاسم نفسه.
7. اضغط على Connect. يعني شريط الحالة الأخضر أن التطبيق وصل إلى نقطة النهاية.

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

حجم السياق وطول الاستجابة

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

الأكبر ليس أفضل تلقائيًا. تُحسب المدخلات بسعر $0.15 لكل مليون رمز، لذا فإن الطلب الذي يملأ 32,000 رمز من السياق يكلف 32,000 / 1,000,000 × $0.15 = $0.0048 قبل الرد. عند 100,000 رمز يكون التكلفة $0.015 لكل طلب. خلال ليلة من 200 رسالة، يكون هذا الفارق مبلغًا حقيقيًا مقارنة برصيد بقيمة $20: 200 × $0.0048 = $0.96 مقابل 200 × $0.015 = $3.00 في المدخلات فقط، بافتراض أن السياق ممتلئ منذ الرسالة الأولى، وهو ما يبالغ في التقييم لدردشة جديدة.

بداية عملية هي 16,000 إلى 32,000 رمز من السياق وطول رد يتراوح بين 300 و500 رمز. ارفع السياق فقط عندما ينسى الشخصية أشياء مهمة. دليل نماذج لعب الأدوار يوضح كيف تؤثر طول السياقات على المشاهد.

إعدادات العينة التي يمكنك تجربتها

مع مصدر إكمال الدردشة، يرسل SillyTavern قيم العينة التي تقبلها API. تمرر هذه الخدمة temperature وtop_p وstop وseed وخصائص التكرار والوجود.

• Temperature: 0.85 إلى 1.0 للمشهد الإبداعي، و0.6 إلى 0.7 إذا كانت الشخصية تبتعد.
• Top P: 0.9 إلى 0.95.
• Frequency and presence penalty: 0.2 إلى 0.5 لقطع العبارات المتكررة في الدردشات الطويلة.
• Streaming: فعّله. تظهر الردود كلمة بكلمة وتشعر أسرع. يحمل الطلب المتدفق شريحة concurrency حتى ينتهي البث، وهو أمر مهم فقط إذا كنت تشغل عدة دردشات في وقت واحد.

الإعدادات الخاصة بواجهات أخرى، مثل top_k أو min_p أو عقوبة التكرار من المحركات المحلية، قد يتم تجاهلها. إذا لم يكن للمنزلقة تأثير مرئي، فلا تقضِ وقتًا فيه.

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

خطأ 401 أو فشل المصادقة

تم لصق المفتاح مع وجود مسافة أو قيمة خاطئة. الصقه مرة أخرى واضغط على حفظ قبل الاتصال.

خطأ 404 أو خطأ في النموذج

تحقق من أن عنوان URL الأساسي ينتهي بـ /v1 وأن معرف النموذج هو بالضبط uncensored، بحروف صغيرة.

خطأ 429 مع رمز rate_limited أو concurrency

المفتاح الكامل يسمح بـ 300 طلب في الدقيقة و8 في وقت واحد؛ ويسمح مفتاح التجربة بـ 60 في الدقيقة و2 في وقت واحد. إذا كان لديك عدة علامات تبويب أو دردشة جماعية تولد معًا، فقد تصل إلى حد التزامن. انتظر لحظة وأعد المحاولة. يعني رأس Retry-After: 5 في استجابة 429 وجود حمل زائد مؤقت، لذا فإن الانتظار لمدة خمس ثوانٍ هو الإجراء الصحيح.

الرد مقطوع في منتصف الجملة

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

نفاد الرصيد

لا يتم احتساب الطلبات الفاشلة أو المرفوضة، ولكن الطلبات الناجحة يتم احتسابها. تحقق من الأسعار لمعرفة مبالغ الشحن والمكافآت.

الموجّهات، القوالب المسبقة والدردشات الجماعية

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

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

ترسل الدردشات الجماعية طلبًا واحدًا لكل شخصية تتحدث. مع مفتاح تجريبي محدود بـ 2 طلب متزامن، قد تؤدي مجموعة من أربعة أشخاص تولد بشكل متزامن إلى حدوث خطأ concurrency 429. اضبط المجموعة لتوليد رد واحد في كل مرة، أو انتقل إلى مفتاح كامل بـ 8 فتحات متزامنة.

عند تبديل الشخصيات، تذكر أن سجل المحادثات يُعاد إرساله في كل مرة. تبدأ الدردشة الجديدة بنافذة سياق صغيرة وفاتورة صغيرة، لذا افتح دردشة جديدة لمشهد جديد بدلاً من سحب سجل محادثات بحجم 60,000 رمز معه.

كم تكلف الجلسة

خذ ليلة من 100 رسالة. افترض أن الطلب المتوسط يحمل 12,000 رمز من المدخلات ويعيد 350 رمز. المدخلات: 100 × 12,000 = 1,200,000 رمز، وهو ما يساوي 1.2 × $0.15 = $0.18. المخرجات: 100 × 350 = 35,000 رمز، وهو ما يساوي 0.035 × $0.50 = $0.0175. المجموع حوالي $0.20 لليلة كاملة.

الرصيد لا ينتهي صلاحيته ولا يوجد اشتراك، لذا يغطي الشحن بقيمة $20 حوالي 100 ليلة بمعدل ذلك. تنطبق المكافآت على الشحنات الأكبر: +5% من $50، +10% من $100، +15% من $200. تتحرك الأرقام مع حجم سياقك، وهو الرافعة الرئيسية التي تتحكم بها.

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

• موجّه نظام النموذج اللغوي الكبير NSFW: الهيكل والأمثلة
• أفضل نموذج لغوي كبير محلي للتمثيل، أم API مستضاف؟