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

> **آخرین بازبینی**: 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` قابل اتصال نیست.

## در یک نگاه

| مورد | جزئیات |
|---|---|
| مدل‌های قابل استفاده | Claude ✅ (URL سفارشی API سازگار با Anthropic) · GPT ✅ · مدل‌های چینی ✅ (سازگار با OpenAI) · Gemini ❌ (QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد) |
| پروتکل و Base URL | Anthropic: `https://api.qcode.cc/api/v1` (ST فقط `/messages` را اضافه می‌کند، بنابراین `/v1` در اینجا الزامی است) · OpenAI: `https://api.qcode.cc/openai/v1` |
| محل پیکربندی | پنل اتصال API داخل برنامه (منبع Chat/Text Completion و API URL را انتخاب کنید) |
| مستندات رسمی | [github.com/SillyTavern/SillyTavern](https://github.com/SillyTavern/SillyTavern) |

[SillyTavern](https://github.com/SillyTavern/SillyTavern) یک فرانت‌اند محلی محبوب برای LLM است که بر نقش‌آفرینی و گفتگوهای چندنوبتی تمرکز دارد. از اتصال به انواع مدل‌های چت پشتیبانی می‌کند و افزونه‌هایی برای تولید تصویر، TTS و موارد دیگر دارد. این راهنما توضیح می‌دهد که چگونه از مدل‌های QCode.cc در SillyTavern استفاده کنید.

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

| قابلیت | با QCode کار می‌کند؟ | یادداشت‌ها |
|------|-------------|------|
| **چت (مدل‌های Claude / GPT)** | ✅ بله | SillyTavern از نقاط پایانی سفارشی سازگار با Anthropic / OpenAI پشتیبانی می‌کند؛ فقط BASE_URL و کلید API مربوط به QCode را وارد کنید |
| **تولید تصویر (gpt-image-2)** | ❌ هنوز نه | افزونه تولید تصویر SillyTavern از **نقطه پایانی تصویر سفارشی سازگار با OpenAI پشتیبانی نمی‌کند**، بنابراین نمی‌تواند به `gpt-image-2` در QCode اشاره کند. به «درباره تولید image-2» در ادامه مراجعه کنید |
| **مدل‌های Gemini** | ❌ در دسترس نیست | QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد، بنابراین توصیه نمی‌شود |

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

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

1. **API Connections** (آیکون دوشاخه) → **Chat Completion** را باز کنید.
2. **Chat Completion Source** را روی **Claude** تنظیم کنید.
3. بخش **Reverse Proxy** را در زیر آن باز کنید. **این یک چک‌باکس نیست و کلید تغییر وضعیت هم ندارد** — خالی گذاشتن URL پراکسی صرفاً یعنی «استفاده از نشانی رسمی داخلی SillyTavern».
4. دو فیلد را پر کنید:
   - **Proxy Server URL**: `https://api.qcode.cc/api/v1` (در سرزمین اصلی چین، `https://asia.qcode.cc/api/v1` را ترجیح دهید)
   - **Proxy Password**: کلید API QCode شما (با `cr_` شروع می‌شود)
5. در فهرست کشویی **Claude Model**، `claude-opus-5`، `claude-sonnet-5`، `claude-fable-5-1` و غیره را انتخاب کنید (مدل‌های 4.x مانند `claude-sonnet-4-6` همچنان عرضه می‌شوند).
6. روی **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](https://qcode.cc/models) فهرست نشده است. مدل Haiku که امروز عرضه می‌شود، یعنی `claude-haiku-5-5`، در فهرست کشویی 1.19.0 نیست، بنابراین از اینجا قابل انتخاب نیست. همین محدودیت برای هر مدل Claude که بعداً اضافه کنیم نیز صدق می‌کند: اگر در فهرست SillyTavern نباشد، نمی‌توانید آن را اینجا انتخاب کنید — منتظر به‌روزرسانی SillyTavern بمانید، یا به‌جای آن از [Claude Code](/docs/getting-started/installation) استفاده کنید.
- **آنچه مستندات رسمی درباره پراکسی‌ها می‌گویند:** استفاده از پراکسی‌ای که خودتان آن را اجرا نمی‌کنید خطر حریم خصوصی است، و SillyTavern درخواست‌های پشتیبانی کاربران پراکسی را رد می‌کند. در اینجا URL به حساب کاربری و کلید خودتان در QCode اشاره می‌کند — با در نظر گرفتن این موضوع ادامه دهید.
## 2. گفتگو با مدل‌های GPT در QCode

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

1. **«API Connections»** → **«Chat Completion»**.
2. **«Chat Completion Source»** را روی **«Custom (OpenAI-compatible)»** تنظیم کنید.
3. موارد زیر را پر کنید:
   - **«Custom Endpoint (Base URL)»**: `https://api.qcode.cc/openai/v1` (در سرزمین اصلی چین، `https://asia.qcode.cc/openai/v1` را ترجیح دهید)
   - **«API Key»**: کلید API QCode شما
4. `gpt-6-sol`، `gpt-5.6-terra` و غیره را در **«Enter a Model ID»** تایپ کنید.
5. روی **«Connect»** کلیک کنید.

> همین قاعده اینجا هم برقرار است: **فقط `/openai/v1` را وارد کنید** و خودتان `/chat/completions` را اضافه نکنید (SillyTavern آن را اضافه می‌کند).
> یک کلید API روی همه پروتکل‌ها کار می‌کند؛ مسیر تعیین می‌کند کدام یک. [نقاط پایانی و قالب‌های API](/docs/getting-started/endpoints-and-api-paths) را ببینید.

همین یادداشت‌های انتشار 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](https://github.com/SillyTavern/SillyTavern/issues/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](/docs/usage/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](https://probe.qcode.cc) گزارش می‌شوند؛ کلید API خود را وارد کنید تا آن‌ها را ببینید.

---

> می‌خواهید یک پلن داشته باشید که Claude Code، Codex و کلاینت‌های شخص ثالث مانند این را یک‌جا پوشش دهد؟ [قیمت‌گذاری QCode.cc](https://qcode.cc/pricing) را ببینید — یک کلید API در هر سه پروتکل کار می‌کند.