توثيق واجهة برمجة التطبيقات

المصادقة وعنوان URL الأساسي

استخدم مفتاح API الخاص بك للمصادقة على كل طلب. تتوافق واجهة برمجة التطبيقات لدينا بالكامل مع نظام OpenAI SDK، لذا لا تحتاج سوى إلى تعديل عنوان URL الأساسي والمفتاح في تكوين العميل الخاص بك. عنوان URL الأساسي هو HTTPS://api.nocensoraichatbot.com/v1. يمكنك إنشاء مفتاح فوراً بعد التسجيل باستخدام Google أو البريد الإلكتروني. يحتوي كل حساب على مفتاح نشط واحد يحل محل المفتاح السابق عند إعادة توليده. لا يتطلب التسجيل إدخال رقم الهاتف، ولا تُستخدم نصوصك للتدريب.

الطلب الأول

أرسل طلب إكمال محادثة قياسي إلى نقطة النهاية /v1/chat/completions. استخدم معرف النموذج "uncensored" للوصول إلى نموذج اللغة الكبير المُعدّل لدينا. يستجيب النموذج للمواضيع القانونية للبالغين، والخيالية، والمثيرة للجدل دون الرفض القياسي. يوجد حد صارم: يتم رفض المحتوى الذي يتضمن القاصرين دائمًا. يمكنك اختبار الاتصال باستخدام أمر curl بسيط.

Copycurl https://api.nocensoraichatbot.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 400 word review of the new gpu"}]
  }'

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

تكامل مكتبة Python

ثبّت الحزمة الرسمية لـ Python الخاصة بـ OpenAI واعدد عنوان URL الأساسي ليشير إلى خدمتنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل client.chat.completions.create. اضبط النموذج على "uncensored" ومرر رسائل النظام أو المستخدم كما هو معتاد. تتولى حزمة التطوير (SDK) الترميز (tokenization) وتحليل الاستجابة تلقائياً. تعمل هذه الطريقة في كل من توليد النصوص البسيط والمحادثات متعددة الأدوار المعقدة. يمكنك أيضاً تدفق الاستجابات (streaming) إذا كنت تفضل المخرجات التدريجية.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.nocensoraichatbot.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)

تأكد من تمرير مفتاح API الخاص بك في الرأس أو متغير البيئة. تدعم SDK جميع المعاملات القياسية مثل درجة الحرارة و top_p. يمكنك ضبط هذه القيم للتحكم في الإبداع أو الحتمية. نافذة سياق النموذج هي 100,000 رمز للسياق والإكمال معاً.

تكامل Node SDK

استخدم حزمة @openai/openai npm للتكامل مع تطبيق Node.js الخاص بك. قم بتكوين عنوان URL الأساسي ومفتاح API قبل إجراء أي استدعاءات. يضمن ذلك التوافق مع واجهة برمجة تطبيقات روبوت الدردشة بالذكاء الاصطناعي غير المقيد. توفر حزمة Node تعريفات الأنواع ودعم async/await للتطوير الحديث. يمكنك إرسال الرسائل واستقبال الاستجابات تمامًا كما هو الحال مع أي نقطة نهاية متوافقة مع OpenAI. معالجة الأخطاء مدمجة، لذا يمكنك التقاط أخطاء 401 و402 و429 بسهولة. هذا يجعلها مثالية لوظائف الخوادم الخالية من الخوادم أو خدمات الخلفية.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.nocensoraichatbot.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);

تذكر أن معرّف النموذج هو "uncensored". لا تستخدم معرفات GPT-3.5 أو GPT-4. تتولى مكتلة SDK الباقي، بما في ذلك تحليل JSON ومنطق إعادة المحاولة. يمكنك أيضًا تمكين التدفق لتجارب المستخدم في الوقت الفعلي.

دعم أحداث الإرسال الخادم (SSE) للبث

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

Copystream = 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)

التعامل مع أحداث SSE بعناية لتجنب تسرب الذاكرة في الاتصالات طويلة الأمد. يدعم API ما يصل إلى 8 طلبات متزامنة لكل مفتاح. يساعد هذا الحد في الحفاظ على الاستقرار تحت الحمل. يمكنك تعديل سلوك التدفق باستخدام المعاملات القياسية مثل max_tokens وstop sequences.

حدود المعدلات ونافذة السياق

تفرض الـ API حدًا قدره 300 طلب في الدقيقة لكل مفتاح. يمكنك إجراء 8 طلبات نشطة في وقت واحد. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. نافذة السياق هي 100,000 رمز، مما يجمع بين السياق والإكمال. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب، أو 2,048 إذا لم يتم تعيين max_tokens. إذا تجاوزت حد معدل الطلب، ستتلقى خطأ 429. انتظر وأعد المحاولة باستخدام التراجع الأسي. يتم احتساب الرسوم للرموز الناجحة فقط. لا تستهلك الأخطاء الرصيد. يضمن هذا نموذج التسع الشفاف معرفة المبلغ الذي تدفعه بالضبط.