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

اربط QCode بـ SillyTavern عبر وكيل Claude العكسي أو نقطة نهاية مخصصة متوافقة مع OpenAI: أسماء الحقول، والنماذج، وحدود توليد الصور (2026).

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 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.

لمحة سريعة¶

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-opus-5، claude-sonnet-5، claude-fable-5-1 وما إلى ذلك من القائمة المنسدلة «Claude Model» (لا يزال الإصدار 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 → إكمال الدردشة.
2. اضبط مصدر إكمال الدردشة على مخصص (متوافق مع OpenAI).

3. املأ:

4. نقطة نهاية مخصصة (Base URL): https://api.qcode.cc/openai/v1 (في البر الرئيسي للصين، يُفضّل https://asia.qcode.cc/openai/v1)

5. مفتاح API: مفتاح QCode API الخاص بك
6. اكتب gpt-6-sol، gpt-5.6-terra إلخ في أدخل معرّف النموذج.
7. انقر على اتصال.

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

المؤسسات ←