كيفية تكامل API الخاص بـ Uncensored AI

لماذا تختار API الخاص بـ Uncensored AI؟

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

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

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

إعداد بيئة العمل

يبدأ التكامل بتوجيه SDK المتوافق مع OpenAI إلى عنوان URL الأساسي الصحيح. نقطة النهاية مستضافة في https://api.uncensoredai.top/v1. هذا يعني أنه يمكنك استخدام مكتبات Python أو Node.js الرسمية الخاصة بـ OpenAI دون إعادة كتابة منطق العميل. تحتاج فقط إلى تحديث معلمة base_url وتقديم مفتاح API الخاص بك.

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

• توافق SDK: يعمل مع أي عميل يتكلم بروتوكول إكمال الدردشة الخاص بـ OpenAI.
• نافذة السياق: 100k رمز إجمالي (مدخل + مخرج).
• الحد الأقصى للإخراج: 16k رمز لكل طلب.

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

المصادقة والرؤوس

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

للمصادقة على طلب، قم بتضمين الرأس: Authorization: Bearer YOUR_API_KEY. توفر الخدمة أيضًا نقطة نهاية GET /v1/models، التي تُرجع معلومات النموذج المتاحة، بما في ذلك معرف النموذج uncensored. هذا مفيد للتحقق من الاتصال قبل إرسال حمولات معقدة.

حدّ المعدل:

• 300 طلب في الدقيقة لكل مفتاح.
• 8 طلبات متزامنة في نفس الوقت لكل مفتاح.
• 8 ميجابايت كحد أقصى لحجم جسم الطلب.

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

إرسال طلب الإكمال الأول الخاص بك

يتبع الطلب الأساسي تنسيق إكمال الدردشة القياسي. ترسل حمولة JSON مع تعيين model إلى uncensored ومصفوفة messages الخاصة بك. تُرجع الخدمة استجابة نصية. لا توجد نقاط نهاية للتضمينات أو الرؤية أو الصوت—هذا API للنص الخالص.

مثال الطلب:

يوضح التالي إكمال الدردشة القياسي. استبدل YOUR_API_KEY بمفتاحك الفعلي.

Copycurl https://api.uncensoredai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

ستحتوي الاستجابة على النص المُولّد في choices[0].message.content. تُرجع الأخطاء بتنسيق HTTP القياسي، مما يتيح لك معالجة إعادة المحاولة أو الفشل بسلاسة. لاحظ أن الأخطاء لا تستهلك رصيدك، لذا يمكنك الاختبار بحرية.

للمطوِّرين الملمين بـ OpenAI، التجربة متطابقة. الفرق الوحيد هو عنوان URL الأساسي وسلوك النموذج فيما يتعلق بفلاتر المحتوى. يقلل هذا الاتساق من منحنى التعلم للفرق التي تستخدم بالفعل أدوات متوافقة مع OpenAI.

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

يتم دعم البث المتدفق عبر أحداث Server-Sent Events (SSE). يتيح لك ذلك استقبال الرموز (tokens) بمجرد توليدها، مما يوفر تجربة مستخدم أفضل للاستجابات الطويلة. نقطة النهاية الخاصة بالبث هي نفسها نقطة النهاية غير المتدفقة؛ ما عليك سوى تعيين stream: true في طلبك.

فوائد البث المتدفق:

• تقليل زمن الاستجابة المدرك للمستخدمين.
• القدرة على عرض النتائج الجزئية في الوقت الفعلي.
• استخدام فعال للذاكرة حيث تتم معالجة الرموز تدريجيًا.

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

مثال الكود:

Copyfrom openai import OpenAI

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

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

الميزات المتقدمة: وضع JSON والأدوات

يدعم الـ API المخرجات الهيكلية عبر تعيين response_format إلى {"type": "json_object"}. هذا يجبر النموذج على إرجاع JSON صالح، وهو أمر ضروري للتكامل مع أنظمة البرمجيات الأخرى. هذه الميزة مفيدة بشكل خاص لاستخراج البيانات أو توليد ملفات التكوين.

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

المعلمات الرئيسية:

• temperature: يتحكم في العشوائية.
• top_p: يتحكم في التنوع.
• stop: يحدد تسلسلات التوقف.
• seed: للاستجابات الحتمية.

هذه الميزات تجعل الـ API مناسبًا لتطبيقات الإنتاج التي تتطلب بيانات هيكلية موثوقة. بينما النموذج بدون رقابة، فإنه يلتزم أيضًا بالقيود الهيكلية عند الطلب. هذا التوازن بين الحرية والهيكلية هو ميزة رئيسية للمطوِّرين الذين يبنيون وكلاء معقدين.

مراقبة الاستخدام والحدود

يتم تتبع الاستخدام لكل مفتاح API. تعرض لوحة التحكم رصيد الرصيد الحالي وسجل الطلبات الأخيرة. نظرًا لأن الفوترة تعتمد على استخدام الرموز الفعلي، يمكنك مراقبة تكاليفك في الوقت الفعلي. لا تفرض الخدمة رسومًا على الأخطاء أو الرفض، مما قد يوفر المال أثناء مراحل الاختبار.

مقاييس الاستخدام:

• الرموز المدخلة: تُحسب بمبلغ $0.25 لكل 1M رمز.
• رموز المخرجات: تُفرض رسوم بمبلغ $1.00 لكل 1M رمز.
• الأخطاء: مجانية.

يمكنك إعداد التنبيهات إذا كانت مكتبة العميل تدعم ذلك، ولكن المراقبة الأساسية تتم من خلال لوحة حسابك. يضمن حد 300 طلب في الدقيقة استخدامًا عادلًا لجميع المستخدمين. إذا تجاوزت هذا الحد، فستتلقى رمز حالة 429.

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

إدارة الرصيد عبر العملات المشفرة

تتم معالجة المدفوعات حصريًا عبر العملات المشفرة. يمكنك شحن حسابك باستخدام USDT (TRC20) أو USDC (Base). الحد الأدنى لمبلغ الشحن هو $10، والحد الأقصى هو $500. لا توجد اشتراكات شهرية أو رسوم متكررة.

رصيد إضافي:

• شحن بمقدار $50: رصيد إضافي بنسبة 5%.
• شحن بمقدار $100: رصيد إضافي بنسبة 10%.

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

عملية الدفع:

Copyimport OpenAI from "openai";

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

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