مرجع واجهة برمجة التطبيقات والبدء السريع
ابدأ في إرسال الطلبات إلى واجهة برمجة التطبيقات الخاصة بنا لنموذج اللغة الكبير غير المقيد فوراً باستخدام نقاط النهاية القياسية المتوافقة مع OpenAI. يغطي هذا الدليل المصادقة، الطلبات الأساسية، والتدفق مع حدود ملموسة.
المصادقة وURL الأساسي
استخدم مفتاح API الخاص بك مع عنوان URL الأساسي https://api.chatuncensored.cc/v1. مرر المفتاح في Authorization رأس الصفحة كرمز حامل (Bearer token). هذا الإعداد يعمل مع أي مكتبة SDK أو عميل متوافق مع OpenAI.
أنشئ مفتاحك على لوحة التحكم عبر Google أو البريد الإلكتروني. احتفظ به بأمان. تتلقى $0.50 صالحة لمدة 7 أيام. استخدم هذا لاختبار الاتصال قبل إضافة الرصيد عبر العملات المشفرة.
POST /v1/chat/completions
أرسل نصًا إلى النموذج باستخدام نقطة نهاية إكمال الدردشة. حدد معرف النموذج كـ uncensored. يجيب هذا النموذج مفتوح المصدر دون رفضات للمحتوى البالغ القانوني.
أدرج مطالبة النظام لتوجيه السلوك. حدد رسالة المستخدم باستفسارك. تعيد واجهة برمجة التطبيقات مخرجات نصية مباشرة.
تكوين معاملات مثل درجة الحرارة أو top_p للحصول على نتائج متنوعة. يتعامل النموذج مع سياق يصل إلى 100,000 رمز مجتمعة.
أخطاء مثل الرفض أو مشاكل الشبكة لا تستهلك الرصيد. أنت تدفع فقط لتوليد الرموز الناجح.
استخدام مكتبة Python
ثبّت المكتبة الرسمية لـ Python الخاصة بـ OpenAI. اضبط عنوان URL الأساسي ليشير إلى واجهة برمجة التطبيقات (API) الخاصة بنا. اضبط مفتاح واجهة برمجة التطبيقات (API key) في البيئة أو في العميل.
أنشئ مثيلًا للعميل. استدعِ chat.completions.create مع النموذج والرسائل. استرد رد المساعد من كائن الاستجابة.
التعامل مع الاستثناءات الخاصة بحدود المعدل أو المفاتيح غير الصالحة. تبسط الـ SDK تحليل JSON وتنسيق الطلبات.
اختبر باستخدام رصيد التجربة أولاً. تحقق من أن هيكل الاستجابة يطابق التوقعات قبل توسيع نطاق الاستخدام.
تكامل Node SDK
استيراد حزمة OpenAI Node. تهيئة العميل مع عنوان URL الأساسي والمفتاح. عرّف النموذج كـ uncensored.
استدعاء طريقة الإكمال مع مصفوفة الرسائل. انتظر الاستجابة للحصول على النص المُولّد. تعمل هذه الطريقة بسلاسة مع الدوال غير المتزامنة.
استخدم وضع JSON عن طريق تعيين response_format إلى {"type": "json_object"}. تأكد من أن إخراجك هو JSON صالح للاستخدام البرمجي.
راقب الاستخدام عبر رموز الاستجابة. تتبع عدد رموز الإدخال والإخراج لإدارة رصيدك المدفوع مسبقاً بكفاءة.
البث، والأدوات، ووضع JSON
فعّل البث عن طريق تعيين stream إلى true. استقبل الأجزاء عبر أحداث الأحداث المرسلة عبر الخادم. قم بمعالجة كل رمز عند وصوله للحصول على زمن استجابة منخفض.
يدعم استدعاء الوظائف مع الأدوات وtool_choice. عرّف المخططات لواجهات برمجة التطبيقات الخارجية. تُعيد النموذج حججًا مهيكلة للتنفيذ.
استخدم وضع JSON لتنسيقات مخرجات صارمة. تعيين response_format لضمان استجابات JSON صالحة. يقلل هذا من أخطاء التحليل في خطوط الأنظمة الآلية.
ادمج التدفق مع الأدوات لتجارب تفاعلية. حدّث واجهة المستخدم رمزاً تلو الآخر. حافظ على تفاعل المستخدمين مع التوليد في الوقت الفعلي.
حدود المعدلات ورموز الأخطاء
تتوقع 300 طلب في الدقيقة لكل مفتاح. حد الطلبات المتزامنة إلى 8. يجب أن يبقى حجم جسم الطلب أقل من 8 ميجابايت.
عالج أخطاء 401 بالتحقق من مفتاح API الخاص بك. تحقق من الأخطاء المطبعية أو المفاتيح منتهية الصلاحية. أعد إنشاؤها إذا لزم الأمر.
استلم رمز الخطأ 402 عند نفاد الرصيد. قم بإعادة الشحن بـ USDT أو USDC. الرصيد لا ينتهي صلاحيته أبداً. أضف مكافأة بنسبة +15% على إيداعات $200.
واجهة 429 على حدود المعدل. نفذ تراجعًا أسيًا. أعد المحاولة بعد التأخير المحدد. راقب الاستخدام لتجنب الانقطاع.
cURL
curl https://api.chatuncensored.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Set user role to beta tester for the new chat interface"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatuncensored.cc/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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatuncensored.cc/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);التدفق
stream = 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)الأسئلة الشائعة
هل واجهة برمجة تطبيقات الدردشة غير الخاضعة للرقبة متوافقة مع عملاء OpenAI؟
نعم، يستخدم بنية نقاط النهاية القياسية المتوافقة مع OpenAI. يمكنك استخدام أي SDK أو عميل يدعم تنسيق chat-completions. فقط قم بتحديث عنوان URL الأساسي ومفتاح API.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
ستتلقى رمز خطأ 429. تتوقف الطلبات حتى تنتهي فترة الانتظار أو تقلل من التزامن. حافظ على الطلبات المتزامنة أقل من 8 وتجاوز 300 طلب في الدقيقة.
كيف يتعامل النموذج غير الخاضع للرقابة مع نوافذ السياق؟
يدعم نافذة سياق بحجم 100,000 رمز للنص المدخل والإكمال. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. اضبط max_tokens إذا كنت تحتاج إلى إجابات أقصر.