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

Uncensored LLM Online: الدردشة عبر عميل API

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

تم التحديث

نافذة طرفية تتلقى دفق فقاعات دردشة متوهجة من سحابة، تُظهر نموذج لغة كبير يُستخدم عبر عميل API

نقاط رئيسية

  1. أي عميل متوافق مع OpenAI يعمل: غيّر Base URL، اضبط المفتاح، واستخدم معرف النموذج uncensored.
  2. يعيد البث المتدفق الرموز بمجرد توليدها، ويصل الاستخدام في نهاية التدفق.
  3. تغطي نافذة 100,000 رمز الموجّه والإكمال، لذا تحتاج الدردشات الطويلة إلى التقليم في النهاية.
  4. يعني استجابة 429 إبطاء السرعة أو الانتظار؛ يوضح رمز الخطأ الحد الذي وصلته.

ابدأ برصيد تجريبي

البريد الإلكتروني وكلمة المرور، ويظهر المفتاح على الشاشة فورًا.

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

ما تحتاجه قبل البدء

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

إليك المسار بالترتيب.

  1. سجّل باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور في صفحة مفتاح API.
  2. احصل على الرصيد التجريبي بنقرة واحدة. قيمته $0.50، لا يحتاج بطاقة، ويستمر 7 أيام ومحدود لشخص واحد.
  3. انسخ مفتاحك. كل طلب يرسله كـ Authorization: Bearer YOUR_KEY.
  4. وجّه عميلك إلى الرابط الأساسي https://api.uncensoredllmonline.com/v1 واضبط النموذج على uncensored.

نقطتا نهاية متاحتان: POST /v1/chat/completions للمحادثات و GET /v1/models لعرض ما يمكن للمفتاح استخدامه.

الطلب الأول باستخدام curl

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

curl https://api.uncensoredllmonline.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a blunt, helpful writing partner."},
      {"role": "user", "content": "Pitch me a noir story set on a space station."}
    ],
    "max_tokens": 250
  }'

تحصل على كائن إكمال دردشة قياسي مع choices[0].message.content وكتلة usage. تتضمن رؤوس الاستجابة X-Request-Id، وهو مفيد إذا اتصلت بـ الدعم، وX-Balance-USD، الذي يعرض رصيدك المتبقي. للتحقق من المفتاح دون إنفاق الرموز، اتصل بـ GET /v1/models بنفس الرأس.

حلقة دردشة البث المتدفق في Python

انتظار رد كامل يبدو بطيئًا في الدردشة. تعيين stream: true يجعل الخادم يرسل الرموز عبر SSE أثناء إنتاجها، ويحول OpenAI SDK ذلك إلى مكرر. يحافظ السكربت أدناه على كامل المحادثة في قائمة، ويطبع الرموز عند وصولها، ويضيف كل إجابة حتى يتذكر النموذج السياق.

from openai import OpenAI

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

history = [
    {"role": "system", "content": "You are a direct, imaginative conversation partner."}
]

while True:
    user = input("you: ").strip()
    if user in ("", "quit"):
        break
    history.append({"role": "user", "content": user})

    stream = client.chat.completions.create(
        model="uncensored",
        messages=history,
        stream=True,
        temperature=0.9,
    )

    reply = ""
    print("bot: ", end="", flush=True)
    for chunk in stream:
        if chunk.choices and chunk.choices[0].delta.content:
            piece = chunk.choices[0].delta.content
            reply += piece
            print(piece, end="", flush=True)
        if getattr(chunk, "usage", None):
            usage = chunk.usage
    print()
    history.append({"role": "assistant", "content": reply})

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

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

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

نظرًا لأنك تدفع مقابل رموز الإدخال في كل طلب، فإن السجل الطويل هو أيضًا مصدر فاتورتك. خذ محادثة وصلت إلى 40,000 رمز من السجل، مع 500 رمز من الرد. تكلفة الإدخال هي 0.04 x $0.15 = $0.006، وتكلفة الإخراج هي 0.0005 x $0.50 = $0.00025، لذا فإن دورًا واحدًا إضافيًا يكلف حوالي $0.0063. حتى عند هذا الحجم، يغطي $20 من الرصيد أكثر من 3,000 دور. ومع ذلك، فإن التقليم يوفر المال ويحافظ على تركيز الردود.

ثلاث استراتيجيات بسيطة تعمل بشكل جيد:

  • نافذة منزلقة. احتفظ برسالة النظام وآخر N من المناقشات، واحذف الأقدم.
  • تلخيص واستبدال. عندما يتجاوز السجل عتبة، اطلب من النموذج تلخيص الجزء الأقدم، ثم احفظ التلخيص كرسالة واحدة.
  • حقائق مثبتة. احتفظ بأوراق الشخصيات وقواعد العالم أو الإعدادات في رسالة النظام ودع بقية المحادثة تمر.

اضبط max_tokens إذا أردت تقييد طول الرد. هذا اختياري، وبدونه يمكن أن يستخدم الإكمال أي شيء متبقي من النافذة.

استخدام عميل دردشة جاهز بدلاً من ذلك

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

  • نوع API: متوافق مع OpenAI، يُسمى أحيانًا مخصصًا أو إكمال الدردشة.
  • Base URL: https://api.uncensoredllmonline.com/v1. بعض العملاء يريدون المسار الكامل الذي ينتهي بـ /chat/completions، وفي هذه الحالة أضفه.
  • مفتاح API: المفتاح من حسابك.
  • النموذج: uncensored. إذا كان لدى العميل زر قائمة النماذج، فإنه يستدعي GET /v1/models ويملأه.

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

نفس الاستدعاء من Node

إذا كان مشروعك بلغة JavaScript، فإن حزمة OpenAI الرسمية تعمل بنفس الطريقة. يبث هذا المثال إلى المخرج القياسي.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredllmonline.com/v1",
  apiKey: "YOUR_KEY",
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Describe a rainy market town in three sentences." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
process.stdout.write("\n");

يعمل استدعاء الأدوات ووضع JSON (response_format مضبوط على json_object) عبر نفس الواجهة. للأدوات، عرّفها في tools، اضبط اختياريًا tool_choice، وارجع النتائج كرسائل مع دور tool. تسلّم الاستجابات المتدفقة tool_calls على أجزاء تجمعها على العميل.

حدود المعدل وما يعنيه 429

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 في الدقيقة. يمكن أن يصل حجم جسم الطلب إلى 8 MB. تخبرك الرؤوس في كل استجابة، X-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency، بالحدود الأعلى التي تنطبق على مفتاحك.

عند تجاوز حدّ المعدل، تحصل على HTTP 429، ويوضح رمز الخطأ أي حد تم تجاوزه:

  • rate_limited: عدد كبير جداً من الطلبات في الدقيقة. انتظر وأعد المحاولة.
  • concurrency: عدد كبير جداً من الطلبات في وقت واحد. تذكر أن الطلب المتدفق يحتفظ بمكانه حتى ينتهي البث، لذا فإن واجهة المستخدم التي تفتح عدة تدفقات في نفس الوقت تستنفدها بسرعة.
  • تعني استجابة 429 مع رأس Retry-After: 5 حملًا زائدًا مؤقتًا. انتظر خمس ثوانٍ، ثم أعد المحاولة.

حلقة إعادة محاولة قصيرة مع تخفيف الحمل كافية لمعظم التطبيقات. الطلبات الفاشلة أو المرفوضة لا تُحسب. عند انتهاء فترة التجربة أو انخفاض رصيدك، يمكنك شحن الرصيد بمبلغ صحيح يتراوح بين $20 و$500 باستخدام العملات المشفرة فقط (USDT على TRC20 أو USDC على Base)؛ راجع صفحة الأسعار للحصول على المكافآت.

غلاف إعادة المحاولة

إليك غلاف صغير يعيد المحاولة عند حدوث خطأ 429 باستخدام رأس Retry-After عند وجوده، وتأخير أسي عند عدم وجوده. يستخدم نوع الاستثناء الخاص بـ SDK، لذا تظهر الأخطاء الأخرى فوراً.

import time
from openai import OpenAI, RateLimitError

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

def ask(messages, tries=5):
    delay = 2
    for attempt in range(tries):
        try:
            return client.chat.completions.create(
                model="uncensored",
                messages=messages,
                max_tokens=400,
            )
        except RateLimitError as err:
            wait = err.response.headers.get("Retry-After")
            time.sleep(int(wait) if wait else delay)
            delay *= 2
    raise RuntimeError("still rate limited after retries")

إذا رأيت أخطاء concurrency بشكل متكرر، فإن الحل نادراً ما يكون زيادة التأخير. حدد عدد المكالمات التي تشغلها بالتوازي عند 8 لمفتاح كامل، أو 2 لمفتاح تجربة، باستخدام سيمافور (semaphore) أو مجموعة عمال بهذا الحجم.

الحصول على نتائج أفضل من النموذج

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

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

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

أسئلة وأجوبة

هل أحتاج إلى تثبيت أي شيء للبدء؟

فقط عميل. حزمة OpenAI لـ Python أو Node، أو curl، أو أي تطبيق دردشة يقبل نقطة نهاية متوافقة مع OpenAI سيعمل. لا حاجة لوحدة معالجة رسومات أو تنزيل النموذج.

أي معرّف نموذج أستخدم؟

استخدم uncensored في حقل النموذج. يمكنك التأكد من ذلك باستدعاء GET /v1/models بمفتاحك.

هل يكلف البث أكثر من الطلب العادي؟

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

هل تُخزن الموجّهات (prompts) الخاصة بي للتدريب؟

لا. لا تُستخدم الموجّهات للتدريب.

هل يمكن استخدامه للصور أو الصوت؟

لا. الخدمة مخصصة للنصوص فقط، بدون توليد صور أو صوت أو فيديو، وبدون تضمينات.

مفتاحك على بُعد نموذج واحد

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

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