دليل البدء السريع في واجهة برمجة التطبيقات

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

يصادق مفتاح API الخاص بك على كل طلب موجه إلى واجهة برمجة التطبيقات الخاصة بنا للنماذج اللغوية الكبيرة غير الخاضعة للرقابة. نستخدم رؤوس رموز Bearer القياسية، لذا يمكنك استبدال عنوان URL الأساسي والمفتاح الخاص بك في أي مكتبة SDK متوافقة مع OpenAI دون إعادة كتابة المنطق. تقع نقطة النهاية عند https://api.gptchatuncensored.com/v1 ويقبل طلبات POST إلى /chat/completions. يجب أن تتضمن مفتاحك في Authorization: Bearer YOUR_KEY الرأس. يعمل هذا الإعداد فورًا مع أدوات SDK الرسمية أو الحزم الطرفية الثالثة. لا نقدم ميزات التضمين أو الرؤية، لذا ركّز حمولاتك على توليد النصوص فقط. يتم خصم رصيدك فقط عند معالجة الرموز، مما يضمن تكاليف متوقعة للاستخدام غير الخاضع للرقابة عالي الحجم.

إرسال أول إكمال لك

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

Copycurl https://api.gptchatuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 200 word scene with two characters in a room"}]
  }'

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

تكوين المعلمات (temp, top_p)

تعديل temperature و top_p للتحكم في عشوائية مخرجاتك. تجعل درجة الحرارة المنخفضة الاستجابات أكثر حتمية وتركيزاً، وهو ما يُعد مثالياً للمهام البرمجية أو الواقعية. تزيد درجات الحرارة المرتفعة من الإبداع، مما يجعلها مثالية لأدوار التمثيل أو الكتابة الإبداعية. ال top_p المعامل يفلتر المفردات بناءً على الاحتمال التراكمي، مما يوفر طبقة أخرى من التحكم. يمكنك دمج هذه مع max_tokens لتحديد طول المخرجات. تعمل هذه المعاملات تماماً كما هي في واجهات برمجة التطبيقات القياسية لـ OpenAI، مما يضمن الألفة. استخدم seed لإنتاج نتائج قابلة لإعادة الإنتاج أثناء الاختبار. قم بضبط هذه الإعدادات لتطابق أسلوب النموذج غير المقيد الذي تفضله لحالة الاستخدام الخاصة بك.

Copyfrom openai import OpenAI

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

يمكن للمطورين الذين يستخدمون Python الاستفادة من المكتبة الرسمية للتكامل بسهولة. يوضح مقتطف الرمز كيفية ضبط هذه المعلمات في طلب قياسي. يمكنك تمرير قائمة من الرسائل للحفاظ على سجل المحادثة. تحترم واجهة برمجة تطبيقات LLM غير المفلترة هذه القيود بدقة. يتيح لك هذا المرونة تجربة نبرات وأنماط مختلفة دون تغيير البنية التحتية الخاصة بك.

استجابات البث

تمكين التدفق لتلقي الرموز أثناء توليدها، مما يقلل من زمن الاستجابة المُدرَك للمستخدمين. يعد التدفق ضروريًا لتطبيقات الدردشة في الوقت الفعلي أو توليد المحتوى طويل المدى. تدعم واجهة برمجة التطبيقات الخاصة بنا أحداث Server-Sent (SSE) لتوصيل البيانات بكفاءة. يجب عليك معالجة الكتلة الأخيرة للحصول على إجمالي استخدام الرمز لدقة الفوترة. تضمن واجهة برمجة التطبيقات غير الخاضعة للرقابة أن يعمل التدفق بشكل موثوق حتى للنوافذ السياقية الكبيرة. اضبط stream=True في عميل SDK الخاص بك لتفعيل هذا الوضع. يوفر هذا النهج تجربة مستخدم أكثر سلاسة لسيناريوهات الكتابة الإبداعية أو لعب الأدوار. راقب delta field لتراكم نص الاستجابة الكامل.

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)

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

معالجة الأخطاء والرفض

نادراً ما يرفض نموذجنا غير الخاضع للرقابة المحتوى، لكنه يفرض حداً صارماً على المحتوى الجنسي الذي يتضمن أطفالاً. ستتلقى رمز خطأ HTTP قياسي إذا فشل الطلب أو تجاوز الحدود. يشير رمز الحالة 401 إلى مفتاح API غير صالح أو منتهي الصلاحية، مما يتطلب منك التحقق من بيانات الاعتماد الخاصة بك. يعني رمز الحالة 402 أن رصيدك المسبق قد استنفد؛ قم بإعادة الشحن عبر المشفر للمتابعة. يشير خطأ 429 إلى أنك تجاوزت حد 300 طلب في الدقيقة. يتم توثيق هذه الأخطاء بوضوح في جسم الاستجابة. يتم تطبيق رفضات المحتوى المرتبط بالأطفال دائماً، مما يضمن الامتثال. تحقق من لوحة التحكم الخاصة بك للحصول على سجلات استخدام مفصلة لحل المشكلات بسرعة.

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

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

Node.js

Copyimport OpenAI from "openai";

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