كيفية استخدام OpenRouter على Janitor AI: إعداد الوكيل

كيفية عمل الاتصال

Janitor AI هو موقع محادثات شخصيات. بالإضافة إلى خياراته المدمجة، يتيح لك توصيل نموذجك الخاص من خلال إعداد واجهة برمجة التطبيقات. يطلب هذا الإعداد ثلاثة أشياء: عنوان URL لنقطة النهاية، ومفتاحاً، واسم نموذج. يناسب OpenRouter لأنه يعرض نقطة نهاية متوافقة مع OpenAI؛ وأسماء النماذج الخاصة به على شكل vendor/model ويأتي المفتاح من حسابك على OpenRouter.

نفس الحقول الثلاثة تعمل مع أي خدمة أخرى متوافقة مع OpenAI. واجهة هذا الموقع هي واحدة: الرابط الأساسي https://api.openrouternsfw.com/v1، ومفتاح Bearer، ومعرف النموذج uncensored. لذا تغطي الخطوات أدناه الحالتين. عندما تختلف خطوة بين الحالتين، أذكر ذلك.

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

جهّز القيم الثلاث

قبل فتح Janitor AI، اجمع هذه البيانات.

الحقل	OpenRouter	هذه واجهة برمجة التطبيقات (API)
نقطة النهاية	عنوان URL على نمط OpenAI من وثائق OpenRouter	https://api.openrouternsfw.com/v1/chat/completions
المفتاح	مفتاح API من حسابك على OpenRouter	المفتاح من صفحة مفاتيح API
اسم النموذج	معرف مزود/نموذج من قائمتهم	uncensored

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

اختبر نقطة النهاية باستخدام curl أولاً

تقدم لك Janitor AI ملاحظات قليلة عند فشل الوكيل؛ فأنت عادةً ترى خطأً عاماً في الدردشة. تحقق من نقطة النهاية خارج الموقع، لتعرف أن القيم صحيحة قبل لصقها.

Copycurl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

إجابة JSON تحتوي على مصفوفة choices تعني أن المفتاح، وURL، واسم النموذج جميعها صحيحة. اطّلع على رؤوس الاستجابة إذا أردت المزيد: يُظهر X-Balance-USD الرصيد المتبقي، وX-Request-Id مفيد إذا تواصلت مع الدعم الفني في أي وقت.

أدخل الوكيل في Janitor AI

1. افتح دردشة مع أي شخصية.
2. افتح القائمة في الدردشة واختر إعدادات الـ API أو التوليد. يختلف الاسم الدقيق حسب النسخة.
3. اختر خيار الوكيل، وهو الخيار الخاص بنقطة نهاية متوافقة مع OpenAI مخصصة، بدلاً من النموذج المدمج.
4. الصق عنوان URL لنقطة النهاية في حقل عنوان URL للوكيل.
5. الصق المفتاح في حقل المفتاح.
6. اكتب اسم النموذج بالضبط كما هو معطى: uncensored لهذه الواجهة API.
7. احفظ الإعدادات وأعد تحميل صفحة الدردشة.

شكل الرابط المستخدم هو النقطة الوحيدة التي يتعثر فيها الناس. حقل الوكيل في Janitor AI يتوقع عادةً رابط إكمال الدردشة الكامل، وينتهي بـ /chat/completions. تتوقع الأدوات الأخرى فقط الرابط الأساسي الذي ينتهي بـ /v1 وتضيف المسار بنفسها. إذا أعطى الرابط الكامل خطأ، جرّب الرابط الأساسي، والعكس صحيح. اختبار curl أعلاه يخبرك أن الرابط الكامل نفسه صالح، لذا يشير الفشل إلى كيفية بناء الموقع لطلبه، وليس إلى المفتاح.

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

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

تعرض Janitor AI بعض إعدادات التوليد بجانب حقول الوكيل. تمرر الـ API معاملات أخذ العينات، لذا يكون لها تأثير.

• Temperature: 0.7 إلى 1.0 يحافظ على حيوية الحوار. القيم الأعلى تبدأ في الانحراف وابتكار تفاصيل تتعارض مع بطاقة الشخصية.
• الحد الأقصى للرموز: يتحكم في طول الرد. قيمة تتراوح بين 300 و600 تناسب الدردشة. يمكن أن يستغرق الإكمال باقي نافذة الـ 100,000 رمز، لكن ردود الدردشة بهذا الطول نادراً ما تكون ما تريده.
• حجم السياق: تقبل الواجهة ما يصل إلى 100,000 رمز، للموجّه والإكمال. قيمة أصغر، مثل 8,000، تخفض التكلفة لكل رسالة ولا تزال تحتفظ بالكثير من السجل. ارفعها فقط إذا نسي الشخصية أشياء تحتاجها.
• التحكم في التكرار: إذا كانت الشخصية تكرر نفس العبارات، فإن عقوبة تكرار معتدلة أو وجودها تساعد. يتم تمرير كليهما.

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

التكلفة

الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. في لعب الأدوار، يكاد يكون كل التكلفة للإدخال، لأن كل رسالة تعيد إرسال بطاقة الشخصية وسجل الدردشة.

خذ رسالة تحتوي على 8,000 رمز من السياق و300 رمز للرد:

• الإدخال: 8,000 × $0.15 / 1M = $0.0012
• الإخراج: 300 × $0.50 / 1M = $0.00015
• المجموع: $0.00135 لكل رسالة، أو $1.35 لكل 1,000 رسالة

شحن الرصيد بقيمة $20 يدفع تكاليف حوالي 14,800 رسالة بهذا الحجم ($20 / $0.00135 يساوي 14,814). رصيد $0.50 التجريبي يغطي حوالي 370 رسالة. إذا رفعت نافذة السياق إلى 30,000 رمز، يرتفع الإدخال وحده إلى $0.0045 وتصبح تكلفة الرسالة $0.00465 مع نفس الرد، لذا استخدم نوافذ السياق الكبيرة فقط عندما تحتاج إليها.

تتراوح عمليات الشحن من $20 إلى $500 مع مكافآت بنسبة 5% من $50، و10% من $100 و15% من $200. الدفع بالعملات المشفرة (USDT على TRC20 أو USDC على Base)، ولا ينقضي الرصيد المسبق الدفع، ولا تُحاسَب الطلبات الفاشلة أو المرفوضة. التفاصيل موجودة في صفحة الأسعار.

استكشاف الأخطاء وإصلاحها

خطأ في الشبكة أو لا يوجد رد

تحقق من صيغة URL (المسار الكامل أو الأساسي). تحقق من عدم وجود مسافة لاحقة في حقل مفتاح API. ثم شغل اختبار curl مرة أخرى من جهازك.

HTTP 401

مفتاح API خاطئ أو تم لصقه مع أحرف إضافية. قم بإنشاء مفتاح جديد من صفحة مفاتيح API.

HTTP 429

اقرأ رمز الخطأ. يعني rate_limited أكثر من الطلبات المسموح بها في الدقيقة (300 للمفتاح الكامل، 60 لمفتاح التجربة). يعني concurrency طلبات متزامنة كثيرة جداً (8 للمفتاح الكامل، 2 لمفتاح التجربة)؛ في Janitor AI يحدث هذا عندما تعيد توليد رد بينما لا يزال السابق في وضع البث المتدفق، لأن الطلب المتدفق يحتفظ بمكانه حتى ينتهي. يعني 429 مع Retry-After: 5 حمل زائد مؤقت، لذا انتظر خمس ثوانٍ وحاول مرة أخرى.

الردود مقطوعة أو تتشعب

عدّل max_tokens وtemperature. إذا نسيت الشخصية الأحداث الأخيرة، زد حجم نافذة السياق قليلاً.

نفاد الرصيد

يُظهر الرأس X-Balance-USD ما تبقى. أضف رصيدًا من لوحة التحكم؛ وتغطي الوثائق تنسيق الأخطاء بشكل كامل.

OpenRouter أو واجهة برمجة التطبيقات هذه لـ Janitor AI

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

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

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

• بديل مجاني لـ OpenRouter؟ ما تحصل عليه فعلياً
• بوت Discord مفتوح المصدر باستخدام LLM بدون رقابة
• Hermes API: كيفية استخدام LLMs بدون رقابة في مشروعك