ar ▾
احصل على مفتاحك

uncensoredroleplayai.com/الوثائق

البدء السريع لواجهة برمجة تطبيقات الذكاء الاصطناعي غير المقيد

احصل على مثيل AI للتمثيل الأدوار غير خاضع للرقان يعمل في دقائق باستخدام واجهة برمجة التطبيقات الخاصة بنا المتوافقة مع OpenAI. استخدم مكتبات SDK القياسية لإرسال النص واستقبال استجابات طويلة السياق بدون مرشحات المحتوى.

المتطلبات الأساسية لإعداد عنوان URL الأساسي

ابدأ بتسجيل حساب عبر Google أو البريد الإلكتروني في صفحة المفتاح. يظهر مفتاح API الخاص بك على الفور ويعمل كاعتماد وحيد لجميع الطلبات. عنوان URL الأساسي للخدمة هو https://api.uncensoredroleplayai.com/v1, الذي يعمل مع أي عميل متوافق مع OpenAI.

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

المصادقة بمفاتيح API

تضمين مفتاح API الخاص بك في Authorization رأس الصفحة كرمز حامل (Bearer token). يجب أن يحمل كل طلب هذا الرأس لمصادقة هويتك. إذا كان المفتاح مفقودًا أو غير صالح، يعيد الخادم خطأ 401 غير مصرح به. تحقق من لوحة تحكم حسابك إذا كنت تشك في إلغاء المفتاح.

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

إرسال أول إكمال دردشة لك

أرسل طلب POST إلى /v1/chat/completions النقطة النهائية. مرر اسم النموذج uncensored وإhistory محادثتك في messages مصفوفة. تعيد النظام استجابة نصية بدون تصفية لمواضيع البالغين القانونيين.

  • حدد النموذج إلى uncensored.
  • أدرج مطالبة النظام لتحديد شخصية لعب الأدوار.
  • أرسل رسائل المستخدم لدفع السرد نحو الأمام.

تحقق من أن هيكل الاستجابة يحتوي على النص المولد. هذا يؤكد أن تكاملك يعمل بشكل صحيح مع واجهة برمجة التطبيقات (API) لنموذج لغوي كبير (LLM) غير خاضع للرقابة.

معالجة استجابات التدفق

فعّل البث عن طريق تعيين stream إلى true في طلبك. ترسل الواجهة البرمجية أجزاء عبر أحداث الأحداث المرسلة عبر الخادم (SSE). يحتوي كل جزء على نص جزئي وبيانات وصفية. قم بمعالجة هذه الأجزاء في الوقت الفعلي لعرض الاستجابة أثناء توليدها.

تظهر تفاصيل استهلاك الرموز في الشريحة الأخيرة. هذا يسمح لك بتتبع التكاليف بدقة دون انتظار انتهاء الاستجابة بأكملها. التدفق مثالي لروبوتات لعب الأدوار حيث يهم زمن الاستجابة. استخدم مكتبة Node SDK للتعامل السهل مع هذه الأحداث.

تكوين المعلمات لـ roleplay

اضبط معلمات مثل temperature و top_p للتحكم في الإبداع. تنتج درجات الحرارة الأعلى مخرجات أكثر تنوعاً وغير متوقعة. استخدم stop تسلسلات لإنهاء الاستجابة عند عبارات محددة. يتوفر وضع JSON عبر response_format لبيانات مُهيّأة.

تعيين max_tokens للتحكم في طول المخرجات. القيمة الافتراضية هي 2,048 رمزاً، ولكن يمكنك طلب ما يصل إلى 16,000. يدعم نافذة السياق 100,000 رمز إجمالاً. يسمح هذا باستمرارية النصوص الطويلة دون فقدان السياق. قم بضبط هذه الإعدادات حسب حالة الاستخدام المحددة لديك.

فهم استخدام وتسعير الرموز المميزة

الأسعار شفافة: 0.15 دولار لكل مليون رمز إدخال و0.50 دولار لكل مليون رمز إخراج. الأخطاء والرفضات مجانية. الرصيد مسبق الدفع ولا ينتهي. قم بالإيداع عبر العملات المشفرة باستخدام USDT (TRC20) أو USDC (Base).

تشمل الحدود 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. حجم جسم الطلب محدود بـ 8 ميجابايت. إذا نفد رصيدك، ستتلقى خطأ 402 مطلوب الدفع. راقب استخدامك عبر لوحة التحكم لتجنب الانقطاعات.

cURL

curl https://api.uncensoredroleplayai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
  }'

Python

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

التدفق

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
01

الأسئلة التقنية الشائعة

ما هي حد سياق الذكاء الاصطناعي غير الخاضع للرقابة لألعاب الأدوار؟

يدعم نافذة السياق 100,000 رمز لكل من النص البرمجي والإكمال. يمكنك إخراج ما يصل إلى 16,000 رمز لكل طلب. يتيح ذلك سرد القصص طويلة المدى دون فقدان السياق. لا تزال الرفضات المتعلقة بالمحتوى الجنسي البسيط سارية.

كيف أتعامل مع أخطاء المصادقة؟

يشير خطأ 401 إلى مفتاح API غير صالح أو مفقود. تحقق من لوحة حسابك للتأكد من أن المفتاح نشط. قم بإنشاء مفتاح جديد إذا تم إلغاء سريان المفتاح القديم. يحتفظ كل حساب بمفتاح نشط واحد في كل مرة.

ماذا يحدث إذا تجاوزت حد معدل الطلب؟

ستتلقى خطأ 429 Too Many Requests. الحد هو 300 طلب في الدقيقة و 8 طلبات متزامنة. انتظر بضع ثوانٍ قبل إعادة المحاولة. راقب استخدامك للبقاء ضمن الحدود.

استرجاع مفتاح الواجهة البرمجية الخاص بك

سجّل الدخول، وانسخ الرمز المميز، وحدّث النقطة النهائية. هذه هي التكوين بأكمله.