AR ▾

LLM API بنموذج مفتوح الأوزان وبدون رقابة على المحتوى.

مفتاح Janitor AI API: طريقة التثبيت عبر الوكيل

لاستخدام مفتاح Janitor AI API من خدمة أخرى، تحتاج Janitor AI إلى ثلاثة بيانات: عنوان نقطة النهاية، مفتاح API، واسم النموذج. فيما يلي خطوات التثبيت وإصلاح الأخطاء الشائعة.

تحليل التكلفة والمقايضات باستخدام نموذج بدون رقابة

محدّث

مسرح صغير بتمثيليات وأقنعة وحوار متوهٍ متصل بالخادم، نمط Janitor AI

نقاط رئيسية

  1. ثلاثة حقول: عنوان نقطة النهاية، مفتاح API، واسم النموذج uncensored.

  2. اختبر المفتاح أولاً باستخدام curl لتحديد ما إذا كانت المشكلة في المفتاح أو في إعدادات Janitor AI.

  3. خطأ 404 يعني عادةً خطأ في العنوان، و401 يعني خطأ في المفتاح، و429 يعني تجاوز حدّ المعدل.

  4. السياق الأكبر يجعل كل رسالة أكثر تكلفة، لذا حدّه حسب الحاجة.

ملخص: القيم الثلاث التي يجب تعبئتها

توفر Janitor AI خياراً لربط مصدر النموذج الخاص بك عبر نقطة النهاية المتوافقة مع OpenAI. لذا، للحصول على مفتاح API الخاص بـ Janitor AI، عليك فقط تعبئة القيم الثلاث:

  • عنوان نقطة النهاية: https://api.apitanpasensor.com/v1/chat/completions
  • مفتاح API: مفتاحك من صفحة مفتاح API
  • اسم النموذج: uncensored

أسماء الأعمدة ومواقع القوائم في Janitor AI قد تتغير، لذا يشرح هذا الدليل الإعدادات بشكل عام. إذا كان المظهر مختلفاً عما تراه، اتبع الدليل الرسمي لـ Janitor AI لذلك القسم، ثم عد إلى القيم الثلاث أعلاه.

الخطوة 1: احصل على المفتاح واختبره باستخدام curl

قبل التعامل مع Janitor AI، تأكد من أن مفتاحك يعمل. بذلك، إذا ظهر خطأ لاحقاً، ستعرف أن المشكلة ليست في المفتاح. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي مجاني بقيمة $0.50 في صفحة مفتاح API بدون بطاقة، وهو كافٍ لعدة مئات من الرسائل التجريبية.

curl https://api.apitanpasensor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "Kamu adalah karakter fiksi bernama Laras, seorang penjaga mercusuar."},
      {"role": "user", "content": "Selamat malam, boleh saya masuk?"}
    ],
    "max_tokens": 200
  }'

إذا تلقيت كائن JSON يحتوي على الإجابة في choices[0].message.content، فإن المفتاح والنموذج صحيحان. تحقق أيضاً من الرأس X-Balance-USD لمعرفة الرصيد المتبقي.

الخطوة 2: املأ إعدادات الوكيل في Janitor AI

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

  1. اختر خيار الوكيل أو API المخصص، وليس النموذج المدمج.
  2. أدخل عنوان الوكيل كـ https://api.apitanpasensor.com/v1/chat/completions. تشير العديد من أدلة المجتمع إلى أن هذا الحقل يحتاج إلى العنوان الكامل حتى جزء chat completions. إذا فشل الاتصال، جرب مع وبدون الجزء الأخير.
  3. الصق مفتاح API الخاص بك في حقل المفتاح.
  4. أدخل اسم النموذج uncensored. يجب أن تكون الأحرف مطابقة تماماً.
  5. احفظ الإعدادات، ثم قم بتحديث الصفحة وأرسل رسالة تجريبية.

لا تضع كلمة "Bearer" في حقل المفتاح. التطبيقات المتوافقة مع OpenAI تضيفها تلقائياً، وإضافتها مرتين تؤدي إلى خطأ في المصادقة.

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

الأخطاء الشائعة وكيفية إصلاحها

الأعراضالسبب الأكثر احتمالاًالحل
خطأ 401 أو فشل المصادقةالمفتاح غير صحيح، أو مقطوع، أو يحتوي على مسافات في البداية أو النهايةانسخ المفتاح مرة أخرى، وتأكد من عدم وجود كلمة "Bearer"، ثم اختبره مرة أخرى باستخدام curl
خطأ 404عنوان نقطة النهاية غير صحيح، مثل الخطأ في الكتابة أو نقص الجزء /v1استخدم العنوان بالضبط كما هو أعلاه، وجرب الاختلافات مع أو بدون /chat/completions
أخطاء متعلقة بالنموذجاسم النموذج غير مطابقاكتب uncensored، بحروف صغيرة
خطأ 429 برمز concurrencyعدد كبير جدًا من الطلبات المتزامنةأغلق علامات التبويب الأخرى التي لا تزال تُنشئ إجابات
خطأ 429 مع الرمز rate_limitedتجاوز حد الطلبات في الدقيقةانتظر قليلاً، ثم أعد الإرسال
توقفت الإجابة أو فشلت تماماًنفد الرصيد أو أصبح السياق كبيراً جداًتحقق من الرصيد عبر رأس X-Balance-USD أو GET /v1/balance، وقلّل حجم السياق

بالنسبة لمفتاح الاختبار، الحد هو طلبان متزامنان و60 في الدقيقة. بالمفتاح الكامل، 8 متزامنة و300 في الدقيقة. عندما تكون API مشغولة، قد ترد أيضاً بـ 429 مع رأس Retry-After: 5، مما يعني المحاولة مرة أخرى بعد خمس ثوانٍ. تظل الإجابة التي لا تزال تتدفق (streaming) تشغل فتحة واحدة حتى الانتهاء.

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

إذا كانت الاستجابة بطيئة أو منقطعة

بعض المشكلات ليست بسبب المفتاح، بل بسبب طريقة سير المحادثة. تحقق من النقاط التالية بالترتيب:

  • علامات تبويب نشطة متعددة: كل إجابة قيد التدفق تشغل شريحة طلب متزامن واحدة. مع مفتاح الاختبار، هناك شريحتان فقط، لذا فإن ثلاثة علامات تبويب في وقت واحد قد تحفز بسهولة خطأ 429.
  • إجابة طويلة جداً: الإجابات الطويلة تستغرق وقتاً أطول. قيّد طول الإجابة في إعدادات Janitor AI.
  • السياق كبير جداً: الموجّهات الطويلة جداً تجعل الاستجابة الأولية أبطأ وتزيد الفاتورة.
  • شبكتك: حاول تشغيل curl من نفس الكمبيوتر. إذا كان curl يعمل بسلاسة ولكن Janitor AI لا، فالمشكلة في إعدادات جانب Janitor AI، وليس في API.

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

ضبط السياق والتكلفة لكل رسالة

في كل مرة ترسل فيها رسالة، ترسل Janitor AI جزءاً من سجل المحادثة إلى API. كلما زاد السياق الذي تسمح به، زادت الرموز (tokens) الداخلة التي يتم احتساب تكلفتها. الحد الأقصى لنافذة السياق هنا هو 100,000 رمز (الموجّه زائد الإجابة)، ولكن نادراً ما تحتاج أي محادثة إلى ذلك الحجم.

مثال حسابي بأسعار $0.15 لكل مليون رمز مدخل (1,000,000) و$0.50 لكل مليون رمز مخرج (1,000,000):

  • سياق 8,000 رمز وإجابة 400 رمز: 8,000 × 0.15 / 1,000,000 = $0.0012، زائد 400 × 0.50 / 1,000,000 = $0.0002. إذن $0.0014 لكل رسالة.
  • مائة رسالة من هذا النوع: 100 × $0.0014 = $0.14.
  • مع سياق 2,000 رمز وإجابة نفسها، التكلفة هي $0.0003 + $0.0002 = $0.0005 لكل رسالة، أو $0.05 لمائة رسالة.

بالنسبة للشخصيات ذات الخلفية الطويلة، يكون حجم السياق المتوسط (بضعة آلاف من الرموز) كافياً عادةً. زد الحجم فقط عندما تبدأ الشخصية في نسيان الأمور المهمة. يوجد مناقشة أكثر تفصيلاً للتكلفة في صفحة الأسعار.

إعدادات التوليد المفيدة

تمرر API معاملات أخذ العينات القياسية، لذا ستصل إعدادات Janitor AI إلى النموذج: temperature، top_p، stop، seed، وعقوبة التكرار. بعض النقاط الأساسية:

  • درجة الحرارة: تبدأ من قيمة متوسطة. زد القيمة قليلاً إذا بدا أن رد الشخصية جامد، وقللها إذا بدأت الشخصية في الخروج عن الموضوع.
  • عقوبة التكرار: زد القيمة قليلاً إذا كان النموذج يكرر نفس العبارات في كل رد.
  • طول الإجابة: حدّه باستخدام max_tokens إذا كانت الردود طويلة جداً. تساعد هذه الإعدادات في توفير التكاليف أيضاً، لأن رموز الإخراج أكثر تكلفة.
  • البذرة (Seed): مفيدة عندما تريد الحصول على نفس النتائج عند اختبار الموجّهات (prompts) للشخصيات.

غيّر إعداداً واحداً في كل مرة، ثم قارن بين عدة ردود. تغيير ثلاثة أشياء في وقت واحد يجعلك لا تعرف أيها كان له الأثر.

يتم إعادة إرسال وصف الشخصية، وأمثلة الحوار، والرسالة الافتتاحية مع كل رسالة تقريباً، لذا فإن الطول يؤثر مباشرة على التكلفة. تضيف الشخصية ذات الوصف المكون من 3000 رمز تكلفة 3000 × 0.15 / 1,000,000 = $0.00045 إلى كل رسالة. للألف رسالة، يصبح ذلك $0.45، مبلغ صغير، لكن يمكنك توفيره بكتابة وصف أكثر إيجازاً.

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

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

المحتوى والقيود المعمول بها

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

هذه الخدمة مخصصة للنصوص فقط. إذا كانت بطاقات الشخصيات في Janitor AI تستخدم الصور، فإن الصور لا يتم إنشاؤها بواسطة هذا الـ API. بخصوص البيانات، لا يتم استخدام الموجّهات (prompts) الخاصة بك لتدريب النموذج، كما هو موضح في صفحة الخصوصية.

دلائل أخرى

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

هل أحتاج إلى بطاقة للاختبار؟

لا. يمكن للمستخدمين الجدد الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة في صفحة مفتاح API، بدون بطاقة. الرصيد صالح لمدة 7 أيام.

ما اسم النموذج الذي يجب أن أضعه في Janitor AI؟

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

لماذا يظهر خطأ 404 بعد ملء العنوان؟

عادةً ما يكون العنوان غير متطابق. استخدم https://api.apitanpasensor.com/v1/chat/completions أو حاول بدون الجزء chat/completions إذا كانت Janitor AI تضيفه تلقائيًا.

ما معنى الخطأ 429؟

لقد تجاوزت الحدّ. يشير رمز concurrency إلى وجود طلبات متزامنة كثيرة جدًا، بينما يشير rate_limited إلى كثرة الطلبات في الدقيقة. انتظر قليلًا ثم حاول مجددًا.

كيف يمكنني الدفع بعد انتهاء رصيد التجريبية؟

اشحن الرصيد بدءًا من $20 حتى $500 باستخدام USDT على شبكة TRC20 أو USDC على شبكة Base. الرصيد لا ينتهي صلاحيته.

مفتاحك يحتاج خطوة واحدة فقط

أنشئ حسابًا، وانسخ المفتاح، وعدّل عنوان URL الأساسي. هذه هي عملية الإعداد بأكملها.