راه‌اندازی API سفارشی SillyTavern (Claude، GPT)

اتصال QCode به SillyTavern از طریق پروکسی معکوس Claude یا یک نقطه پایانی سفارشی سازگار با OpenAI: نام فیلدها، مدل‌ها و محدودیت‌های تولید تصویر (2026).

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بازبینی: 2026-11-13 · 📄 بر اساس مستندات رسمی (SillyTavern 1.19.0، منتشرشده در 2026-09-14؛ صفحه GitHub Releases در 2026-11-13 همچنان نسخه 1.19.0 را به‌عنوان Latest فهرست می‌کند)

QCode را در SillyTavern از طریق هر یک از ورودی‌های Chat Completion متصل کنید: Claude را انتخاب کنید و Proxy Server URL و Proxy Password را زیر Reverse Proxy پر کنید، یا Custom (OpenAI-compatible) را انتخاب کنید و Custom Endpoint (Base URL) را همراه با API Key خود پر کنید — مدل‌های Claude و GPT هر دو برای چت کار می‌کنند. افزونه تولید تصویر نقطه پایانی تصویر سفارشی سازگار با OpenAI ندارد، بنابراین gpt-image-2 قابل اتصال نیست.

در یک نگاه¶

SillyTavern یک فرانت‌اند محلی محبوب برای LLM است که بر نقش‌آفرینی و گفتگوهای چندنوبتی تمرکز دارد. از اتصال به انواع مدل‌های چت پشتیبانی می‌کند و افزونه‌هایی برای تولید تصویر، TTS و موارد دیگر دارد. این راهنما توضیح می‌دهد که چگونه از مدل‌های QCode.cc در SillyTavern استفاده کنید.

نتیجه در ابتدا¶

1. گفت‌وگو با مدل‌های Claude در QCode¶

یکپارچه‌سازی Claude در SillyTavern یک بخش جمع‌شونده «Reverse Proxy» ارائه می‌دهد، و همان بخشی است که باید آن را به QCode اشاره دهید:

1. API Connections (آیکون دوشاخه) → Chat Completion را باز کنید.
2. Chat Completion Source را روی Claude تنظیم کنید.
3. بخش Reverse Proxy را در زیر آن باز کنید. این یک چک‌باکس نیست و کلید تغییر وضعیت هم ندارد — خالی گذاشتن URL پراکسی صرفاً یعنی «استفاده از نشانی رسمی داخلی SillyTavern».

4. دو فیلد را پر کنید:

5. Proxy Server URL: https://api.qcode.cc/api/v1 (در سرزمین اصلی چین، https://asia.qcode.cc/api/v1 را ترجیح دهید)

6. Proxy Password: کلید API QCode شما (با cr_ شروع می‌شود)
7. در فهرست کشویی Claude Model، claude-opus-5، claude-sonnet-5، claude-fable-5-1 و غیره را انتخاب کنید (مدل‌های 4.x مانند claude-sonnet-4-6 همچنان عرضه می‌شوند).
8. روی Connect کلیک کنید. چون URL پراکسی تنظیم شده است، اولین کلیک یک کادر گفت‌وگوی تأیید «connect to this proxy URL?» نشان می‌دهد — این مورد انتظار است.

🔴 URL پراکسی باید شامل /v1 باشد: https://api.qcode.cc/api/v1 را وارد کنید و همان‌جا تمام کنید. SillyTavern فقط /messages را بعد از آن اضافه می‌کند و /v1 را برای شما اضافه نمی‌کند — https://api.qcode.cc/api به /api/messages برخورد می‌کند و 404 برمی‌گرداند. اسلش انتهایی هم نباید بگذارید (وگرنه //messages تولید می‌شود). منبع: SillyTavern 1.19.0 src/endpoints/backends/chat-completions.js، شاخه Claude دستور fetch(apiUrl + '/messages') را اجرا می‌کند.

یادداشت‌های انتشار رسمی برای 1.19.0 (منتشرشده در 2026-09-14) پشتیبانی جدید Anthropic از Claude Fable 5 و 5.1، Claude Opus 4.8 و 5، و Claude Sonnet 5 را فهرست می‌کند (بررسی‌شده در 2026-10-20).

دو نکته را از ابتدا بدانید:

• فهرست کشویی Claude Model یک فهرست ثابت است؛ نمی‌توانید شناسه مدل را تایپ کنید. فهرست 1.19.0 از قبل شامل claude-opus-5، claude-sonnet-5، claude-fable-5-1، claude-sonnet-4-6 و claude-haiku-4-5-20251001 است؛ چهار مورد نخست هنوز در QCode عرضه می‌شوند، در حالی که claude-haiku-4-5-20251001 دیگر در qcode.cc/models فهرست نشده است. مدل Haiku که امروز عرضه می‌شود، یعنی claude-haiku-5-5، در فهرست کشویی 1.19.0 نیست، بنابراین از اینجا قابل انتخاب نیست. همین محدودیت برای هر مدل Claude که بعداً اضافه کنیم نیز صدق می‌کند: اگر در فهرست SillyTavern نباشد، نمی‌توانید آن را اینجا انتخاب کنید — منتظر به‌روزرسانی SillyTavern بمانید، یا به‌جای آن از Claude Code استفاده کنید.
• آنچه مستندات رسمی درباره پراکسی‌ها می‌گویند: استفاده از پراکسی‌ای که خودتان آن را اجرا نمی‌کنید خطر حریم خصوصی است، و SillyTavern درخواست‌های پشتیبانی کاربران پراکسی را رد می‌کند. در اینجا URL به حساب کاربری و کلید خودتان در QCode اشاره می‌کند — با در نظر گرفتن این موضوع ادامه دهید.

2. گفتگو با مدل‌های GPT در QCode¶

از نقطه پایانی سازگار با OpenAI استفاده کنید:

1. «API Connections» → «Chat Completion».
2. «Chat Completion Source» را روی «Custom (OpenAI-compatible)» تنظیم کنید.

3. موارد زیر را پر کنید:

4. «Custom Endpoint (Base URL)»: https://api.qcode.cc/openai/v1 (در سرزمین اصلی چین، https://asia.qcode.cc/openai/v1 را ترجیح دهید)

5. «API Key»: کلید API QCode شما
6. gpt-6-sol، gpt-5.6-terra و غیره را در «Enter a Model ID» تایپ کنید.
7. روی «Connect» کلیک کنید.

همین قاعده اینجا هم برقرار است: فقط /openai/v1 را وارد کنید و خودتان /chat/completions را اضافه نکنید (SillyTavern آن را اضافه می‌کند). یک کلید API روی همه پروتکل‌ها کار می‌کند؛ مسیر تعیین می‌کند کدام یک. نقاط پایانی و قالب‌های API را ببینید.

همین یادداشت‌های انتشار 1.19.0 نیز پشتیبانی جدید OpenAI برای مدل‌های GPT-5.6 و GPT-6 Astra را فهرست می‌کنند (بررسی‌شده در 2026-10-20).

3. درباره تولید تصویر image-2 (یادداشتی صادقانه)¶

بسیاری از کاربران می‌پرسند: آیا می‌توانم gpt-image-2 را از QCode به SillyTavern برای پرتره‌های شخصیت / تصویرسازی متصل کنم؟

فعلاً نه. دلیل:

• افزونه تولید تصویر SillyTavern (پیش‌تر افزونه Stable Diffusion) فقط از مجموعه ثابتی از بک‌اندها پشتیبانی می‌کند: 24 ورودی در منوی بازشوی 1.19.0، عیناً شامل ComfyUI، Stable Diffusion Web UI (AUTOMATIC1111)، SD.Next (vladmandic)، stable-diffusion.cpp server، DrawThings HTTP API، NovelAI Diffusion، Stability AI، OpenAI، OpenRouter، TogetherAI، Pollinations، Z.AI. فقط مواردی که خودتان روی ماشین خود اجرا می‌کنید (SD Web UI / SD.Next / ComfyUI / stable-diffusion.cpp / DrawThings) فیلد URL دارند.
• این افزونه گزینه «نقطه پایانی تصویر سفارشی سازگار با OpenAI» را ندارد — یعنی نمی‌توانید مانند بخش گفتگو، به تولید تصویر یک base_url سفارشی بدهید که به /v1/images/generations در QCode اشاره کند.
• هم‌اکنون یک درخواست ویژگی از سوی جامعه کاربران وجود دارد #4851 (عنوان رسمی عیناً: [FEATURE_REQUEST] Custom openai compatible image generation enpoint (image generation extension) — غلط املایی از خودشان است)، که هنوز باز است و تا 2026-09-18 پیاده‌سازی نشده.

دقت کنید: منبع تصویر داخلی OpenAI واقعاً gpt-image-2 را در منوی بازشوی مدل خود فهرست می‌کند، بنابراین نامش طوری به نظر می‌رسد که کار خواهد کرد. اما مقصد درخواست آن در کد منبع به‌صورت سخت‌کدشده روی api.openai.com/v1/images/generations است و فیلد Base URL ندارد، پس همچنان نمی‌تواند به QCode برسد.

گزینه‌های جایگزین¶

اگر می‌خواهید از gpt-image-2 در QCode استفاده کنید، می‌توانید:

• از SDK رسمی OpenAI / هر ابزاری که از نقطه پایانی سفارشی images پشتیبانی می‌کند استفاده کنید تا آن را مستقیم فراخوانی کنید: پایه https://api.qcode.cc/qcode-img/v1، مدل gpt-image-2، با استفاده مجدد از همان کلید QCode. تولید تصویر gpt-image-2 را ببینید.
• پیشرفت مورد #4851 در SillyTavern را دنبال کنید؛ هنگامی که نقطه پایانی تصویر سفارشی سازگار با OpenAI پشتیبانی شد، می‌توانید نقطه پایانی تصویر QCode را همان‌طور که در این صفحه برای «گفتگو» انجام می‌دهید وارد کنید.

پرسش‌های متداول¶

پرسش: اتصال 401 / 403 برمی‌گرداند؟ پاسخ: بررسی کنید که کلید API درست است و منقضی نشده باشد. Claude از فیلد «Proxy Password» استفاده می‌کند، در حالی که حالت سازگار با OpenAI از فیلد «API Key» استفاده می‌کند — آن را در جای اشتباه قرار ندهید.

پرسش: شبکه در سرزمین اصلی چین ناپایدار است؟ پاسخ: دامنه BASE_URL را به asia.qcode.cc تغییر دهید (نود آسیا، نزدیک کره / تایوان / هنگ‌کنگ)؛ اگر آن ناپایدار بود، به api.qcode.cc برگردید (مسیریابی جهانی).

پرسش: می‌توانم سوابق درخواست‌هایم را ببینم؟ پاسخ: بله. درخواست‌ها در همه دامنه‌ها به probe.qcode.cc گزارش می‌شوند؛ کلید API خود را وارد کنید تا آن‌ها را ببینید.

می‌خواهید یک پلن داشته باشید که Claude Code، Codex و کلاینت‌های شخص ثالث مانند این را یک‌جا پوشش دهد؟ قیمت‌گذاری QCode.cc را ببینید — یک کلید API در هر سه پروتکل کار می‌کند.

سازمانی ←