AR ▾
احصل على مفتاح API

Uncensored Endpoint: عنوان URL الأساسي، معرف النموذج والحدود

نقطة النهاية uncensored هنا تعني واجهة برمجة نصوص مستضافة ومتوافقة مع OpenAI تجيب بدون رفض محتوى للاستخدام القانوني للبالغين. هذه الصفحة تذكر عنوان URL الأساسي الدقيق، معرف النموذج، الطرق، الحدود وأكواد الأخطاء التي تحتاجها قبل كتابة أي كود.

تم التحديث

نقاط رئيسية

  1. عنوان URL الأساسي هو https://api.uncensoredendpoint.com/v1 ومعرف النموذج الوحيد هو uncensored.
  2. طريقتان متاحتان: POST /v1/chat/completions و GET /v1/models.
  3. نافذة السياق هي 100,000 رمز، للموجّه (prompt) والإكمال معًا.
  4. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة.
رسم توضيحي ثلاثي الأبعاد لخط بيانات يربط حاسوباً بخادم API

إعدادات الاتصال نظرة سريعة

إذا كنت تحتاج القيم فقط، إليك هي. كل شيء آخر في هذه الصفحة يشرح كيف تتصرف عملياً.

الإعدادالقيمة
عنوان URL الأساسيhttps://api.uncensoredendpoint.com/v1
معرّف النموذجuncensored
رأس المصادقةAuthorization: Bearer YOUR_KEY
نقاط النهايةPOST /v1/chat/completions، GET /v1/models
نافذة السياق100,000 رمز، الموجّه بالإضافة إلى الإكمال
الحد الأقصى لجسم الطلب8 MB
حدود المفتاح الكاملة8 طلبات متزامنة، 300 طلب في الدقيقة
حدود مفتاح التجربة2 طلبات متزامنة، 60 طلبًا في الدقيقة
السعر$0.15 لكل مليون رمز إدخال، $0.50 لكل مليون رمز إخراج

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

ما يفعله كل طلب

لا يوجد سوى مسارين، مما يبقي مساحة السطح صغيرة.

  • يعيد GET /v1/models قائمة النماذج. سترى مدخلاً واحداً، uncensored. تستخدم العديد من العملاء هذا المسار لملء قائمة منسدلة للنماذج، لذا فهو أيضاً طريقة سريعة للتأكد من صحة مفتاحك وعنوان URL.
  • POST /v1/chat/completions هو العمود الفقري. يأخذ قائمة من الرسائل ويعيد الإكمال، إما كاستجابة JSON واحدة أو كدفق أحداث مرسلة من الخادم.

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

فحص سريع من طرفية:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

قائمة JSON التي تحتوي على uncensored تعني أن المفتاح يعمل. تعني استجابة HTTP 401 أن المفتاح مفقود، أو مُدخل بشكل خاطئ، أو يحتوي على مسافة زائدة أو سطر جديد فيه، وهو السبب الأكثر شيوعاً عندما يأتي المفتاح من متغير في سطر الأوامر.

طلبك الأول في curl وPython وNode

ترسل جميع الأمثلة الثلاثة نفس الشيء: رسالة نظام واحدة، ورسالة مستخدم واحدة، ودرجة حرارة منخفضة. استبدل YOUR_KEY أو اضبط متغير البيئة API_KEY.

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

مع حزمة تطوير البرمجيات الرسمية لـPython، تمرر فقط وسطين إضافيين للعميل:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredendpoint.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

وفي Node مع نفس الحزمة:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

تتضمن الاستجابة كائن usage يحتوي على أعداد رموز الموجّه والإكمال. راقبها جيداً: هذان العددان هما الأساس في الفوترة. تحمل رؤوس الاستجابة أيضاً X-Request-Id، وX-Balance-USD، وX-RateLimit-Limit-Requests، وX-RateLimit-Limit-Concurrency. سجّل معرف الطلب مع كل استدعاء، لأنه أول شيء تطلبه خدمة الدعم إذا بدا أن هناك خطأ.

البث المتدفق، استدعاء الدوال، ووضع JSON

تغطي ثلاث ميزات معظم التطبيقات الحقيقية، وجميعها تتبع أشكال OpenAI التي تعرفها بالفعل.

البث المتدفق

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

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

استدعاء الدوال

مرر tools وخيارياً tool_choice. عندما يقرر النموذج استدعاء دالة، تحصل على tool_calls في الرد (متدفق أيضاً إذا كنت تستخدم البث). تقوم بتشغيل الدالة بنفسك وإرسال النتيجة مرة أخرى كرسالة مع role: "tool". النموذج هو نموذج واحد مفتوح الأوزان، لذا اختبر مخططات الأدوات الخاصة بك مع بعض الموجّهات الواقعية واحتفظ بوصف المعلمات موجزاً.

وضع JSON

أرسل response_format: {"type":"json_object"} لطلب إخراج JSON صالح. أخبر أيضاً في الموجّه أنك تريد JSON ووصف الحقول المتوقعة. قم بالتحليل بشكل دفاعي، وأعد المحاولة مرة واحدة عند فشل التحليل بدلاً من الوثوق بالإخراج بشكل أعمى.

تمرير عناصر التحكم في أخذ العينات: temperature، وtop_p، وstop، وseed، وعقوبات التردد والوجود.

نافذة السياق 100,000 رمز في الممارسة العملية

نافذة السياق هي 100,000 رمز، وهذا الرقم يغطي الموجّه والإكمال معًا. قد يستخدم الإكمال ما يتركه الموجّه حرًا، وmax_tokens اختياري. إذا أرسلت 90,000 رمز من الموجّه، يتبقى حوالي 10,000 رمز فقط للإجابة.

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

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

نظراً لأن الفوترة تتم عن طريق الرمز (token)، فإن الطلب الذي يملأ نافذة السياق بالكامل يكلف مالاً حقيقياً مقارنة بالطلبات القصيرة. يحتوي صفحة الأسعار على المعدلات، ويمكنك حساب تكلفة أي طلب بضرب عدد رموز المدخلات في $0.15 وجمعها مع ناتج ضرب رموز المخرجات في $0.50، ثم قسمة المجموع على مليون.

حدّ المعدل وعائلة أخطاء 429

يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. المفتاح التجريبي أكثر تقييداً: 2 طلب متزامن و60 طلب في الدقيقة. عند تجاوز أي من هذه الحدود، تعود واجهة برمجة التطبيقات (API) بـ HTTP 429، ويخبرك رمز الخطأ بالحدّ الذي تم تجاوزه:

رمز الخطأالمعنىالإجراء المطلوب
rate_limitedطلبات كثيرة جداً في الدقيقةأبطئ وتوزّع المكالمات على الدقيقة
concurrencyطلبات كثيرة تعمل في وقت واحدضع الطلبات في قائمة انتظار من جانبك؛ حدّ العمليات المتوازية عند 8 (2 في التجربة)
429 مع Retry-After: 5حمل زائد مؤقتانتظر 5 ثوانٍ، ثم أعد المحاولة

أبسط دفاع هو سيمافور (semaphore) في الكود الخاص بك، بحجم مفتاحك. في Python مع asyncio، وضع asyncio.Semaphore(8) حول كل استدعاء يزيل خطأ concurrency تماماً. أضف محاولة إعادة تنفيذ تحترم رأس Retry-After وتتراجع إلى تأخير أسي قصير عندما يكون الرأس غائباً. تذكر أن البث يحتفظ بشريحة طوال مدته، لذا فإن دفعة من ثمانية بثوث طويلة ستحجب طلباً تاسعاً حتى لو كان العدد في الدقيقة منخفضاً.

الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا فإن حلقة إعادة المحاولة لا تكلفك مقابل المحاولات التي ارتدت.

ما هو النموذج، وما ليس هو

تخدم الخدمة نموذجاً واحداً مفتوح الأوزان، تستضيفه جهة مستقلة وتم ضبطه للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. ليست واجهة برمجة التطبيقات (API) الرسمية لأي مورد كبير، وليست وسيطاً (router) يختار بين موردين. يوجد نموذج واحد فقط، وهو uncensored، لذا لا يوجد خيار للاختيار بين نماذج ولا توجد طبقات أسعار للمقارنة.

الحدود واضحة. النص يدخل والنص يخرج. لا يوجد توليد صور أو صوت أو فيديو، ولا يوجد تضمينات (embeddings) ولا ضبط دقيق (fine-tuning). قاعدة المحتوى الثابتة الوحيدة هي أن محتوى الجنس الذي يتضمن القاصرين ممنوع دائماً. لا تُستخدم الموجّهات (prompts) في التدريب.

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

قبل الانتقال إلى الإنتاج

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

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

ثم اعمل من خلال قائمة قصيرة: احفظ مفتاح API في متغير بيئة أو مدير أسرار، أبداً في الكود من جانب العميل؛ سجل X-Request-Id؛ راقب X-Balance-USD حتى تتمكن من التنبيه قبل أن ينفد الرصيد؛ حدّ عدد العمال المتوازيين؛ وعالج 429 مع تأخير بدلاً من حلقة ضيقة. قائمة التحقق لإنتاج مفاتيح API تمر عبر التعامل مع المفاتيح بمزيد من التفاصيل، والوثائق يحتوي على مرجع المعلمات.

أسئلة وأجوبة

هل أحتاج إلى SDK خاص؟

لا. أي SDK أو عميل OpenAI يعمل. غيّر Base URL والمفتاح، اضبط النموذج على uncensored، ويبقى باقي كودك كما هو.

هل يمكنه توليد صور أو تضمينات (embeddings)؟

لا. واجهة برمجة التطبيقات (API) للنصوص فقط. لا يوجد توليد صور أو صوت أو فيديو، ولا يوجد تضمينات (embeddings) ولا ضبط دقيق (fine-tuning).

ماذا يحدث عند بلوغ حدّ المعدل؟

تحصل على HTTP 429. رمز الخطأ هو rate_limited عند تجاوز عدد الطلبات في الدقيقة، وconcurrency عند تشغيل طلبات متزامنة أكثر من اللازم. انتظر لحظة وأعد المحاولة.

هل هناك قاعدة محتوى صارمة؟

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

مفتاحك على بُعد استمارة واحدة

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

احصل على مفتاح APIاقرأ التوثيق