Unfiltered AI Chatbot: البدء السريع: دمج واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة
دمج واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة في دقائق باستخدام عملاء متوافقين مع OpenAI. يغطي هذا الدليل المصادقة، وطلبات الإكمال، والبث المتدفق، واستخدام الأدوات بدون رفضات للمحتوى.
عنوان URL الأساسي والمصادقة
لبدء التكامل، وجّه عميلك إلى عنوان URL الأساسي https://api.unfilteredaichatbot.cc/v1. تتبع الواجهة هيكل chat-completions القياسي من OpenAI، مما يعني أنه يمكنك استخدام مكتبات SDK الحالية عن طريق تحديث عنوان URL الأساسي وتقديم مفتاح API الخاص بك.
تعتمد المصادقة على رأس Authorization. أضف مفتاحك الفريد بتنسيق Bearer YOUR_API_KEY. يتحقق النظام من صحة هذا المفتاح في كل طلب. إذا كان المفتاح مفقوداً أو غير صالح، ستتلقى خطأ 401. يُسمح لكل حساب بمفتاح نشط واحد فقط؛ يؤدي إنشاء مفتاح جديد إلى إبطال المفتاح السابق فوراً. يضمن ذلك التحكم في الوصول بشكل مباشر دون تسلسلات معقدة للأذونات.
يظهر مفتاح API فورًا عند التسجيل عبر Google أو البريد الإلكتروني. لا يتطلب رقم هاتف، ويبقى المفتاح صالحًا طالما يغطي رصيدك المسبق الدفع الاستخدام. الأخطاء والرفضات لا تستهلك الرصيد، لذا يمكنك اختبار المصادقة بأمان.
طلب الإكمال الأساسي
أرسل طلب POST إلى /v1/chat/completions مع تعيين معرف النموذج الخاص بك إلى uncensored. يتطلب الحملة مصفوفة messages تحتوي على سجل محادثاتك. تقبل نقطة النهاية هذه مدخلات نصية وتعيد مخرجات نصية، ملتزمة تمامًا بتنسيق chat-completions.
يُظهر المثال أدناه استخدام curl بسيط لمحادثة من دورين. سيقوم النموذج بالرد دون حجب على المواضيع البالغة أو المثيرة، شريطة أن تكون قانونية. تأكد من تضمين حقل model صراحةً لاستهداف النسخة غير الخاضعة للرقابة الصحيحة.
لمطوري Python، تعمل مكتبة OpenAI SDK بشكل افتراضي. فقط قم بتهيئة العميل بعنوان URL الأساسي والمفتاح الخاص بك.
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredaichatbot.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، ينطبق الهيكل نفسه. قم بتهيئة العميل واستدعاء chat.completions.create.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unfilteredaichatbot.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: true في حمولة طلبك. تعيد الواجهة تدفق أحداث المخدم (SSE)، مما يسلم الرموز تدريجيًا عند إنشائها. هذا مثالي لواجهات المستخدم في الوقت الفعلي حيث يهم زمن الاستجابة.
تحتوي الشريحة الأخيرة من التدفق على إحصائيات الاستخدام الكاملة، بما في ذلك عدد رموز الإدخال والإخراج. يمكنك استخدام هذه البيانات لتحديث واجهة المستخدم أو تتبع الفواتير بدقة. لاحظ أن استخدام الرموز يُبلغ عنه فقط في الشريحة الأخيرة، لذا يجب عليك تحليل التدفق بالكامل للحصول على أعداد دقيقة.
يوضح المثال أدناه بنية طلب البث المتدفق. استبدل الحيز المحجوز بمفتاحك الفعلي ومحتوى الرسالة.
curl https://api.unfilteredaichatbot.cc/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."}]
}'لا يؤثر البث المتدفق على التسعير أو حدود المعدل؛ فكل رمز يتم إنشاؤه لا يزال يُحتسب في استخدامك وحدودك.
استدعاء الدوال
تدعم الواجهة استدعاء الدوال عبر معاملات tools و tool_choice. عرّف دوالك في مصفوفة tools، وسيعيد النموذج JSON هيكليًا عند الاقتضاء. يمكنك فرض استخدام الأدوات عن طريق تعيين tool_choice إلى دالة محددة أو auto لاتخاذ القرار من قبل النموذج.
تعمل هذه الميزة ضمن سياق غير خاضع للرقابة، مما يعني أن النموذج لن يرفض استدعاء الأدوات المتعلقة بالمواضيع البالغة أو المتخصصة ما لم تنتهك حد المحتوى الصارم. استخدم response_format مضبوطاً على {"type": "json_object"} إذا كنت بحاجة إلى إخراج JSON صارم للتحليل.
يعد استدعاء الدوال جزءًا من نقطة النهاية القياسية لـ chat-completions، لذا لا حاجة لإعداد إضافي يتجاوز حمولة الطلب. تأكد من أن تعريفات الدوال الخاصة بك تتبع تنسيق مخطط OpenAI للتوافق.
وضع JSON
للتطبيقات التي تتطلب بيانات هيكليّة، اضبط response_format على {"type": "json_object"}. هذا يوجه النموذج لإخراج JSON صالح، مما يقلل من أخطاء التحليل في الأنظمة التي تليها. هذا الوضع مفيد لاستخراج البيانات، أو إنشاء التكوينات، أو تمكين سير عمل الوكلاء.
يعمل وضع JSON جنبًا إلى جنب مع استدعاء الدوال، ولكن يمكن استخدامه أيضًا للتحويل المباشر من النص إلى JSON. النموذج غير خاضع للرقابة، لذا سيقوم بإنشاء JSON حتى للهياكل المعقدة أو غير المعتادة دون رفض بسبب فلاتر المحتوى.
تذكر أن وضع JSON لا يزال يُحتسب ضمن حدود الرموز والفوترة الخاصة بك. تأكد من أن الموجّه يحدد بوضوح هيكل JSON لتحسين جودة المخرجات. نافذة السياق بحجم 100,000 رمز تنطبق على إجمالي الإدخال والإخراج معًا.
حدود المعدل والأخطاء
يُقتصر كل مفتاح API على 300 طلب في الدقيقة و8 طلبات متزامنة. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. إذا تجاوزت حدّ المعدل، ستعيد الواجهة البرمجية خطأ 429. إذا نفد رصيدك، ستتلقى خطأ 402. يؤدي فشل المصادقة إلى خطأ 401.
نافذة السياق هي 100,000 رمز إجمالاً، مع حد أقصى للإخراج هو 32,000 رمز لكل طلب (2,048 إذا لم يُضبط max_tokens). الأخطاء والرفضات مجانية، لذا يمكنك اختبار الحدود دون استهلاك الرصيد. لا ينتهي رصيدك المسبق الدفع، وتُخصم المبالغ المدفوعة مسبقاً بناءً على الاستخدام الفعلي.
للتعامل مع الأخطاء بالتفصيل، تحقق من أكواد الحالة. يشير 401 إلى مفتاح غير صالح أو مفقود، بينما يتطلب 402 شحن الرصيد. استخدم صفحة الدعم لحل مشكلات الفوترة. لا حاجة لبطاقة للتجربة، لكن العملات المشفرة مطلوبة للشحن.
البث المتدفق
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)مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.unfilteredaichatbot.cc/v1 |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| وضع JSON | response_format: {"type": "json_object"} |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| حجم الطلب | حتى 8 MB |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| مكافأة | +5% من $50، +10% من $100 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
كيف أحصل على مفتاح API؟
سجّل باستخدام 'المتابعة مع Google' أو البريد الإلكتروني وكلمة المرور في صفحة الحصول على مفتاح API. يظهر مفتاحك فورًا بعد التسجيل. لا يتطلب رقم هاتف، ويكون المفتاح نشطًا على الفور.
ماذا يحدث إذا تجاوزت حدّ المعدل؟
تعيد الواجهة خطأ 429. يسمح كل مفتاح بـ 300 طلب في الدقيقة و8 طلبات متزامنة. الأخطاء والرفضات لا تُحتسب في رصيدك، لكنها تُحتسب ضمن حدّ المعدل.
هل يمكن تجديد رصيد التجربة المجانية؟
لا، رصيد التجربة المجانية بقيمة $0.50 لمرة واحدة لكل شخص وصالح لمدة 7 أيام. بعد انتهاء الصلاحية أو الاستخدام، يجب عليك شحن الرصيد بالعملات المشفرة (USDT TRC20 أو USDC Base) لمواصلة استخدام الواجهة.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.