كيفية استخدام API DeepSeek في SillyTavern: نقطة نهاية مخصصة

الإعداد في خمس خطوات

تختزل مسألة استخدام واجهة sillytavern api الخاصة بـ deepseek في حقيقة واحدة: يمكن لـ SillyTavern الاتصال بأي نقطة نهاية متوافقة مع OpenAI، لذا عليك فقط تزويدها بعنوان URL ومفتاح API ومعرف النموذج. لاحظ أن هذه الخدمة ليست واجهة DeepSeek الرسمية. تستضيف نموذجًا واحدًا مفتوح الأوزان بمعرف النموذج uncensored، وتشغله جهة مستقلة ومضبوطة للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين.

1. أنشئ حساباً وافتح صفحة مفتاح API. انسخ مفتاحاً. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي مجاني بنقرة واحدة، دون الحاجة إلى بطاقة، وهو صالح لمدة 7 أيام.
2. في SillyTavern، افتح علامة تبويب اتصالات API (أيقونة القابس في الشريط العلوي).
3. عيّن نوع API إلى Chat Completion. ثم عيّن مصدر Chat Completion إلى Custom (OpenAI-compatible).
4. أدخل https://api.deepseekapi.top/v1 في حقل نقطة النهاية المخصصة. الصق مفتاحك في حقل مفتاح API. في حقل معرف النموذج، أدخل uncensored.
5. اضغط على زر الاتصال. يعني ظهور ضوء الحالة الأخضر واسم النموذج أن الاتصال يعمل.

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

إذا فشل الاتصال

تحقق من هذه النقاط بالترتيب. معظم الأعطال تكون واحدة منها.

• صيغة URL خاطئة. تنتهي نقطة النهاية بـ /v1. لا تضيف /chat/completions.
• المصدر خاطئ. يستخدم وضع إكمال النص تنسيق طلب مختلف. تقدّم هذه الواجهة POST /v1/chat/completions وGET /v1/models، لذا استخدم إكمال المحادثة.
• تم لصق المفتاح مع مسافات. الصقه مرة أخرى وابحث عن مسافة لاحقة.
• الخادم لا يمكنه الوصول إلى الإنترنت. إذا كنت تشغل SillyTavern على خادم منزلي أو في حاوية، فإن الآلة تحتاج إلى وصول HTTPS خارجي.

لفصل مشكلة SillyTavern عن مشكلة المفتاح، اختبر المفتاح من طرفية:

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

قائمة JSON تحتوي على uncensored تعني أن المفتاح جيد. للتحقق من مسار الدردشة نفسه:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

الإعدادات المهمة لألعاب الأدوار

البث المتدفق

فعّل البث المتدفق في لوحة إكمال المحادثة. ترسل الواجهة الرموز عبر SSE بمجرد إنتاجها، لذا تظهر الردود أثناء كتابتها. يحتفظ الطلب المتدفق بإحدى فتحات التزامن الخاصة بك حتى ينتهي البث. يسمح المفتاح الكامل بـ 8 طلبات في وقت واحد، بينما يسمح المفتاح التجريبي بـ 2 طلب.

حجم السياق

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

الحد الأقصى لطول الرد

عيّن حد الاستجابة إلى شيء معقول، مثل 400 إلى 600 رمز (token)، حتى لا يتحول الرد إلى مقال. لا تتطلب الـ API استخدام max_tokens، لكن الحد يحمي رصيدك من المخرجات غير المنضبطة.

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

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

تسلسلات التوقف

إذا بدأ النموذج بكتابة أسطر المستخدم أيضًا، أضف اسم المستخدم متبوعًا بنقطتين (:) كسلسلة توقف. يتم تمرير هذه القيمة.

قائمة فحص عند التشغيل الأول

قبل تحميل شخصية مفضلة، قم بتشغيل دردشة اختبارية قصيرة للتأكد من أن الاتصال يعمل بشكل سليم.

1. أنشئ بطاقة شخصية فارغة أو استخدم بطاقة المساعد الافتراضية.
2. أرسل "أجب بكلمة جاهز." يجب أن تظهر الإجابة خلال ثانية أو ثانيتين وتظهر عبر البث المتدفق أثناء إنتاجها.
3. افتح وحدة تحكم SillyTavern أو سجل الشبكة إذا لم يظهر شيء. يعني رمز 401 أن المفتاح غير صحيح، ورمز 404 يعني أن URL أو معرف النموذج غير صحيح، ورمز 429 يعني تجاوز حدّ المعدل.
4. تحقق من رصيدك. يتضمن كل استجابة رأس X-Balance-USD، مما يتيح لك التحقق من انخفاض الرصيد بمبلغ ضئيل جداً مع كل رسالة.
5. فقط بعد ذلك قم بتحميل بطاقة الشخصية الحقيقية وسجل الخلفية (lorebook).

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

التنقل بين الإعدادات المسبقة

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

كم تكلف جلسة لعب الأدوار

السعر هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، من رصيد مسبق الدفع بدون اشتراك. وبما أن السجل يُعاد إرساله، فإن المدخلات تشكل الجزء الأكبر. قم بمعالجة دردشة بموجّه يتكون من 20,000 رمز لكل رسالة ورد يتكون من 400 رمز:

• الإدخال: 20,000 × $0.15 / 1,000,000 = $0.003
• الإخراج: 400 × $0.50 / 1,000,000 = $0.0002
• المجموع: $0.0032 لكل رسالة

إذن، تكلفة 100 رسالة هي $0.32. الآن قارن سياقًا مختصرًا بسعة 8,000 رمز بنفس الرد: 8,000 × $0.15 / 1,000,000 = $0.0012، زائد $0.0002، مما يجعل التكلفة $0.0014 لكل رسالة و$0.14 لكل 100 رسالة. خفض السياق كلّف أقل من نصف التكلفة لنفس عدد الأدوار.

يغطي رصيد التجربة بقيمة $0.50 حوالي 156 رسالة بالحجم الأكبر (0.50 / 0.0032 = 156.25) أو حوالي 357 رسالة بالحجم الأصغر (0.50 / 0.0014 = 357.1). الطلبات الفاشلة أو المرفوضة لا تُحسب، والرصيد لا ينتهي. يُرجى الاطلاع على صفحة الأسعار لمعرفة مبالغ الشحن والمزايا ووسائل الدفع؛ حيث تُقبل كل من البطاقات (Visa، Mastercard، Apple Pay، Google Pay) والعملات المشفرة (USDT على TRC20، USDC على Base).

الشخصيات، السلامة والقاعدة الصارمة الوحيدة

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

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

بعض العادات العملية تساعد في جودة الدردشة:

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

لا تُستخدم الموجّهات في التدريب. يُرجى قراءة دليل البدء السريع لمراجعة رؤوس الاستجابة، بما في ذلك X-Balance-USD الذي يعرض رصيدك المتبقي.

استخدام الشخصية كواجهة خلفية لتطبيق مرافق

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

إذا قمت لاحقًا ببناء تطبيقك الخاص بدلاً من استخدام SillyTavern، يمكنك استدعاء نقطة النهاية نفسها من الكود. تُظهر دليل البدء السريع أمثلة باستخدام curl وPython وNode.js مع نفس Base URL ومعرف النموذج، لذا يمكن نقل الموجّه الذي يعمل في SillyTavern مباشرة.

حدود المعدل في دردشة مزدحمة

نادراً ما تصل الدردشة الفردية إلى الحدود. الدردشات الجماعية، والسحب (swipe)، وعدد كبير من علامات التبويب المفتوحة قد تصل. تجيب الخدمة بـ HTTP 429 مع الكود rate_limited عند تجاوز حد الطلبات في الدقيقة (60 على المفتاح التجريبي، 300 على المفتاح الكامل) والكود concurrency عندما يكون هناك عدد كبير من الطلبات قيد التنفيذ (2 على التجريبي، 8 على الكامل).

في حالات الحمل الزائد القصيرة، تحصل أيضًا على 429 مع رأس Retry-After: 5. الانتظار لمدة خمس ثوانٍ وإعادة الإرسال هو الاستجابة الصحيحة. إذا رأيت هذه على مفتاح تجريبي، أغلق علامات التبويب الإضافية أو أوقف السحب (swipe) قبل بدء آخر.

المزيد من الأدلة

• كيفية استخدام DeepSeek API في Cursor: إعداد Base URL مخصص
• مثال Python لـ DeepSeek API: الدردشة، البث المتدفق، الأدوات
• مفتاح DeepSeek API: الوصول إلى LLM بدون رقابة