راهاندازی API در SillyTavern: base URL، کلید API و لیست مدلها
Updated 2026-07-15
در SillyTavern، گزینه Chat Completion را انتخاب کنید، منبع را روی Custom (سازگار با OpenAI) بگذارید، یک base URL که به /v1 ختم میشود وارد کنید و کلید API خود را اضافه کنید. سپس لیست کشویی مدلها خودش از /v1/models همان provider پر میشود.
پاسخ سریع: پنج تنظیمی که اهمیت دارند
پنل 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 را به هر چیزی که وارد کنید اضافه میکند، پس URL باید دقیقاً در /v1 متوقف شود. اگر https://api.apisrouter.com/v1/chat/completions را جایگذاری کنید، SillyTavern درخواست /v1/chat/completions/chat/completions میفرستد و اتصال با خطای 404 شکست میخورد. این دقیقاً برعکس JanitorAI است که در تنظیمات proxy خودش URL کامل completions را میخواهد. provider یکسان است، اما قرارداد فیلدها فرق دارد.
چرا آدرس API در SillyTavern به /v1 ختم میشود
هر API سازگار با OpenAI یک base URL بهعلاوه مجموعهای از مسیرهای ثابت است. GET /v1/models فهرست شناسههای مدلی را برمیگرداند که کلید شما مجاز به استفاده از آنهاست. POST /v1/chat/completions درخواست واقعی چت را اجرا میکند. SillyTavern این مسیرها را میشناسد و خودش میسازد، پس فقط base را از شما میپرسد. وقتی روی Connect کلیک میکنید، با کلید شما /v1/models را صدا میزند و از پاسخ آن برای پر کردن لیست کشویی مدلها استفاده میکند. لیست خالی تقریباً همیشه یعنی این فراخوانی شکست خورده است. باید حالت درست API را هم انتخاب کنید. Chat Completion پیامهای ساختاریافته با نقشهای system، user و assistant میفرستد که همان چیزی است که هر provider میزبانیشده و سازگار با OpenAI انتظار دارد. Text Completion یک رشته prompt خام میفرستد و بیشتر برای backendهای محلی مثل KoboldCpp و text-generation-webui وجود دارد. برای هر کلید API میزبانیشده، از Chat Completion استفاده کنید. اگر Text Completion را در برابر یک endpoint چت میزبانیشده انتخاب کنید، با خطا یا فرمت بههمریخته مواجه میشوید، و چند sampler نمایش دادهشده در آن حالت اصلاً اعمال نمیشوند.
راهاندازی گامبهگام
اگر لیست بعد از Connect همچنان خالی ماند، این سه مورد را به ترتیب دوباره بررسی کنید: URL دقیقاً در /v1 تمام میشود بدون مسیر اضافه یا فاصله انتهایی، کلید بدون گیومه یا فاصله جایگذاری شده، و منبع Custom (سازگار با OpenAI) است نه OpenAI ساده. منبع OpenAI ساده در برخی نسخهها URL سفارشی شما را نادیده میگیرد و با 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 پر میشود.
- یک مدل انتخاب کنید، یک character card باز کنید و یک پیام آزمایشی کوتاه بفرستید.
تأیید اتصال بیرون از SillyTavern
وقتی چیزی کار نمیکند، قبل از سرزنش SillyTavern خود endpoint را مستقیماً تست کنید. این فراخوانی curl دقیقاً همان کاری است که دکمه Connect انجام میدهد. اگر یک آرایه JSON از شناسههای مدل برگرداند، کلید و URL شما درست است و مشکل در فیلدهای SillyTavern است. اگر لیست مدلها کار میکند اما چتها شکست میخورند، یک completion واقعی از Python با همان base URL اجرا کنید. یک پاسخ موفق در اینجا کل زنجیره را ثابت میکند، و هر پیام خطایی که برمیگردد خطای واقعی provider است نه پیام عمومی SillyTavern.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"اصول sampler و پریست
منابع Chat Completion مجموعهای کوچک از sampler ها را نشان میدهند: temperature، top P، frequency penalty و presence penalty، بهعلاوه طول پاسخ و اندازه context. samplerهای پیچیدهتری که شاید دربارهشان خوانده باشید (min P، mirostat، dynamic temperature) متعلق به backendهای Text Completion هستند و اصلاً به API های چت میزبانیشده فرستاده نمیشوند، پس دنبالشان اینجا نگردید. پریستها در SillyTavern دو چیز را با هم بستهبندی میکنند: مقادیر sampler و ساختار prompt ای که Prompt Manager از character card، persona و lorebook شما میسازد. پریست پیشفرض داخلی نقطه شروع معقولی است. هر بار یک مقدار را تغییر دهید و همان صحنه را دوباره تولید کنید تا ببینید واقعاً چه تأثیری دارد. اندازه context ارزش توجه دارد: SillyTavern پنجره context را با تاریخچه چت پر میکند، پس context بزرگتر یعنی توکن ورودی بیشتر در هر نوبت که هم حافظه را بهتر میکند و هم هزینه هر پیام را بالا میبرد.
| تنظیم | نقطه شروع | کارکرد آن در رولپلی |
|---|---|---|
| Temperature | 0.8 | مقدار بالاتر (تا 1.1) نثر متنوعتری میدهد؛ پایینتر (0.6) اگر شخصیت از روی کارت خارج شد |
| Top P | 0.95 | دستنخورده بگذارید مگر پاسخها بیربط شوند، آنوقت کمی پایین بیاورید |
| Frequency penalty | 0.1 | با ریتم تکراری جملات در چتهای طولانی مقابله میکند |
| Presence penalty | 0.05 | مقادیر کوچک از چرخش روی یک موضوع جلوگیری میکند |
| Max response tokens | 350 | 300 تا 500 برای پاسخهای پاراگرافی بدون پرگویی مناسب است |
| Context size | محدودیت مدل یا 16k | تاریخچه بیشتر در هر نوبت؛ همچنین توکن ورودی بیشتر که در هر پیام محاسبه میشود |
مدلهای پیشنهادی برای SillyTavern
انتخاب مدل مهمتر از تنظیم sampler است. اجماع تقریبی جامعه کاربران، تا جایی که گزارشهای موجود نشان میدهند، خانواده DeepSeek V4 را از نظر قیمت در صدر میگذارد: deepseek-v4-flash توصیه پیشفرض برای چتهای طولانی است و deepseek-v4-pro کارتهای پیچیده و چتهای گروهی را بهتر منسجم نگه میدارد. GLM-5، Kimi K2.6 و MiMo انتخابهای باارزشی با لحن نثری متمایز هستند که وقتی چت یکنواخت به نظر برسد، ارزش امتحان کردن دارند. Grok قابلتوجه است چون سیاست منتشرشده xAI صراحتاً مضامین بزرگسالانه را در بسترهای کاملاً داستانی مجاز میداند، که برای داستانهای تاریکتر اهمیت دارد. Claude بهترین نثر این فهرست را مینویسد اما سیاست Anthropic محتوای صریح را ممنوع میکند، پس Claude را برای نگارش خلاقانه SFW و صحنههای ادبی در نظر بگیرید. دو نکته کاربردی. اول، SillyTavern نرمافزاری برای بزرگسالان است و هر مدل در این فهرست، صرفنظر از frontend شما، سیاست محتوای provider خودش را اعمال میکند، پس کارتها و صحنهها را در چارچوب همان قوانین نگه دارید. دوم، چون لیست کشویی زنده از /v1/models پر میشود، میتوانید وسط چت مدل را عوض کنید و پاسخها را روی یک پیام مقایسه کنید که سریعترین راه برای پیدا کردن مدل موردعلاقه خودتان است.
| شناسه مدل | نقطه قوت در SillyTavern | نکات سیاست محتوا |
|---|---|---|
| deepseek-v4-flash | مورد علاقه جامعه برای چتهای طولانی؛ بهترین ارزش هر پیام | سیاست منعطف برای داستان؛ کارتهای شخصیت را خوب دنبال میکند |
| deepseek-v4-pro | پیروی قویتر از دستور برای کارتهای پیچیده و چتهای گروهی | همان خانواده Flash با انسجام بهتر |
| glm-5 | لحن نثری متمایز؛ ریتم خوب در صحنههای کند | انتخاب باارزش برای چتهای روایتمحور |
| kimi-k2.6 | یادآوری context طولانی برای lorebook های بزرگ | انتخاب باارزش؛ کارتهای بزرگ را بدون فراموشی مدیریت میکند |
| grok-4.5 | ایمپرویزیشن و بگومگوی قوی | سیاست xAI مضامین بزرگسالانه در بسترهای داستانی را مجاز میداند |
| claude-sonnet-4-6 | بالاترین کیفیت نثر به ازای قیمت | فقط نگارش خلاقانه SFW؛ Anthropic محتوای صریح را ممنوع میکند |
| claude-opus-4-7 | بهترین نگارش ادبی بلند | همان سیاست فقط-SFW مثل Sonnet |
| gemini-3.5-flash | پاسخهای سریع، context طولانی | سیاست استاندارد Google؛ مناسب برای رولپلی ماجراجویانه |
هزینه واقعی چتهای SillyTavern چقدر است
مدلهای میزبانیشده بر اساس توکن صورتحساب میشوند، و رولپلی از نظر ورودی سنگین است: هر نوبت دوباره کارت شخصیت بهعلاوه تاریخچه اخیر را میفرستد. نوبتی که 8,000 توکن prompt میفرستد و پاسخ 350 توکنی میگیرد روی deepseek-v4-flash حدود یکدهم سنت هزینه دارد، پس چند دلار ماهها چت معمولی را پوشش میدهد. همان نوبت روی claude-opus-4-7 حدود 25 برابر بیشتر هزینه دارد، به همین دلیل بیشتر افراد یک مدل روزانه ارزان اجرا میکنند و مدلهای پرمیوم را برای صحنههایی که برایشان مهم است نگه میدارند. یک کلید گیتوی این کل جدول را پوشش میدهد. APIsRouter یک گیتوی سازگار با OpenAI با صورتحساب پرداخت بر اساس مصرف و بدون اشتراک است: در /topup بدون ساخت حساب پرداخت میکنید، کلید با ایمیل میرسد، اولین شارژ شما +100% مطابق به موجودیتان اضافه میکند، مدلهای جهانی 20% پایینتر از نرخ رسمی قیمتگذاری شدهاند، و مدلهای چینی زیر قیمت رسمی خودشان هستند.
| مدل | ورودی / 1M توکن | خروجی / 1M توکن |
|---|---|---|
| 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 |
پرسشهای پرتکرار
در SillyTavern چه URL ای برای API وارد کنم؟
فقط base URL، که به /v1 ختم میشود. برای APIsRouter این آدرس https://api.apisrouter.com/v1 است. SillyTavern خودش /chat/completions را اضافه میکند، پس وارد کردن مسیر کامل completions اتصال را با خطای 404 خراب میکند.
آیا API رایگانی برای SillyTavern وجود دارد؟
خود SillyTavern نرمافزار رایگان و متنباز است. دسترسی به مدلهای میزبانیشده بر اساس توکن صورتحساب میشود، هرچند برخی providerها سطح رایگان با محدودیت نرخ و صف سختگیرانه ارائه میدهند. اجرای یک مدل محلی از طریق KoboldCpp اگر سختافزار شما جواب بدهد رایگان است. در عمل، مدلهای میزبانیشده ارزان مثل deepseek-v4-flash کسری از یک سنت در هر پیام هزینه دارند، که برای استفاده معمولی به اندازه کافی به رایگان نزدیک است بدون دردسر محدودیت نرخ.
چرا لیست مدلهای SillyTavern من خالی است؟
فراخوانی Connect به /v1/models شکست خورده. بررسی کنید که URL دقیقاً به /v1 ختم شود بدون مسیر یا فاصله اضافه، کلید تمیز جایگذاری شده باشد، و منبع Custom (سازگار با OpenAI) باشد نه OpenAI ساده. با curl در برابر /v1/models تست کنید تا خطای واقعی provider را ببینید.
در SillyTavern از Chat Completion استفاده کنم یا Text Completion؟
Chat Completion برای هر API میزبانیشده و سازگار با OpenAI. Text Completion برای backendهای محلی مثل KoboldCpp و text-generation-webui است که رشته prompt خام میگیرند. انتخاب Text Completion در برابر یک endpoint چت میزبانیشده باعث خطا یا فرمت خراب میشود.
کدام مدل برای رولپلی در SillyTavern بهترین است؟
با deepseek-v4-flash شروع کنید، پیشفرض رایج جامعه کاربران برای چتهای طولانی با هزینه کم. برای کارتهای پیچیده به deepseek-v4-pro بروید، GLM-5 یا Kimi K2.6 را برای لحن نثری متفاوت امتحان کنید، و از Claude برای باکیفیتترین نگارش خلاقانه SFW استفاده کنید. Grok برای مضامین داستانی بزرگسالانه تحت سیاست منتشرشده xAI مناسب است.
آیا کلید API من در SillyTavern امن است؟
کلیدها بهصورت محلی در فایل secrets.json مربوط به SillyTavern روی دستگاه شما ذخیره میشوند و فقط به host API ای که تنظیم کردهاید فرستاده میشوند. اسکرینشات پنل اتصال یا فایلهای تنظیمات صادرشده را به اشتراک نگذارید، و اگر گمان میکنید کلید لو رفته آن را عوض کنید.