# إعداد API مخصص في SillyTavern (Claude، GPT)

> **آخر تحقق**: 2026-11-13 · 📄 وفق الوثائق الرسمية (SillyTavern 1.19.0، صدر في 2026-09-14؛ لا تزال صفحة GitHub Releases تُدرج 1.19.0 كأحدث إصدار بتاريخ 2026-11-13)

اربط QCode في SillyTavern عبر أي من مدخلي **إكمال الدردشة**: اختر **Claude** واملأ **عنوان URL لخادم الوكيل** و**كلمة مرور الوكيل** ضمن **الوكيل العكسي**، أو اختر **مخصص (متوافق مع OpenAI)** واملأ **نقطة نهاية مخصصة (Base URL)** مع **مفتاح API** الخاص بك — يعمل كلا نموذجي 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 داخل التطبيق (اختر مصدر الدردشة/إكمال النص + 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-opus-5`، `claude-sonnet-5`، `claude-fable-5-1` وما إلى ذلك من القائمة المنسدلة **«Claude Model»** (لا يزال الإصدار 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** → **إكمال الدردشة**.
2. اضبط **مصدر إكمال الدردشة** على **مخصص (متوافق مع OpenAI)**.
3. املأ:
   - **نقطة نهاية مخصصة (Base URL)**: `https://api.qcode.cc/openai/v1` (في البر الرئيسي للصين، يُفضّل `https://asia.qcode.cc/openai/v1`)
   - **مفتاح API**: مفتاح QCode API الخاص بك
4. اكتب `gpt-6-sol`، `gpt-5.6-terra` إلخ في **أدخل معرّف النموذج**.
5. انقر على **اتصال**.

> نفس القاعدة هنا: **املأ فقط `/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).
- تابع تقدم مشكلة SillyTavern رقم #4851؛ بمجرد دعم نقطة نهاية صور مخصصة متوافقة مع 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 واحد يعمل عبر جميع البروتوكولات الثلاثة.