دليل البدء السريع

الإعداد والتكوين

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

قم بتكوين متغيرات البيئة أو مررها مباشرةً إلى مُنشئ العميل. لا تحتاج إلى إدارة منطق التوجيه المعقد أو التبديل بين نماذج متعددة. يتعامل النموذج الوحيد uncensored مع جميع الطلبات.

• ثبّت الحزمة عبر مدير الحزم الخاص بك.
• اضبط مفتاح API من لوحة التحكم الخاصة بك.
• أشر إلى العميل إلى نقطة نهاية واجهة برمجة التطبيقات.

إجراء أول طلب

أرسل طلب POST إلى نقطة نهاية إكمال الدردشة مع تعيين معرف النموذج إلى "uncensored". هذا يعيد استجابة نصية مباشرة من النموذج، متجاوزًا مرشحات المحتوى القياسية. يمكنك إرسال نصوص بسيطة أو تعليمات نظام معقدة.

تقبل واجهة برمجة التطبيقات (API) معايير قياسية مثل درجة الحرارة وtop_p. استخدم أمر cURL التالي للتحقق من الاتصال وجودة الاستجابة على الفور.

Copycurl https://api.chatbotunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
  }'

تؤكد هذه الاستجابة أن النموذج نشط وجاهز لحركة الإنتاج.

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

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

تحليل شظايا 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)

تأكد من أن عميلك يتعامل مع حدث إنهاء التدفق بشكل صحيح.

استخدام الأدوات واستدعاء الوظائف

عرّف الأدوات في طلبك للسماح للنموذج بإخراج استدعاءات وظائف مهيكلة. مرر تعريفات الأدوات في مصفوفة الأدوات (tools array) وحدد خيار الأداة (tool_choice) للاختيار التلقائي. يعيد النموذج استدعاءات الوظائف في محتوى الاستجابة.

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

Copyimport OpenAI from "openai";

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

تحقق دائمًا من مخطط الإخراج قبل التنفيذ.

إدارة التوكنات والحدود

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

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يؤدي تجاوز هذه الحدود إلى تشغيل خطأ 429. حافظ على تفرد مفتاحك لكل حساب لتجنب مشاركة الحدود.

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

معالجة الأخطاء واستكشاف الأخطاء

التعامل مع أخطاء HTTP بشكل أنيق في منطق التطبيق الخاص بك. يعني رمز الحالة 401 أن مفتاح API الخاص بك غير صحيح أو منتهي الصلاحية. تحقق من لوحة التحكم الخاصة بك للتأكد من أن المفتاح نشط.

يشير الرمز 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. قم بإضافة رصيد باستخدام USDT أو USDC لاستئناف الخدمة. يشير خطأ 429 إلى أنك تجاوزت حد معدل الطلبات. انتظر وأعد المحاثة مع زيادة زمنية أسية.

ترجع أجسام الطلب غير الصالحة خطأ 400. تحقق من أن هيكل JSON الخاص بك يتطابق مع مواصفات API. هذه الأخطاء مجانية ولا تخصم من رصيدك.

Python

Copyfrom openai import OpenAI

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