بديل OpenRouter لـ Janitor AI: دليل الإعداد

ما تحتاج إلى إدخاله

إذا كنت تريد بديلاً لـ OpenRouter لتطبيق Janitor AI أو تطبيق محادثة شخصيات مماثل، فإن الإعداد هو نفسه لأي مزود متوافق مع OpenAI. ابحث عن المكان في عميلك حيث تضيف API مخصصًا أو وسيطًا. تسمي التطبيقات المختلفة هذا الحقل بشكل مختلف: "proxy"، "نقطة نهاية OpenAI مخصصة"، "URL API". الحقول الموجودة أدناه هي دائمًا نفس الحقول الثلاثة.

الحقل	القيمة
URL API / URL الأساسي	https://api.openrouterapi.cc/v1
مفتاح واجهة برمجة التطبيقات	المفتاح من حسابك، يُرسل كـ Authorization: Bearer
اسم النموذج	uncensored

بعض العملاء يريدون نقطة النهاية الكاملة بدلاً من الأساس. إذا أدى حفظ URL الأساسي إلى خطأ أو 404، جرب https://api.openrouterapi.cc/v1/chat/completions. طريقتا الطلب المدعومتين هما POST /v1/chat/completions و GET /v1/models، لذا فإن العميل الذي يعرض النماذج سيستدعي الطريقة الثانية وسيقوم بعرض uncensored.

إذا لم يكن لديك مفتاح بعد، سجّل حسابك باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور واتبع تعليمات مفتاح واجهة برمجة التطبيقات. يمكن للحسابات الجديدة المطالبة برصيد تجريبي بقيمة $0.50 بنقرة واحدة، وهو ما يكفي لجلسة اختبار أولى.

اختبر الاتصال قبل إلقاء اللوم على التطبيق

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

Copycurl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

إذا عاد هذا برد، فإن نقطة النهاية والمفتاح يعملان بشكل صحيح، وأي مشكلة تكمن في إعدادات التطبيق. إذا فشل، يخبرك جسم الخطأ بالسبب. احتفظ بمعرف الطلب من رأس الاستجابة X-Request-Id؛ فهو يساعدك عند مراسلة support.

موجّه نظامي تمهيدي

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

أنت مارا فوس، المهندسة الرئيسية في السفينة كولووي.

الصوت: جاف، عملي، سريع في المزاح تحت الضغط.

اكتب بالضمير الغائب بصيغة الماضي، من 2 إلى 4 فقرات قصيرة.

لا تتحدث أو تتصرف باسم شخصية المستخدم.

الحفاظ على الاستمرارية: تتبع الإصابات والإصلاحات ومن يعرف ماذا.

ابق في القصة. جميع الشخصيات بالغة.

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

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

الإعدادات التي تعمل عادةً

هذه نقاط بداية وليست ضمانات. غيّر إعدادًا واحدًا في كل مرة وقارن بين بضع ردود.

• درجة حرارة 0.8 إلى 1.0 لحوار حيوي. انخفض إلى حوالي 0.6 إذا ابتعدت الشخصية أو تناقضت مع نفسها.
• top_p من 0.9 إلى 0.95 إذا كان عميلك يعرضه. يتم تمريره كما هو.
• عقوبات التكرار والحضور من 0.2 إلى 0.5 عندما تبدأ الردود في تكرار العبارات. القيم الكبيرة تجعل الأسلوب غريبًا، لذا حافظ على قيم منخفضة.
• max_tokens اختياري. اضبط القيمة بين 300 إلى 600 إذا كنت تريد ردودًا بطول الفقرة وليس مقالات.
• تفعيل البث المتدفق. يظهر الرد أثناء كتابته، وتحمل الشريحة الأخيرة بيانات الاستخدام حتى يتمكن عميلك من عرض عدد الرموز.
• seed يتم تمريره، وهو أمر مفيد عندما تريد مقارنة نسختين من الموجّه في نفس الجلسة.

للبث المتدفق تأثير جانبي واحد يستحق المعرفة: يحمل الطلب المتدفق فتحة التزامن الخاصة به حتى ينتهي البث. المفتاح الكامل يسمح بـ 8 طلبات في وقت واحد و300 في الدقيقة. المفتاح التجريبي يسمح بـ 2 في وقت واحد و60 في الدقيقة.

السياق، الذاكرة وتكلفة المحادثات الطويلة

نافذة السياق تتسع لـ 100,000 رمز، شاملة الموجّه والإكمال. هذا كثير من القصة: يمكن أن تتسع عشرات الآلاف من الكلمات من السجل. التكلفة تزيد مع ذلك، لأن السجل الكامل يُرسل في كل مرة. إليك مثال محسوب لجلسة طويلة.

لنفترض أن السجل وصل إلى 30,000 رمز وأن الرد 300 رمز. الإدخال: 30,000 × $0.15 / 1M = $0.0045. الإخراج: 300 × $0.50 / 1M = $0.00015. تكلفة رد واحد هي $0.00465. مائة رد بهذا الحجم تصل إلى $0.465، أي حوالي 47 سنتًا.

السجل الأقصر أرخص وغالبًا أفضل. النماذج تركز أقل على وسط الموجّهات الطويلة جدًا، لذا فإن ملخص نظيف للأحداث القديمة بالإضافة إلى آخر اثنتي عشرة رسالة يمكن أن يُقرأ بشكل أكثر اتساقًا من 30,000 رمز خام. العديد من الواجهات الأمامية تحتوي على ميزة "ملخص" أو "ذاكرة". استخدمها بمجرد تجاوز المحادثة بضع آلاف من الرموز.

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

الحفاظ على اتساق الشخصية على مدى أسابيع

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

احتفظ بكتلة ثابتة من الحقائق التي لا تتغير: الاسم، الشخصية، عادات الكلام، العلاقات. احتفظ بكتلة ثانية تقوم بتحديثها يدويًا من حين لآخر: الوضع الحالي، خيوط الحبكة المفتوحة، الوعود المقدمة. الصق كلاهما في موجّه النظام أو حقل الذاكرة في عميلك، واحافظ على كل منهما تحت حوالي 500 رمز. معًا، هذا 1,000 رمز كحد أقصى، مما يكلف $0.00015 لكل رد عند معدل المدخلات.

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

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

استكشاف أخطاء 429 والردود الغريبة

تطبيقات لعب الأدوار جيدة في تفعيل حدّ المعدل عن طريق الخطأ: تبويبان للمتصفح، زر "إعادة توليد" يُضغط مرتين، دردشة جماعية يجيب فيها عدة شخصيات في آن واحد. تستجيب واجهة برمجة التطبيقات بـ HTTP 429 وسبب واحد من هذه الأسباب.

1. رمز الخطأ concurrency. لديك طلبات قيد التنفيذ أكثر مما يسمح به مفتاحك. أغلق علامات التبويب الإضافية، أو انتظر انتهاء البث، أو أوقف ردود الشخصيات المتوازية. تذكر أن البث يشغل مكانه حتى ينتهي.
2. رمز الخطأ rate_limited. أرسلت طلبات كثيرة جدًا في الدقيقة. قلل السرعة؛ فالشخص الذي يكتب نادراً ما يتجاوز 300 طلب في الدقيقة، لكن حلقة السحب الآلية قد تصل إلى 60 على مفتاح تجريبي.
3. 429 مع رأس Retry-After: 5. الخدمة مثقلة مؤقتًا. انتظر خمس ثوانٍ وأرسل مرة أخرى.

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

أين يناسب هذا، وأين لا يناسب

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

النموذج يدعم النص فقط. لن يولد فن الشخصيات أو الصوت أو الفيديو، ولا تتوفر التمثيلات المتجهة (embeddings). أي شيء في عميلك يعتمد على هذه الميزات يحتاج إلى خدمة أخرى. لا تُستخدم الموجّهات للتدريب، والبدء السريع الكامل موجود في الوثائق.

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

• بدائل OpenRouter الأرخص: تكاليف الرموز التي عملت
• بديل OpenRouter لنماذج الذكاء الاصطناعي: واحد مقابل متعدد
• API الخاص بـ Perplexity: كيفية استخدام نماذج LLM بدون رقابة