AR ▾

الرئيسيةالدليل

SillyTavern مع واجهة برمجة تطبيقات غير خاضعة للرقابة متوافقة مع OpenAI

إذا كنت تبحث عن وسيط claude code لـ sillytavern، إليك النسخة المختصرة: لا يحتاج SillyTavern إلى Claude Code أو وسيط لاستخدام واجهة برمجة التطبيقات هذه. يحتوي على اتصال مخصص مدمج ومتوافق مع OpenAI.

منصة مضيئة مع فقاعات دردشة وأقنعة مربوطة بكابل بخادم، مما يمثل واجهة أمامية للتمثيل الأدبي وواجهة برمجة التطبيقات

نقاط رئيسية

  1. استخدم Chat Completion، ثم مصدر Custom (متوافق مع OpenAI)
  2. نقطة النهاية: https://api.claudecodeproxyapi.com/v1, النموذج: uncensored
  3. اضبط حجم نافذة السياق حتى 100,000 رمز وقم بتفعيل البث المتدفق
  4. تتكلف محادثة مكونة من 200 رسالة بـ 8,000 رمز في كل رسالة و400 رمز خرج حوالي $0.28

هل تحتاج إلى وسيط (proxy) لـ SillyTavern؟

كلمات "Claude Code" و"proxy" و"SillyTavern" غالباً ما تختلط في عمليات البحث، لذا إليك ما يمثل كل منها. يُعد Claude Code أداة سطر الأوامر (CLI) للبرمجة من Anthropic ولا علاقة له بـ SillyTavern. يُعد SillyTavern واجهة محادثة مستضافة ذاتياً (self-hosted) لتقمص الأدوار ومحادثات الشخصيات. في إعدادات OpenAI الأقدم، يستدعي نقطة نهاية مخصصة تُسمى "reverse proxy"، ومن هنا يأتي مصطلح "proxy".

لا تحتاج إلى تشغيل أي خادم إضافي. يمكن لـ SillyTavern التحدث مباشرة مع أي نقطة نهاية متوافقة مع OpenAI، وhttps://api.claudecodeproxyapi.com/v1 هو واحد منها. معرف النموذج هو uncensored. هذا نموذج مفتوح الأوزان تشغله جهة مستقلة، ومضبوط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس Claude وليس واجهة برمجة تطبيقات رسمية من Anthropic أو أي مورد آخر. القاعدة الصارمة الوحيدة هي أن المحتوى الجنسي الذي ينطوي على قاصرين غير مسموح به أبدًا.

الاتصال في خمس خطوات

  1. احصل على مفتاح من صفحة مفتاح API. بعد التسجيل، يمكنك الحصول على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، صالح لمدة 7 أيام، بدون بطاقة.
  2. في SillyTavern، افتح أيقونة الإضافة (اتصالات API) واضبط API على Chat Completion.
  3. اضبط Chat Completion Source على Custom (OpenAI-compatible).
  4. في Custom Endpoint (Base URL)، أدخل https://api.claudecodeproxyapi.com/v1. لا تضيف /chat/completions.
  5. الصق مفتاحك في Custom API Key، اكتب uncensored كـ معرف النموذج، ثم اضغط على Connect.

إشارة الحالة الخضراء وظهور اسم النموذج يعني أن الاتصال نجح. تتغير تسميات القوائم قليلاً بين إصدارات SillyTavern، لذا إذا كان حقل ما يحمل اسماً مختلفاً في إصدارك، ابحث عن الفكرة نفسها: مصدر يقبل عنوان URL على نمط OpenAI.

اختبر المفتاح خارج SillyTavern أولاً

إذا فشل الاتصال، أزل SillyTavern من المعادلة. يجب أن يعيد هذا الطلب قائمة النماذج التي تتضمن uncensored:

curl https://api.claudecodeproxyapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

وهذا الاختبار يختبر ردًا فعليًا، بالطريقة التي ترسله بها دردشة الشخصيات:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Captain Rook, a gruff airship pilot."},
      {"role": "user", "content": "We lost the left engine. Orders?"}
    ],
    "temperature": 0.9,
    "stream": true
  }'

إذا نجح الاثنان في الطرفية (terminal) وفشلا في SillyTavern، فإن السبب هو خطأ مطبعي في حقل عنوان URL أو إعداد متبقي. إذا فشلا في الطرفية أيضاً، تحقق من المفتاح.

إعدادات تستحق التغيير

حجم السياق

تمتلك واجهة برمجة التطبيقات نافذة سياق بسعة 100,000 رمز (token)، تشمل الموجّه والإكمال معاً. شريط سياق SillyTavern هو ما يحدد طول سجل المحادثات، لذا قم بزيادته إلى الحد الذي تحتاجه محادثاتك. السياق الأكبر يعني ذاكرة أغنى، ولكنه يعني أيضاً المزيد من رموز المدخلات لكل رسالة، وهو ما يترتب عليه التكلفة.

طول الاستجابة

حدد طول استجابة أقصى يتناسب مع أسلوبك. تتعامل واجهة برمجة التطبيقات مع max_tokens كخيار، لكن الحد الأقصى يمنع استمرار الرد ويحافظ على قابلية التكلفة للتنبؤ.

البث المتدفق

فعّل البث المتدفق (streaming) لتظهر الردود كلمة بكلمة. تستخدم البث تقنية SSE وتبلغ عن الاستخدام في النهاية. يحتفظ البث بمكان تزامن واحد حتى ينتهي، وهو أمر مهم إذا كنت تشغل عدة محادثات في وقت واحد: يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة، بينما يسمح المفتاح التجريبي بـ 2 و60.

أخذ العينات (Sampling)

يتم تمرير درجة الحرارة وtop_p وتسلسلات التوقف والبذرة والعقوبات. للحوار الحي، ابدأ بالقرب من درجة حرارة 0.9. إذا كررت الشخصية العبارات، أضف عقوبة تكرار صغيرة قبل تغيير أي شيء آخر.

معالجة ما بعد الموجّه

إذا نجح الاتصال لكن الردود تتجاهل بطاقة الشخصية، راجع خيار معالجة ما بعد الموجّه للمصدر المخصص وجرب وضعاً مختلفاً. تدمج بعض الأوضاع أو تعيد ترتيب رسائل النظام، مما قد يغير كيفية قراءة البطاقة.

استدعاء الدوال والإضافات

تدعم واجهة برمجة التطبيقات استدعاء الأدوات: tools، tool_choice، البث المتدفق tool_calls والنتائج المرسلة مرة أخرى كـ role: "tool". يعتمد ما إذا كنت تستطيع استخدامه من SillyTavern على الإصدار والإضافات التي تقوم بتثبيتها، حيث أن استدعاء الدوال في واجهات المستخدم اختياري ويُعالَج عبر ميزات محددة. إذا قمت ببناء أدوات شخصية أو إضافة خاصة بك، فإن شكل الطلب هو الشكل القياسي لـ OpenAI، وتظهر المستندات أمثلة. للدردشة الشخصية العادية، لا تحتاج إلى أدوات على الإطلاق.

يتوفر أيضًا وضع JSON عبر response_format: {"type":"json_object"}. وهو مفيد للإضافات التي تطلب من النموذج بيانات مُهيكلة، مثل متتبع الحالة للمخزون أو العلاقات.

تكلفة الدردشة

يبلغ السعر $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، ولا تُخصم التكلفة عن الطلبات الفاشلة أو المرفوضة. لنفترض أن كل رسالة ترسل 8,000 رمز من البطاقة وسجل الحقائق والسجل التاريخي وتحصل على رد مكون من 400 رمز:

  • الإدخال: 8,000 / 1,000,000 × $0.15 = $0.0012
  • الإخراج: 400 / 1,000,000 × $0.50 = $0.0002
  • لكل رسالة: $0.0014
  • دردشة مكونة من 200 رسالة: 200 × $0.0014 = $0.28

لذا فإن رصيد التجربة بقيمة $0.50 يغطي دردشة طويلة أولى. تبدأ الشحنات من $20، مع مكافآت +5% من $50، +10% من $100 و+15% من $200، ولا ينتهي رصيد غير مستخدم. على هذا الموقع يتم الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). التفاصيل موجودة على صفحة التسعير. إذا كنت تريد توصيل نفس نقطة النهاية إلى CLI للبرمجة، فإن دليل استكشاف أخطاء الوكيل يشرح سبب الحاجة إلى وكيل ترجمة هناك وليس هنا.

أبقِ بطاقات الشخصيات منخفضة التكلفة

رموز الإدخال هي الجزء الأكبر من الفاتورة، وتُعاد إرسال البطاقة مع كل رسالة. بعض العادات تقلل التكلفة دون الإضرار بالشخصية:

  • اكتب البطاقة كجمل قصيرة عن الصوت والأهداف والحدود بدلاً من نصوص الخلفية الطويلة.
  • احتفظ بإدخالات سجل المعرفة مرتبطة بكلمات محددة بحيث يتم إدراج ذات الصلة فقط.
  • لخص المشاهد القديمة في بضعة أسطر كل فترة، ثم قم بتقصير السجل الخام.
  • تحقق من عداد الرموز في عرض الموجّه وقص أي شيء لا يستخدمه النموذج أبدًا.

يؤدي تقليل متوسط الإدخال من 8,000 إلى 4,000 رمز لكل رسالة إلى خفض جزء الإدخال من الرسالة من $0.0012 إلى $0.0006، وهو توفير بقيمة $0.0006 لكل رسالة و$0.12 على 200 رسالة.

مشاكل شائعة

المشكلةتحقّق
يظهر الاتصال خطأًيجب أن ينتهي URL بـ /v1 ولا يحتوي على /chat/completions؛ اختبره باستخدام أوامر curl أعلاه
الرد ينقطع في منتصف الجملةقم بزيادة إعداد طول الاستجابة؛ واجهة برمجة التطبيقات نفسها لا تقيد شيئًا أسفل نافذة السياق
الردود متكررةأضف عقوبة تكرار أو وجود صغيرة وارفع درجة الحرارة قليلاً
تتوقف الدردشة بعد العديد من الرسائلقد تكون قد وصلت إلى نافذة 100,000 رمز؛ قلل من شريط السياق أو قم بالتلخيص
خطأ 429 عند تشغيل دردشتينيتيح مفتاح التجربة طلبين متزامنين؛ أوقف البث المتدفق أو قم بشحن الرصيد للحصول على مفتاح كامل

عند التواصل مع الدعم، أرسل رأس X-Request-Id من الاستجابة الفاشلة. صفحة المفاتيح هي أيضًا حيث يمكنك التحقق من أن المفتاح الذي ألصقته هو الحالي.

أسئلة وأجوبة

هل أحتاج إلى Claude Code لاستخدام SillyTavern مع واجهة برمجة التطبيقات هذه؟

لا. يتصل SillyTavern بواجهة برمجة التطبيقات مباشرةً عبر مصدرها المخصص (متوافق مع OpenAI). يُعد Claude Code أداة برمجة منفصلة.

ما عنوان URL الذي يُدخل في SillyTavern؟

أدخل https://api.claudecodeproxyapi.com/v1 كنقطة نهاية مخصصة، دون /chat/completions. استخدم uncensored كـ model ID.

لماذا أحصل على خطأ 429 في جلسة طويلة؟

إما أنك أرسلت طلبات كثيرة جداً في الدقيقة، أو طلبات كثيرة في آن واحد. تحتفظ الردود المتدفقة بمكان في الطلبات المتزامنة حتى تنتهي، ويعني خطأ 429 مع Retry-After: 5 وجود حمل زائد مؤقت، لذا انتظر خمس ثوانٍ.

هل هذا النموذج هو Claude؟

لا. إنه نموذج مفتوح الأوزان من مزود مستقل، مستضاف خلف واجهة برمجة تطبيقات متوافقة مع OpenAI.

هل يُسمح بأي محتوى؟

النموذج مُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. المحتوى الجنسي الذي ينطوي على قاصرين غير مسموح به أبداً.

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.