تكامل خطوة بخطوة لواجهة برمجة تطبيقات اللغات الكبيرة غير الخاضعة للرقابة من uncensored.com

المتطلبات الأساسية: حزمة التطوير (SDK) وإعداد البيئة

ثبّت الحزمة البرمجية (SDK) للغة المفضلة لديك للتواصل مع نقطة النهاية. يستخدم معظم المطورين الحزمة البرمجية (SDK) الرسمية لـ OpenAI لـ Python أو Node.js أو Go. يعمل هذا لأن API يتبع مخطط إكمال الدردشة القياسي لـ OpenAI.

تأكد من أن بيئتك تحتوي على Python 3.8+ أو Node.js 18+. قم بتثبيت الحزمة عبر pip أو npm. ستحتاج إلى مفتاح API من لوحة التحكم. لا يتطلب التسجيل رقم هاتف.

• Python: pip install openai
• Node.js: npm install openai

احفظ مفتاح API الخاص بك في متغير بيئة. يمنع ذلك التعرض العرضي في التحكم في الإصدارات. يمنح المفتاح الوصول إلى النموذج غير الخاضع للرقابة.

تكوين عنوان URL الأساسي

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

اضبط عنوان URL الأساسي إلى HTTPS://api.uncensoredaicom.com/v1. هذا يوجه الطلبات إلى بنية LLM غير الخاضعة للرقابة. معرف النموذج الذي يجب إرساله هو "uncensored". إنه نموذج مفتوح الوزن مُعدّل لحدود الرفض الدنيا.

تحقق من الاتصال باستدعاء نقطة نهاية النماذج. هذا يؤكد أن بيانات الاعتماد الخاصة بك وعنوان URL الأساسي صحيحان. تعيد الاستجابة الناجحة معرف النموذج ونوع الكائن.

إعداد الرأس للمصادقة

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

حدد الرأس (Header) كما يلي: Authorization: Bearer YOUR_API_KEY. يتعامل مكتبة البرمجيات (SDK) مع هذا تلقائيًا إذا مررت المفتاح إلى مُنشئ العميل. تأكد من عدم وجود مسافات بيضاء إضافية. المفاتيح غير الصالحة تُرجع خطأ 401 غير مصرح به.

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

إرسال طلب دردشة قياسي

أرسل طلب POST إلى /v1/chat/completions. أرسل رسائلك كمصفوفة من كائنات role و content. يدعم النظام أدوار المستخدم والمساعد والنظام.

مثال للهيكل: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. تُعيد الـ API إكمال النص. نافذة السياق 100,000 رمز إجمالاً. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب.

الأخطاء والرفض لا يستهلكان رصيدًا. هذا يحمي رصيدك المسبق. اضبط temperature وtop_p للتحكم. القيم الافتراضية تعمل لمعظم حالات الاستخدام.

تمكين التدفق للمخرجات في الوقت الفعلي

تعيين stream: true في جسم الطلب الخاص بك. هذا ينشط أحداث الإرسال من الخادم (SSE). تصل الرموز تدريجياً بدلاً من الانتظار للإكمال الكامل.

قم بتحليل تدفق SSE لعرض النص في الوقت الفعلي. تحتوي الشريحة الأخيرة على إحصائيات استخدام الرموز المميزة. يتيح ذلك تتبع الفواتير بدقة. يقلل التدفق من زمن الاستجابة المُدرَك للمستخدمين النهائيين.

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

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

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

تحديد tool_choice للتحكم في اختيار الوظائف. استخدم auto للاكتشاف التلقائي. تدعم واجهة API تعريفات الأدوات القياسية. قم بتحليل معلمات استدعاء الوظيفة من الاستجابة.

قم بتنفيذ تنفيذ دالة في كودك. أرسل النتيجة مرة أخرى كرسالة. يستمر النموذج في المحادثة. هذا يمكّن سير العمل المعقد. يضمن الاختبار دقة تحليل الحجج.

معالجة استجابات وضع JSON

تعيين response_format: {"type": "json_object"}. يفرض هذا على النموذج إخراج JSON صالح. استخدم هذا لاستخراج البيانات المهيكلة. يمنع أخطاء الاستجابة غير المهيكلة.

تحليل سلسلة JSON في كودك. تعامل مع أخطاء التحليل المحتملة. يحسن وضع JSON الموثوقية لتكاملات API. وهو مثالي لخطوط أنابيب معالجة البيانات.

ادمج وضع JSON مع تعليمات النظام. وجه النموذج لإخراج مخططات (Schemas) محددة. يضمن ذلك تنسيقاً متسقاً. تحقق من صحة الإخراج قبل استخدامه. يقلل هذا من الأخطاء في العمليات اللاحقة.

مراقبة الحدود والأخطاء

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

راقب رموز حالة HTTP. يشير 429 إلى تجاوز حد المعدل. يشير 400 إلى طلب غير صالح. يشير 500 إلى خطأ في الخادم. نفذ إعادة المحاولة مع التراجع الأسي. هذا يمنع إغراق واجهة برمجة التطبيقات.

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

حساب التكاليف واستخدام الرموز

يتم التسعير بشفافية ودفع مسبق. تكلف رموز الإدخال 0.15 دولار لكل مليون. تكلف رموز الإخراج 0.50 دولار لكل مليون. لا ينتهي صلاحية الرصيد. لا تنطبق رسوم شهرية.

أضف رصيدًا باستخدام العملات المشفرة فقط. USDT (TRC20) أو USDC (Base). تتراوح المبالغ من 20 دولارًا إلى 500 دولار. تطبيق رصيد المكافأة للإيداعات الأكبر. +5% من 50 دولارًا، +10% من 100 دولار، +15% من 200 دولار.

Calculate costs before heavy usage. Estimate token counts for your prompts. This helps budget effectively. Errors are free. Refunds are not issued, but mistakes are fixed. Use the dashboard to track spending.