الرئيسية/الأسئلة الشائعة
أسئلة شائعة حول Uncensored API
إجابات موجزة ومباشرة لأسئلة المطورين قبل وبعد ربط Uncensored API: كيف تعمل المفاتيح، ماذا يشمل العرض التجريبي، ما هي الحدود المطبقة، كيف يتم حساب الفواتير، ما هو المحتوى المسموح به، وكيفية إصلاح عدد قليل من الأخطاء التي قد تواجهها في اليوم الأول من التكامل.
تم التحديث
نقاط رئيسية
- نموذج واحد، مفتاح واحد لكل حساب، للنصوص فقط، مع نافذة سياق بحجم 100,000 رمز.
- السعر هو $0.25 للإدخال و$1.00 للإخراج لكل مليون رمز (token) على رصيد مسبق الدفع لا ينتهي.
- تحصل الحسابات الجديدة على رصيد تجريبي بقيمة 0.50 دولار لمدة 7 أيام دون إدخال تفاصيل الدفع.
- المحتوى البالغ القانوني مسموح به؛ بينما يتم حظر محتوى البالغين الجنسي الذي يتضمن قاصرين دائماً برمز 403.
الأساسيات
ما هو Uncensored API في جملة واحدة؟
إنه نقطة نهاية لإكمال الدردشة النصية المدفوعة التي تخدم نموذجاً واحداً، معرفه uncensored، ولا ترفض المحتوى البالغ القانوني، أو الخيال، أو المواضيع المثيرة للجدل.
أي URL يجب أن اتصل به؟
استخدم https://api.uncensoredapis.com/v1 كـ Base URL. تذهب طلبات الدردشة إلى POST /v1/chat/completions وقائمة النماذج موجودة في GET /v1/models. أي مسار آخر يعيد 404.
هل يجب أن أتعلم SDK جديدًا؟
لا. تتوافق أشكال الطلب والاستجابة مع اتفاقية إكمال الدردشة الشائعة، لذا تعمل الحزم الرسمية لـ Python و Node.js بمجرد تغيير Base URL والمفتاح. يعمل curl العادي أيضًا، كما يُظهر التوثيق.
هل هناك طريقة لتجربته قبل الدفع؟
نعم. تحصل حساب جديد على رصيد تجريبي بقيمة 0.50 دولار، صالح لمدة 7 أيام، ولا تُطلب تفاصيل الدفع عند تسجيل الدخول. سجّل باستخدام بريد إلكتروني وكلمة مرور على صفحة المفتاح وسيظهر المفتاح فوراً.
هل يمكنني الاختيار بين عدة نماذج؟
لا. هناك نموذج واحد بالضبط، ومعرفه هو uncensored. يعيد استدعاء مسار النماذج هذا الإدخال الوحيد، لذا لا يوجد شيء للاختيار أو التبديل بينه.
لمن يُقصد بهذه الخدمة؟
المطورون الذين يبنيون منتجات للبالغين، بما في ذلك أدوات الخيال، وتطبيقات لعب الأدوار، ومساعدات البحث. أنت مسؤول عن فحوصات العمر الخاصة بك وقواعد المحتوى في أي شيء تطلقه فوق ذلك.
المفاتيح والوصول
كم عدد المفاتيح التي يحصل عليها الحساب؟
واحد. إذا كنت بحاجة إلى قيمة جديدة، أعد إنشائه من الحساب؛ سيتوقف المفتاح السابق عن العمل في نفس اللحظة، لذا قم بنشر الاستبدال على الفور.
أين يجب أن يعيش المفتاح؟
احتفظ به في متغير بيئة أو مدير أسرار على خادم تتحكم فيه. يمكن فحص JavaScript في المتصفح والبرمجيات الثنائية للجوال، لذا قم بتوجيه حركة مرور العميل عبر الخلفية الخاصة بك بدلاً من تضمين المفتاح.
كيف يُرسل المفتاح؟
في رأس Authorization: Bearer في كل طلب. يعيد القيمة المفقودة أو الخاطئة 401 مع كائن خطأ JSON.
أريد مفتاح API بدون رقابة لفريق. هل يمكننا مشاركة واحد؟
يمكنك، لكن كل عملية تشارك نفس السماح بـ 300 طلب في الدقيقة ونفس الرصيد. ضع بوابة صغيرة أمام المفتاح وامنح كل زميل وصولاً إلى البوابة بدلاً من المفتاح نفسه.
الحدود والتسعير
ما هو حجم الموجّه الكبير؟
نافذة السياق هي 100,000 رمز، مشتركة بين الموجّه والإكمال. لا يجوز أن يتجاوز جسم الطلب الفردي 8 ميجابايت. يُرفض الطلب الذي سيكون فيه الموجّه زائد max_tokens يتجاوز النافذة برمز 400.
كم يمكن أن يكون الرد طويلاً؟
الافتراضي هو 2048 رمز. يمكنك رفع max_tokens إلى 32,000 كحد أقصى لكل طلب. عندما يتوقف الجواب بسبب الحد، يقرأ finish_reason length.
كم يكلف الأمر؟
رموز الإدخال هي 0.25 دولار لكل مليون ورموز الإخراج هي 1.00 دولار لكل مليون. الرصيد مسبق الدفع، لا يوجد اشتراك، والرصيد لا ينتهي. انظر صفحة التسعير للجدول.
هل يمكنك تقديم تقدير سريع؟
افترض دورة دردشة مع 1,500 رمز موجّه و300 رمز إكمال، فقط كمثال. هذا هو 0.000375 دولار للإدخال زائد 0.0003 دولار للإخراج، أو حوالي 0.000675 دولار لكل دورة، لذا يشتري 1 دولار حوالي 1,480 دورة مماثلة.
ماذا يحدث عندما أرسل الكثير من الطلبات؟
يمكن لكل مفتاح إجراء 300 طلب في الدقيقة. بعد ذلك تحصل على 429، والاستجابة الصحيحة هي إبطاء السرعة وإعادة المحاولة مع تأخير.
أسئلة التكامل
ما هي معلمات العينات التي يمكنني تعيينها؟
تُمرَّر القيم القياسية مثل temperature و top_p و stop إلى عملية التوليد. اضبطها في جسم الطلب بنفس الطريقة التي تستخدمها في أي مكان آخر.
هل يتذكر الـ API المحادثات السابقة لي؟
لا. كل طلب مستقل، لذا عليك إعادة إرسال المحادثة في messages في كل مرة. اقتطع أقدم المحادثات عندما يقترب المجموع من نافذة الـ 100,000 رمز.
هل يمكنني بث الرموز إلى متصفح؟
نعم، أرسل stream: true واقرأ أحداث الإرسال من الخادم (SSE). قم بذلك من الخلفية (backend) ثم بعّث النص إلى الصفحة، بحيث لا يصل المفتاح إلى العميل أبداً.
هل يتم دعم رسالة النظام؟
نعم. ضع رسالة ذات الدور system في بداية المصفوفة لتحديد نبرة المحادثة وتنسيقها وحدودها.
ماذا يجب أن أفحص أولاً عندما يبدو المخرج مقطوعاً؟
اقرأ finish_reason. قيمة length تعني الوصول إلى الحد الأقصى، لذا ارفع max_tokens أو اختصر الموجّه. يدرج المصدر جميع القيم.
الرصيد والفواتير
كيف أضيف أموالاً؟
قم بشحن رصيدك المسبق الدفع من حسابك. لا يوجد اشتراك، والرصيد غير المستخدم يبقى متاحاً لأنه لا ينتهي.
ماذا يحدث عندما ينفد رصيد التجربة المجاني؟
رصيد التجربة المجاني صالح لمدة 7 أيام. بعد إنفاقه أو انتهاء صلاحيته، تُعيد الطلبات إرجاع 402 مع الكود no_credit حتى تقوم بشحن الرصيد.
هل يمكنني معرفة تكلفة الطلب؟
يحتوي كل استجابة على كتلة usage تتضمن رموز الموجّه، والإكمال، والمجموع. اضربها في الأسعار لكل مليون رمز للحصول على الشحنة، واحتفظ بسجل خاص بك إذا أردت دفتر حسابات.
هل الطلبات الفاشلة مجانية لإعادة المحاولة؟
يُسمح بإعادة المحاولة، لكن حدّدها. استخدم تأخيراً قصيراً للرموز 429 و 503 ولا تكرر الحلقة على 400، 401، 402 أو 403، لأنها لن تصلح نفسها. يحتوي دليل الأخطاء على سياسة جاهزة.
المحتوى والسلوك
ماذا لن يفعل النموذج؟
المحتوى البالغ القانوني لا يُرفض، وكذلك الخيال والمواضيع الجدلية. الاستثناء الوحيد هو أي محتوى جنسي يتضمن قاصرين، والذي يتم حظره برمز 403 في كل مرة، بما في ذلك في القصص ولعب الأدوار. الخدمة مخصصة للبالغين الذين تبلغ أعمارهم 18 عاماً فأكثر.
هل تُستخدم موجّهاتي لتدريب نموذج؟
لا. لا تُستخدم الموجّهات للتدريب.
كيف يختلف هذا عن التوجيه عبر مجمع؟
يقوم المجمع بإحالتك إلى العديد من النماذج، لكل منها قواعده الخاصة. هذه الخدمة هي نموذج واحد خلف سياسة واحدة. يشرح دليل OpenRouter غير الخاضع للرقابة هذا المقارنة بالتفصيل.
هل يمكنه رؤية الصور أو إنشاء تضمينات (embeddings)؟
لا. يتعامل مع النصوص فقط، بدون تضمينات، صور، صوت، فيديو أو ضبط دقيق.
استكشاف الأخطاء وإصلاحها
أحصل على خطأ 402 مع no_credit. ماذا أفعل الآن؟
لقد استُنفد رصيدك أو انتهت صلاحية التجربة. قم بشحن الرصيد المسبق وأرسل الطلب مرة أخرى.
يعيد الطلب رمز 503 upstream_busy.
هذا مؤقت. انتظر بضع ثوانٍ وأعد المحاولة، مستخدماً تأخيراً متزايداً وبعض العشوائية إذا كنت تشغل العديد من العمال.
ينتهي البث الخاص بي ولا أجد عدد الرموز.
عند تفعيل البث المتدفق، تُضاف قطعة نهائية تحتوي على usage تلقائياً، مباشرة قبل data: [DONE]. قائمة choices الخاصة به فارغة، لذا تحقق من ذلك قبل الفهرسة.
هل تعمل الأدوات واستدعاء الدوال؟
نعم، بالتنسيق القياسي: مرر مصفوفة tools وابحث عن tool_calls في الرد.
أسئلة وأجوبة
ماذا يتضمن العرض التجريبي المجاني؟
الحسابات الجديدة تحصل على رصيد تجريبي مجاني بقيمة $0.50 صالح لمدة 7 أيام، دون الحاجة إلى تفاصيل الدفع. سجّل الدخول باستخدام بريد إلكتروني وكلمة مرور وسيظهر مفتاح API فوراً.
ما هي حدود الطلب؟
السياق هو 100,000 رمز للموجّه والإكمال، والحد الأقصى الافتراضي لـ max_tokens هو 2048 ويصل إلى 32,000، والأجسام محدودة بـ 8 ميجابايت، ويمكن لكل مفتاح إرسال 300 طلب في الدقيقة.
كم يكلف ذلك؟
تبلغ تكلفة المدخلات $0.25 لكل مليون رمز وتكلفة المخرجات $1.00 لكل مليون رمز، وتخصم من رصيد مسبق الدفع بدون اشتراك لا ينتهي.
هل يُسمح بالمحتوى البالغ؟
المحتوى البالغ القانوني، الخيال والمواضيع الجدلية لا تُرفض، للمستخدمين الذين تبلغ أعمارهم 18 عاماً فأكثر. المحتوى الجنسي الذي يتضمن قاصرين يتم حظره دائماً برمز 403.
هل تُستخدم الموجّهات للتدريب؟
لا، لا تُستخدم الموجّهات للتدريب.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.
