توثيق واجهة برمجة التطبيقات & بداية سريعة
دمج واجهة برمجة التطبيقات (API) للذكاء الاصطناعي الكبير (LLM) غير الخاضع للرقابة في دقائق باستخدام نقاط نهاية متوافقة مع OpenAI. يغطي هذا الدليل السريع المصادقة، وهيكل الحمولة (payload)، والتدفق، والحدود المحددة لنموذج "غير الخاضع للرقابة".
عنوان URL الأساسي & المصادقة
يعيش الـ API الخاص بنا عند https://api.llmjailbreak.cc/v1 ويقبل العناوين القياسية. تحتاج إلى Authorization: Bearer <your-api-key> الرأس في كل طلب. احصل على مفتاحك فوراً من لوحة التحكم باستخدام Google أو البريد الإلكتروني، ثم الصقه في عميلك. يضمن عنوان URL الأساسي التوافق مع مكتلات SDK الحالية لـ OpenAI دون تغييرات في الكود.
curl https://api.llmjailbreak.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "explain the Krebs cycle"}]
}'إذا كان المفتاح مفقوداً أو غير صالح، يعيد الـ API 401 خطأ على الفور. تحقق من لوحة التحكم إذا كنت تشك في وجود خطأ مطبعي. لا يلزم رقم هاتف للتسجيل.
شرح POST /v1/chat/completions
أرسل بيانات نصية إلى /v1/chat/completions نقطة النهاية للحصول على الاستجابات. هذه هي نقطة التفاعل الأساسية للنموذج غير المقيد. أنت تحدد model كـ uncensored وتوفير messages مصفوفة. تعالج واجهة برمجة التطبيقات التلميح وتعيد النص المُولّد.
from openai import OpenAI
client = OpenAI(base_url="https://api.llmjailbreak.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)حافظ على حمولاتك (payloads) أقل من 8 ميجابايت. يدعم النظام نافذة سياق بحجم 100,000 رمز تجمع بين المدخلات والإكمال. إذا تجاوزت الحدود، ترفض الـ API الطلب. استخدم هذه النهاية (endpoint) لأدوار اللعب NSFW أو أبحاث الأمان بدون مرشحات المحتوى.
المعلمات: درجة الحرارة وTop-P والبذلة
تحكم في الإبداع باستخدام temperature والتنوع مع top_p. تعيين seed لإخراج حتمي أثناء الاختبار. تتصرف هذه المعاملات تماماً مثل نظيراتها في OpenAI. اضبطها لضبط سلوك النموذج بدقة حسب حالة الاستخدام الخاصة بك.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.llmjailbreak.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);قيم درجة حرارة أعلى تزيد من العشوائية. القيم الأقل تجعل الردود أكثر قابلية للتنبؤ. ال seed يضمن إمكانية التكرار. استخدم هذه الأدوات لمعايرة النموذج للكتابة الإبداعية أو استخراج البيانات الدقيق.
وضع JSON واستدعاء الوظائف
فرض المخرجات المهيكلة باستخدام response_format: {"type": "json_object"}. يضمن ذلك أن يُعيد النموذج بيانات JSON. يمكنك أيضًا استخدام استدعاء الوظائف للتكامل مع الأدوات الخارجية. عرّف الوظائف في tools مصفوفة ودع النموذج يقرر متى يستدعيها.
يدعم استدعاء الوظائف tool_choice للتطبيق الصارم. استخدم هذا للوكلاء أو خطوط أنابيب البيانات. تتعامل واجهة برمجة التطبيقات مع التوجيه تلقائيًا. لا حاجة لإعداد إضافي يتجاوز وضع JSON القياسي في OpenAI.
استجابات البث (SSE)
تدفق الاستجابات باستخدام أحداث Server-Sent (SSE). يقلل هذا من التأخير للمخرجات الطويلة. ترسل الواجهة البرمجية الرموز تدريجياً. يمكنك معالجتها في الوقت الفعلي. هذا مثالي لواجهات الدردشة أو العروض المباشرة.
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)تظهر إحصائيات استهلاك الرمز في الشريحة الأخيرة. راقب هذا لضمان دقة الفوترة. لا يؤثر التدفق على التسعير. يتم فوترة كل رمز بشكل منفصل بالسعر القياسي. استخدم هذا للحصول على تجربة مستخدم أكثر سلاسة.
حدود معدل الطلبات والحصص
تتوقع 429 الأخطاء إذا تجاوزت 300 طلب في الدقيقة لكل مفتاح. الطلبات المتزامنة محدودة بـ 8 لكل مفتاح. تمنع هذه الحدود الإساءة وتضمن الاستقرار. قم بترقية خطتك أو انتظر إذا وصلت إلى الحد الأقصى.
A 402 خطأ يشير إلى عدم كفاية الرصيد. قم بشحن رصيدك بالعملات المشفرة للمتابعة. الرصيد لا ينتهي. الأخطاء والرفضات مجانية. راقب استخدامك عبر لوحة التحكم. مفتاح API فريد لكل حساب. استبدله إذا لزم الأمر.
الأسئلة الشائعة
هل هذه الواجهة متوافقة مع مكتبات SDK الخاصة بـ OpenAI؟
نعم، متوافق تمامًا مع OpenAI. ما عليك سوى تغيير عنوان URL الأساسي ومفتاح API. يتطابق هيكل نقطة النهاية والمعاملات مع واجهة برمجة التطبيقات القياسية. هذا يسمح بالتكامل المباشر.
ما هو حجم نافذة السياق؟
نوافذ السياق تتسع لـ 100,000 رمز. يشمل ذلك كلًا من النص الأولي والإكمال. يمكنك إرسال ما يصل إلى 16,000 رمز في استجابة واحدة. الاستجابات الأقصر تكون افتراضيًا 2,048 رمز إذا لم يتم تحديدها.
كيف أتعامل مع أخطاء مثل 401 أو 429؟
يشير خطأ 401 إلى أن مفتاح API الخاص بك غير صالح أو مفقود. يشير خطأ 429 إلى تجاوزك لحد معدل الطلبات البالغ 300 طلب في الدقيقة. تحقق من بيانات الاعتماد الخاصة بك أو انتظر قبل إعادة المحاولة. كلا الخطأين هما استجابات HTTP قياسية.
احصل على مفتاح API الخاص بك
سجّل، وانسخ مفتاحك، وحدّث عنوان URL الأساسي. هذا هو التكوين بأكمله.
احصل على مفتاحك