KoboldAI Lite على نقطة نهاية مخصصة متوافقة مع OpenAI.

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

افتح لوحة اتصال AI (زر AI في القائمة العلوية لـ Lite)، بدّل من AI Horde الافتراضي إلى مجموعة نقطة النهاية المخصصة، واختر خيار المتوافق مع OpenAI. التسميات الدقيقة تتغيّر قليلاً بين الإصدارات، لكن الحقول ثابتة: URL لـ API، مفتاح، ونموذج يُختار بعد الاتصال. تفصيلان خاصان بـ Lite يسببان معظم المشاكل عند الفشل. أولاً، خانة الإصدار: يوفّر Lite مفتاحاً بأسلوب "Add Ver. Num" يُلحق /v1 بالـ URL نيابة عنك، لذا إدخال https://api.apisrouter.com مع تفعيل الخانة، أو https://api.apisrouter.com/v1 مع إلغاء تفعيلها، كلاهما يعمل بشكل صحيح، بينما تكرار /v1 لا يعمل. ثانياً، الاستمرارية: تاريخياً كان Lite يُعيد ضبط عناوين نقاط النهاية المخصصة عند إعادة الاتصال، لذا احتفظ بالـ URL في متناول يدك بدلاً من افتراض أن الحقل يبقى محفوظاً في كل جلسة.

API URL:  https://api.apisrouter.com/v1   (or base URL + "Add Ver. Num" ticked)
API key:  sk-...                            (from APIsRouter)
Model:    deepseek-v4-flash                 (or any catalog id after connecting)

ما هو Lite، وكيف يصل إلى نموذج مستضاف.

KoboldAI Lite هو واجهة الويب الخالية من التثبيت في نظام Kobold: تطبيق بصفحة واحدة لكتابة القصص، ووضع المغامرة، ومحادثة الشخصيات، يعمل بالكامل في متصفحك. يأتي بشكلين يشتركان في نفس الإعدادات: النسخة المستضافة على lite.koboldai.net، والنسخة المرفقة التي يخدمها KoboldCpp على localhost عند تشغيل النماذج محلياً. يصف ملف README الخاص بالمشروع قدرته على الاتصال بنقاط نهاية مخصصة تشمل APIs بشكل OpenAI وبشكل Claude، إلى جانب نسخ Kobold المحلية والبعيدة وAI Horde التشاركي. بما أن Lite تطبيق متصفح بدون خادم خاص به، فإن طلبات API الخاصة بك تذهب مباشرة من المتصفح إلى أي نقطة نهاية تضبطها. هذا التصميم هو سبب عمل مسار نقطة النهاية المخصصة أصلاً، وهو أيضاً سبب وجود قسم CORS أدناه: يجب على نقطة النهاية أن تجيب على طلبات منشؤها المتصفح، وعندما لا تفعل، يوفّر Lite مفتاح وكيل (proxy) له مقايضات تستحق الفهم قبل تفعيله. بالنسبة للقادمين من AI Horde: جاذبية نقطة النهاية المقنَّنة مقارنة بالعنقود التطوعي هي إمكانية التنبؤ. Horde مجاني فعلاً لكن بطابور؛ نقطة نهاية ممولة تجيب فوراً بالنموذج الدقيق الذي طلبته، وبأسعار عائلة القيمة تكلف أمسية لعب جزءاً صغيراً من السنت لكل رسالة.

الإعداد، حقلاً بحقل.

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

• افتح Lite (المستضاف أو المرفق) وانقر زر AI في القائمة العلوية لفتح لوحة الاتصال.
• بدّل اختيار المزود من AI Horde إلى مجموعة نقطة النهاية المخصصة، واختر خيار المتوافق مع OpenAI (التسميات تختلف قليلاً حسب الإصدار؛ يوجد خيار بشكل Claude بجانبه).
• أدخل الـ URL: https://api.apisrouter.com/v1، مع مراعاة خانة الإصدار الموضّحة أعلاه بحيث يظهر /v1 مرة واحدة بالضبط.
• الصق مفتاحك الذي يبدأ بـ sk-... في حقل المفتاح.
• اتصل، ثم اختر نموذجاً من القائمة التي يجلبها Lite، أو اكتب معرّف الكتالوج بدقة إذا كان إصدارك يطلب اسم نموذج يدوياً.
• أرسل رسالة قصيرة واحدة في قصة جديدة للتأكد من نجاح الرحلة كاملة قبل تحميل جلسة طويلة.

خيار نقطة نهاية Claude، ومتى تستخدمه.

مجموعة نقطة النهاية المخصصة في Lite تتضمن أيضاً خياراً بشكل Claude لـ APIs بلهجة Anthropic. يخدم APIsRouter هذه اللهجة أيضاً، على /v1/messages، لذا معرّفات claude يمكن الوصول إليها عبر أي من البابين. عملياً، مسار المتوافق مع OpenAI هو الافتراضي الأبسط حتى لنماذج Claude، لأن إعداداً واحداً يخدم عندها كل عائلة: claude-sonnet-4-6 للنثر الراقي، وdeepseek-v4-flash للعب بحجم كبير، وglm-5.2 وkimi-k2.6 للتدوير، كلها كتغييرات في حقل النموذج بدلاً من إعادة ضبط. المكان الذي يستحق فيه خيار شكل Claude مكانه هو إذا احتفظت بإعدادات مسبقة مضبوطة خصيصاً لتنسيق طلبات Anthropic أو هاجرت إعدادات من أداة أخرى بلهجة Anthropic. وظيفياً، كلا المسارين ينتهيان إلى نفس النماذج عبر هذه البوابة؛ اختر واحداً والتزم به حتى تبقى إعداداتك المحفوظة قابلة للنقل.

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

يعرض Lite في إعداداته المجموعة الكاملة من samplers الخاصة بالنماذج المحلية، ومعظمها لا ينتقل. على نقاط النهاية المتوافقة مع OpenAI، توثّق وثائق Lite نفسها أن أدوات التحكم من طراز temperature وtop-p وrepetition-penalty فقط هي التي تنطبق؛ أما samplers الغريبة مثل Min-P وTop-A أو TFS فهي ميزات استدلال محلي، ورغم أن Lite يمكنه إرفاقها كحقول إضافية، فإن نقاط النهاية المستضافة عموماً تتجاهل أو ترفض المعاملات غير القياسية. اضبط temperature حول 0.8 إلى 0.9 لتنوّع النثر، واترك top-p قرب 0.95، وأبقِ عقوبات التكرار منخفضة؛ هذا هو كامل السطح القابل للضبط، وهو كافٍ. أوضاع الكتابة في Lite تعمل جميعها عبر نقطة النهاية المخصصة، مع توجيه واحد: وضع instruct يتوافق بأكبر طبيعية مع نماذج المحادثة المستضافة، لأنه ينتج التبادل المنظّم القائم على الأدوار الذي دُرّبت عليه هذه النماذج. الكتابة المشتركة للقصص التقليدية تعمل أيضاً؛ توقّع أن تتصرف النماذج كشركاء محادثة أكثر من كونها أدوات استكمال نص خام، لأن هذا هو طبيعة نقطة نهاية chat completions. ميزانية السياق تتبع نفس قاعدة كل واجهة أمامية للعب الأدوار: يعيد Lite إرسال سياق القصة المرئي في كل دور، لذا اضبط حجم السياق بتعمّد (نافذة عمل من 16K إلى 32K تغطي الجلسات الطويلة) بدلاً من رفعه للحد الأقصى لمجرد أن نافذة النموذج تسمح بذلك. دليل طول السياق المرتبط أدناه يقوم بهذا الحساب عبر النماذج.

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

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

CORS، مفتاح الوكيل (proxy)، والحفاظ على سلامة مفتاحك.

بما أن Lite يستدعي نقطة النهاية مباشرة من متصفحك، فإن فشل الاتصال بقيم صحيحة عادة ما يكون CORS: نقطة النهاية ترفض طلبات منشؤها المتصفح. يوفّر Lite مفتاح "Use CORS Proxy" لهذه الحالة بالضبط، ويستحق تحذيراً صادقاً: التوجيه عبر أي وكيل (proxy) من طرف ثالث يضع ذلك الوكيل داخل حركة بياناتك، بما فيها المفتاح ومحتوى القصة. جرّب اتصالاً مباشراً أولاً، وتأكد من عمل نقطة النهاية عبر curl إذا شككت، وعامل مفتاح الوكيل كملاذ أخير وليس افتراضاً. تشغيل نسخة Lite المرفقة من KoboldCpp محلي هو حل بديل نظيف آخر، لأن نفس إعدادات نقطة النهاية المخصصة موجودة هناك. نظافة المفتاح تهم أكثر قليلاً في تطبيق متصفح: المفتاح يجلس في إعدادات المتصفح المحلية، لذا تجنّب لصقه على أجهزة مشتركة أو عامة، وإذا تسرّب يوماً، ألغِه وأصدر آخر بدلاً من التأمل بألا يحدث شيء. المفاتيح هنا مجانية الإنشاء، لذا مفتاح مخصص لـ Lite يُبقي سجل الاستخدام مقروءاً ونطاق الضرر صغيراً. ملاحظة محتوى واحدة، بصراحة: نقطة النهاية المخصصة تغيّر إلى أين تذهب الطلبات، لا ما تسمح به النماذج. سياسات النماذج الأصلية وشروط أي نسخة من Lite تستخدمها لا تزال سارية؛ صفحة مقارنة السياسات المرتبطة أدناه تغطي المشهد بواقعية، عائلة نماذج تلو الأخرى.

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