إعداد SillyTavern API: الرابط الأساسي، مفتاح API، وقائمة النماذج

Updated 2026-07-15

في SillyTavern، اختر Chat Completion، اضبط المصدر على Custom (متوافق مع OpenAI)، الصق رابطاً أساسياً ينتهي بـ /v1، وأضف مفتاح API الخاص بك. عندها تمتلئ قائمة النماذج تلقائياً من نقطة /v1/models الخاصة بالمزود.

الإجابة السريعة: الإعدادات الخمسة المهمة

افتح لوحة API Connections (أيقونة القابس) واضبط بالضبط ما يلي: API = Chat Completion. Chat Completion Source = Custom (متوافق مع OpenAI). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = مفتاحك sk-... انقر Connect، انتظر الضوء الأخضر، واختر نموذجاً من القائمة المنسدلة، مثلاً deepseek-v4-flash. الخطأ الأكثر شيوعاً هو لصق المسار الكامل. SillyTavern يضيف /chat/completions إلى أي شيء تدخله، لذا يجب أن يتوقف الرابط عند /v1. إذا لصقت https://api.apisrouter.com/v1/chat/completions، سيطلب SillyTavern /v1/chat/completions/chat/completions وسيفشل الاتصال بخطأ 404. هذا عكس JanitorAI، الذي يريد رابط الإكمال الكامل في إعدادات الـ proxy الخاصة به. نفس المزود، لكن اصطلاحات حقول مختلفة.

لماذا ينتهي رابط SillyTavern API عند /v1

كل API متوافق مع OpenAI هو رابط أساسي بالإضافة إلى مجموعة من المسارات الثابتة. GET /v1/models يعيد قائمة معرّفات النماذج التي يمكن لمفتاحك استخدامها. POST /v1/chat/completions ينفذ طلب المحادثة الفعلي. SillyTavern يعرف هذه المسارات ويبنيها بنفسه، لذا لا يطلب منك سوى الرابط الأساسي. عندما تنقر Connect، يستدعي /v1/models بمفتاحك ويستخدم الرد لملء قائمة النماذج المنسدلة. القائمة الفارغة تعني غالباً أن هذا الاستدعاء فشل. تحتاج أيضاً إلى اختيار وضع API الصحيح. Chat Completion يرسل رسائل منظمة بأدوار system وuser وassistant، وهذا ما يتوقعه كل مزود مستضاف متوافق مع OpenAI. Text Completion يرسل سلسلة نص خام واحدة ويوجد أساساً للخوادم المحلية مثل KoboldCpp وtext-generation-webui. لأي مفتاح API مستضاف، استخدم Chat Completion. إذا اخترت Text Completion مقابل نقطة محادثة مستضافة، ستحصل على أخطاء أو تنسيق غير مفهوم، وعدة أدوات ضبط معروضة في ذلك الوضع لا تنطبق أصلاً.

الإعداد خطوة بخطوة

إذا بقيت القائمة فارغة بعد Connect، أعد التحقق من ثلاثة أمور بالترتيب: أن الرابط ينتهي عند /v1 دون أي مسار إضافي أو مسافات زائدة، أن المفتاح ملصق دون علامات اقتباس أو فراغات، وأن المصدر هو Custom (متوافق مع OpenAI) وليس OpenAI العادي. مصدر OpenAI العادي يتجاهل رابطك المخصص في بعض الإصدارات ويتواصل مع api.openai.com، حيث يكون مفتاحك غير صالح.

  • احصل على مفتاح. في APIsRouter لا يوجد نموذج حساب: ادفع في /topup ويصلك المفتاح بالبريد الإلكتروني. أي مفتاح متوافق مع OpenAI يعمل بنفس الطريقة في هذه الخطوات.
  • في SillyTavern، انقر أيقونة القابس لفتح API Connections.
  • اضبط API على Chat Completion.
  • اضبط Chat Completion Source على Custom (متوافق مع OpenAI).
  • في Custom Endpoint (Base URL)، أدخل https://api.apisrouter.com/v1 دون أي شيء بعد /v1.
  • الصق مفتاحك في حقل Custom API Key.
  • انقر Connect. تتحول نقطة الحالة إلى اللون الأخضر وتمتلئ قائمة Available Models من /v1/models.
  • اختر نموذجاً، افتح بطاقة شخصية، وأرسل رسالة اختبار قصيرة.

تحقق من الاتصال خارج SillyTavern

عندما يفشل شيء ما، اختبر نقطة النهاية مباشرة قبل إلقاء اللوم على SillyTavern. استدعاء curl هذا هو بالضبط ما يفعله زر Connect. إذا أعاد مصفوفة JSON من معرّفات النماذج، فمفتاحك ورابطك سليمان والمشكلة في حقول SillyTavern. إذا عملت قائمة النماذج لكن المحادثات فشلت، شغّل طلب إكمال حقيقياً واحداً من Python بنفس الرابط الأساسي. الرد الناجح هنا يثبت السلسلة كاملة، وأي رسالة خطأ تحصل عليها هي خطأ المزود الحقيقي وليس الخطأ العام لـ SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

أساسيات أدوات الضبط والإعدادات المسبقة

مصادر Chat Completion تعرض مجموعة صغيرة من أدوات الضبط: temperature وtop P وfrequency penalty وpresence penalty، بالإضافة إلى طول الرد وحجم السياق. أدوات الضبط الأكثر تعقيداً التي ربما قرأت عنها (min P وmirostat وdynamic temperature) تخص خوادم Text Completion ولا تُرسل ببساطة إلى واجهات المحادثة المستضافة، لذا لا تبحث عنها هنا. الإعدادات المسبقة في SillyTavern تجمع أمرين: قيم أدوات الضبط وبنية الـ prompt التي يجمّعها Prompt Manager من بطاقة الشخصية والـ persona والـ lorebook. الإعداد المسبق Default المدمج نقطة انطلاق معقولة. غيّر قيمة واحدة في كل مرة وأعد توليد نفس المشهد لترى ما يفعله فعلياً. حجم السياق يستحق الانتباه: SillyTavern يملأ نافذة السياق بسجل المحادثة، لذا سياق أكبر يعني tokens أكثر تُرسل مع كل prompt في كل جولة، مما يحسّن الذاكرة ويرفع تكلفة كل رسالة في الوقت نفسه.

قيم بداية لإعدادات Chat Completion المسبقة. اضبط قيمة واحدة في كل مرة.
الإعدادنقطة البدايةماذا يفعل في لعب الأدوار
Temperature0.8قيمة أعلى (حتى 1.1) تمنح نثراً متنوعاً؛ قيمة أقل (0.6) إذا خرجت الشخصية عن بطاقتها
Top P0.95اتركه كما هو ما لم تصبح الردود غير مترابطة، عندها خفّضه قليلاً
Frequency penalty0.1يقاوم تكرار أنماط الجمل في المحادثات الطويلة
Presence penalty0.05القيم الصغيرة تمنع تكرار نفس المواضيع
Max response tokens350300 إلى 500 يناسب الردود على شكل فقرات دون إطالة
Context sizeحد النموذج أو 16kسجل أكبر في كل جولة؛ وأيضاً tokens إدخال أكثر تُحتسب في كل رسالة

النماذج الموصى بها لـ SillyTavern

اختيار النموذج أهم من ضبط أدوات الضبط. توافق المجتمع، بحسب التقارير التقريبية المتاحة، يضع عائلة DeepSeek V4 في المقدمة من ناحية السعر: deepseek-v4-flash هو التوصية الافتراضية للمحادثات الطويلة وdeepseek-v4-pro يحافظ على تماسك البطاقات المعقدة والمحادثات الجماعية بشكل أفضل. GLM-5 وKimi K2.6 وMiMo خيارات قيمة جيدة بأصوات نثرية مميزة، تستحق التبديل عندما تبدأ المحادثة تبدو متكررة. Grok لافت لأن سياسة xAI المنشورة تسمح صراحة بالموضوعات الناضجة في السياقات الخيالية، وهذا مهم للقصص الأكثر قتامة. Claude يكتب أفضل نثر في هذه القائمة لكن سياسة Anthropic تحظر المحتوى الصريح، لذا اعتبر Claude الخيار للكتابة الإبداعية الآمنة (SFW) والمشاهد ذات الطابع الأدبي. ملاحظتان عمليتان. أولاً، SillyTavern برنامج موجّه للبالغين، وكل نموذج هنا يفرض سياسة المحتوى الخاصة بمزوده بغض النظر عن الواجهة التي تستخدمها، لذا حافظ على البطاقات والمشاهد ضمن تلك القواعد. ثانياً، بما أن القائمة تُملأ مباشرة من /v1/models، يمكنك تبديل النماذج في منتصف المحادثة ومقارنة الردود على نفس الرسالة، وهذه أسرع طريقة لتجد نموذجك المفضل.

معرّف النموذجنقطة القوة في SillyTavernملاحظات سياسة المحتوى
deepseek-v4-flashالمفضل لدى المجتمع للمحادثات الطويلة؛ أفضل قيمة لكل رسالةسياسة مرنة للأعمال الخيالية؛ يتبع بطاقات الشخصيات جيداً
deepseek-v4-proاتباع أقوى للتعليمات للبطاقات المعقدة والمحادثات الجماعيةنفس عائلة Flash مع تماسك أفضل
glm-5صوت نثري مميز؛ إيقاع جيد في المشاهد البطيئةخيار قيمة للمحادثات الغنية بالسرد
kimi-k2.6استرجاع سياق طويل لكتب المعلومات الكبيرةخيار قيمة؛ يتعامل مع البطاقات الكبيرة دون نسيان
grok-4.5ارتجال قوي وحوار خفيفسياسة xAI تسمح بالموضوعات الناضجة في السياقات الخيالية
claude-sonnet-4-6أعلى جودة نثر مقابل السعركتابة إبداعية آمنة (SFW) فقط؛ Anthropic تحظر المحتوى الصريح
claude-opus-4-7أفضل كتابة أدبية طويلةنفس سياسة SFW فقط الخاصة بـ Sonnet
gemini-3.5-flashردود سريعة، سياق طويلسياسة Google القياسية؛ جيد لأسلوب لعب الأدوار المغامر

كم تكلف محادثات SillyTavern فعلياً

النماذج المستضافة تُفوتَر لكل token، ولعب الأدوار كثيف من ناحية الإدخال: كل جولة تعيد إرسال بطاقة الشخصية بالإضافة إلى السجل الأخير. جولة ترسل 8,000 token من الـ prompt وتحصل على رد من 350 token تكلف نحو عُشر السنت على deepseek-v4-flash، لذا بضعة دولارات تغطي أشهراً من الدردشة العادية. نفس الجولة على claude-opus-4-7 تكلف نحو 25 ضعفاً أكثر، ولهذا معظم الناس يستخدمون نموذجاً يومياً رخيصاً ويحتفظون بالنماذج المتميزة للمشاهد التي تهمهم. مفتاح بوابة واحد يغطي هذا الجدول بالكامل. APIsRouter بوابة متوافقة مع OpenAI بفوترة حسب الاستخدام ودون اشتراك: تدفع في /topup دون إنشاء حساب، يصلك المفتاح بالبريد الإلكتروني، أول عملية شحن تضيف +100% مطابقة إلى رصيدك، النماذج العالمية مسعّرة بنسبة 20% أقل من الأسعار الرسمية، والنماذج الصينية أقل من أسعارها الرسمية.

أسعار الكتالوج بالدولار الأمريكي. kimi-k2.6 وMiMo متوفران أيضاً في الكتالوج.
النموذجالإدخال / مليون tokenالإخراج / مليون token
deepseek-v4-flash$0.126$0.252
deepseek-v4-pro$0.3915$0.783
glm-5$0.514$2.314
gemini-3.5-flash$1.20$7.20
claude-sonnet-4-6$2.40$12.00
claude-opus-4-7$4.00$20.00
gpt-5.5$4.00$24.00
grok-4.5$1.60$4.80

الأسئلة الشائعة

ما رابط API الذي أضعه في SillyTavern؟

الرابط الأساسي فقط، الذي ينتهي عند /v1. بالنسبة لـ APIsRouter هذا هو https://api.apisrouter.com/v1. SillyTavern يضيف /chat/completions بنفسه، لذا إدخال مسار الإكمال الكامل يكسر الاتصال بخطأ 404.

هل توجد API مجانية لـ SillyTavern؟

SillyTavern نفسه برنامج مجاني ومفتوح المصدر. الوصول للنماذج المستضافة يُفوتَر لكل token، رغم أن بعض المزودين يقدمون مستويات مجانية بحدود معدل وطوابير انتظار صارمة. تشغيل نموذج محلي عبر KoboldCpp مجاني إذا كان عتادك قادراً على تحمله. عملياً، النماذج المستضافة الاقتصادية مثل deepseek-v4-flash تكلف جزءاً من السنت لكل رسالة، وهذا قريب بما يكفي من المجاني للاستخدام العادي دون معاناة حدود المعدل.

لماذا قائمة نماذج SillyTavern لدي فارغة؟

استدعاء Connect إلى /v1/models فشل. تحقق من أن الرابط ينتهي عند /v1 دون مسار إضافي أو مسافات، أن المفتاح ملصق بشكل نظيف، وأن المصدر هو Custom (متوافق مع OpenAI) وليس OpenAI العادي. اختبر باستخدام curl مقابل /v1/models لترى خطأ المزود الحقيقي.

هل أستخدم Chat Completion أم Text Completion في SillyTavern؟

Chat Completion لأي API مستضافة ومتوافقة مع OpenAI. Text Completion مخصص للخوادم المحلية مثل KoboldCpp وtext-generation-webui التي تأخذ سلسلة prompt خام. اختيار Text Completion مقابل نقطة محادثة مستضافة يسبب أخطاء أو تنسيقاً معطلاً.

ما أفضل نموذج للعب الأدوار في SillyTavern؟

ابدأ بـ deepseek-v4-flash، الخيار الافتراضي الشائع لدى المجتمع للمحادثات الطويلة بتكلفة منخفضة. انتقل إلى deepseek-v4-pro للبطاقات المعقدة، جرّب GLM-5 أو Kimi K2.6 لصوت نثري مختلف، واستخدم Claude لأعلى جودة كتابة إبداعية آمنة (SFW). Grok يناسب الموضوعات الخيالية الناضجة بحسب سياسة xAI المنشورة.

هل مفتاح API الخاص بي آمن في SillyTavern؟

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