إعداد API مخصص لـ Narratium: base URL، مفتاح، نموذج.

إجابة سريعة: القيم التي يحتاجها Narratium.

اتصال LLM في Narratium هو الثلاثية القياسية المتوافقة مع OpenAI، تُدخَل في إعدادات API الخاصة به: base URL، ومفتاح API، واسم نموذج. بالنسبة لهذه البوابة فهذه القيم هي https://api.apisrouter.com/v1، ومفتاحك الذي يبدأ بـ sk-...، وأي معرّف من الكتالوج، مع deepseek-v4-flash كخيار أول منطقي لحركة القصص. ملف README الخاص بالمشروع يوصي بالضبط بهذا النوع من الاتصال: APIs بصيغة OpenAI مباشرة، أو نقطة نهاية موحّدة متعددة النماذج للتنوع، أو Ollama وLM Studio للنماذج المحلية، كلها عبر نفس سطح الإعداد. تسميات الحقول الدقيقة تختلف بين نسخة الويب والإصدارات، لذا تعامل مع التسميات بمرونة والقيم بدقة: الـ URL ينتهي بـ /v1، المفتاح يُلصق نظيفاً بدون فراغات، ومعرّف النموذج يطابق نص الكتالوج حرفاً بحرف.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (from APIsRouter)
Model:     deepseek-v4-flash   (typed exactly; any catalog id works)

ما هو Narratium، وحالته، بوضوح.

قدّم Narratium (Narratium/Narratium.ai على GitHub) نفسه كـ VSCode للعب الأدوار: عميل مفتوح المصدر للسرد القصصي المدفوع بالذكاء الاصطناعي، وبناء العوالم، والخيال التفاعلي الطويل، مع توافق مع بطاقات شخصيات SillyTavern، واستمرارية الذاكرة، ونظام إضافات (plugins). الكود مرخّص بموجب AGPL، واستقطب مجتمعاً حقيقياً بسرعة، ولا يزال أحد أكثر العملاء المفتوحين إثارة للاهتمام في هذا المشهد. الآن الجزء الذي تتجاهله معظم أدلة الإعداد: مستودع GitHub مؤرشف وللقراءة فقط (يُظهر GitHub تاريخ الأرشفة في 30 مارس 2026). الأرشفة لا تعني العطب؛ الكود يعمل بنفس الجودة تماماً كما كان يوم تجميده، لكنها تعني أن لا مُشرف يُصدر إصلاحات أو تحديثات تبعيات أو تصحيحات أمنية، وأن النسخ المستضافة المرتبطة بالمشروع يجب أن تُعامَل كحد أقصى كجهد غير مضمون. إذا تبنّيت Narratium اليوم، فالمسار الموثوق هو تشغيله بنفسك من المصدر أو من إصدار (release)، والتوقّع الواقعي هو مجموعة ميزات مجمّدة. هذه الحالة تغيّر نصيحة API بطريقة محددة: العميل المجمَّد هو بالضبط الموقف الذي تريد فيه أن يبقى جانب النموذج مرناً. لم يعد بإمكان Narratium إضافة تكاملات مزودين جدد، لكن نقطة نهاية متوافقة مع OpenAI يتحدث بها بالفعل تستمر في خدمة أي نماذج جديدة تظهر خلف تلك النقطة. نمط البوابة يجعل عملياً عميلاً توقف عن التحرك مقاوماً للتقادم.

خطوات الإعداد.

استكشاف الأخطاء يتّبع النمط العام: أثبت صحة القيم الثلاث بطلب curl أولاً، وإذا نجح curl بينما فشل التطبيق، فالمسبّبات المعتادة هي URL يحمل جزء مسار زائداً، أو فراغات في المفتاح، أو حجب CORS من المتصفح في نسخ الويب، وهو ما يظهر في developer console. بما أنه لن يُصدر أي مُشرف إصلاحاً لغرائب جانب التطبيق بعد الآن، فعادة البدء بـ curl تهم هنا أكثر قليلاً: فهي تخبرك فوراً بأي جانب من الاتصال يمكنك فعلياً فعل شيء حياله.

• شغّل Narratium: استضفه ذاتياً من مصدر GitHub أو من إصدار (repo للقراءة فقط لكن قابل للاستنساخ بالكامل)، أو استخدم نسخة مستضافة إذا كانت هناك نسخة تثق بها ولا تزال تعمل.
• افتح الإعدادات وابحث عن قسم إعداد API / LLM.
• اختر نوع الاتصال بصيغة OpenAI بدلاً من Ollama، لأنك تشير إلى نقطة نهاية مستضافة.
• أدخل base URL: https://api.apisrouter.com/v1، والصق مفتاحك.
• اكتب معرّف النموذج تماماً: deepseek-v4-flash للبدء.
• احفظ وأرسل رسالة قصيرة واحدة في قصة جديدة للتأكد من نجاح الرحلة كاملة.

البطاقات، العوالم، وما يبقى إن غادرت.

يقرأ Narratium بطاقات شخصيات متوافقة مع SillyTavern، وهذه هي حقيقة التوافق الأهم على الإطلاق بشأنه. شخصياتك عناصر قابلة للنقل: البطاقات المكتوبة في مكان آخر تُستورد، والعمل الذي وضعته في الشخصيات وملاحظات العالم غير مقيّد بعميل توقّف تطويره. إذا هاجرت يوماً، فإن SillyTavern وRisuAI وWyvern تتحدث جميعها نفس سلالة البطاقات، وصفحات الإعداد المرتبطة أدناه تغطي كل واحدة منها. نفس منطق قابلية النقل ينطبق على جانب النموذج. لأن Narratium يتحدث إلى نقطة نهاية /v1 عامة، لا شيء في إعداد المزود لديك خاص بـ Narratium: نفس المفتاح ونفس base URL يُدرجان في أي واجهة أمامية أخرى دون تغيير. بين البطاقات القابلة للنقل ونقطة النهاية القابلة للنقل، تقترب تكلفة تبديل المكدس بأكمله من الصفر، وهذا هو الموقف الصحيح تجاه أي مشروع مؤرشف لا تزال تستمتع باستخدامه.

اختيارات النماذج لأسلوب Narratium الطويل.

تصميم Narratium يتمحور حول سرديات طويلة ومتفرعة، مما يرجّح اختيار النموذج نحو الاتساق عبر آفاق زمنية طويلة. يحمل deepseek-v4-flash الجلسات اليومية بأدنى أسعار الكتالوج مع حوار يقيّمه مجتمع لعب الأدوار باستمرار فوق سعره. يتناوب glm-5.1 وkimi-k2.6 لتنويع الصوت، ويكسب glm-5.2 الفصول الغنية بالتفاصيل حيث يفوق التزامه بالتعليمات على مدى طويل تأخّر استدلاله. يظل claude-sonnet-4-6 سقف النثر الآمن للعمل (SFW) للفصول التي تستحقه. بما أن الواجهة الأمامية تعيد إرسال سياق القصة في كل دور، فإن tokens المدخل تهيمن على التكلفة، ونافذة عمل مدروسة تتفوق على نافذة قصوى؛ دليل طول السياق المرتبط أدناه يقوم بالحساب. سياسة المحتوى لا تتغيّر بأي من هذا: سياسات النماذج وشروط المنصة المعمول بها تنطبق كما هي مكتوبة، وصفحة مقارنة السياسات تغطي أي العائلات تناسب أي تصنيفات محتوى، بشكل واقعي.

ادفع حسب الاستخدام · أقل من السعر الرسمي

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

هل يستحق تبنّي عميل مؤرشف رغم كل شيء؟

تقييم تكلفة-فائدة صادق، بما أن هذه الصفحة هي دليل الإعداد على أي حال. لصالحه: الكود مفتوح، والواجهة جيدة فعلاً للقصص الطويلة المنظّمة، والبطاقات قابلة للنقل دخولاً وخروجاً، ونقطة نهاية عامة تُبقي جانب النموذج محدَّثاً إلى الأبد. ضده: لا تصحيحات أمنية، لا إصلاحات أخطاء، تبعيات تتقادم في مكانها، وأي نسخة مستضافة تعيش على وقت مستعار. بالنسبة لعميل هواية يعمل محلياً مقابل مفتاح مقنَّن، ملف المخاطر هذا مقبول لدى كثيرين؛ أما بالنسبة لأي شيء فيه مستخدمون آخرون أو بيانات حساسة، فليس كذلك. المسار الوسط هو ما وصفته هذه الصفحة طوال الوقت: شغّله بنفسك، احتفظ باستثمارك في الطبقات القابلة للنقل (البطاقات، دفاتر المعرفة، نقطة النهاية)، وعامل العميل كشيء قابل للاستبدال. الواجهات الأمامية في هذا المشهد تأتي وتذهب؛ قصة مدعومة ببطاقات قابلة للنقل ونقطة نهاية /v1 مستقرة تعيش أطول منها جميعاً.

الأسئلة الشائعة