عنوان URL الأساسي والمصادقة
للبدء في استخدام نموذج unhinged ai، تحتاج إلى مفتاح API صالح. أنشئ مفتاحاً فورياً عبر Google أو البريد الإلكتروني من صفحة الحصول على مفتاح API. لا يلزم رقم هاتف، ويظهر المفتاح فوراً.
عيّن عنوان URL الأساسي إلى https://api.unhinged.top/v1. يجب أن تتضمن جميع الطلبات رأس Authorization بمخطط Bearer. يعمل هذا الإعداد مع أي SDK متوافق مع OpenAI. تقدم الواجهة نموذج LLM غير خاضع للرقابة عبر الإنترنت، ومحسّن لتوليد النصوص المباشرة دون طبقات توجيه إضافية.
الطلب الأول
أرسل طلب إكمال محادثة قياسي لاختبار التكامل. معرف النموذج هو دائماً uncensored. تُرجع نقطة النهاية نصاً خاماً دون رفض المحتوى للاستخدام القانوني للبالغين. إذا تجاوزت الحد، تُرجع الواجهة رمز خطأ واضح.
curl https://api.unhinged.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."}]
}'يوضح طلب POST البسيط هذا طبيعة الخدمة المباشرة (إدخال نص وإخراج نص). يمكنك ضبط معاملات مثل temperature للتحكم في الإبداع. تتضمن الاستجابة استخدام الرموز، مما يساعدك على تتبع التكاليف مقابل نموذج التسعير الشفاف.
تكامل حزمة Python SDK
استخدم حزمة تطوير البرمجيات (SDK) الرسمية الخاصة بـ OpenAI للغة Python للتفاعل مع الـ API. قم بتكوين عنوان URL الأساسي ومفتاح API في تهيئة العميل. يتيح لك هذا النهج الحفاظ على هيكل الكود الحالي مع استبدال النموذج بنموذج بدون رقابة.
from openai import OpenAI
client = OpenAI(base_url="https://api.unhinged.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)يستفيد مطورو Python من الطبيعة المتزامنة لهذا المقتطف. يتعامل مع دورة حياة الطلب تلقائياً. تأكد من معالجة الاستثناءات الخاصة بحدّ المعدل أو فشل المصادقة. يدعم النموذج ما يصل إلى 100,000 رمز في نافذة السياق، مما يسمح بحفظ تاريخ الموجّهات الكبير.
تكامل حزمة Node SDK
في بيئات JavaScript و TypeScript، تقدم حزمة Node سهولة استخدام مماثلة. قم بتهيئة العميل بعنوان URL الأساسي والمفتاح. يتيح ذلك إنشاء نماذج أولية سريعة لميزات الذكاء الاصطناعي في تطبيقات الويب أو الخدمات الخلفية.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhinged.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);معالجة غير المتزامن مدمجة في الحزمة. يمكنك انتظار الاستجابة مباشرة. هذا النمط مثالي للعرض من جانب الخادم أو نقاط النهاية التي تحتاج إلى إرجاع مخرجات النموذج للعملاء. تذكر أن واجهة API غير الخاضعة للرقابة محدودة بتوليد النصوص فقط؛ لا تتوقع دعم الصور أو الصوت في هذه النقطة النهائية.
الاستجابات المتدفقة
لتجربة زمنية استجابة أقل، فعّل البث المتدفق عن طريق تعيين stream: true. تُرسل الـ API أحداثاً مرسلة من الخادم (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)يعد البث المتدفق ضرورياً لواجهات المحادثة حيث يتوقع المستخدمون تغذية راجعة في الوقت الفعلي. قم بتحليل حقول choices[0].delta.content لإعادة بناء الاستجابة الكاملة. تقلل هذه الطريقة من الوقت المستغرق للوصول إلى أول رمز بشكل كبير مقارنة بالاستجابات المتزامنة الكاملة.
الحدود، الأخطاء والسياق
تفرض الواجهة حصصاً صارمة لضمان الاستقرار. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز حجم جسم الطلب 8 MB. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429.
تُرجع أخطاء المصادقة 401 إذا كان المفتاح غير صالح. إذا استنفد رصيدك المسبق الدفع، تُرجع الواجهة 402. الأخطاء والرفضات مجانية، لذا لن يتم شحنتك إلا مقابل استخدام الرموز في الطلبات الناجحة. تدعم نافذة السياق 100,000 رمز إجمالاً، مع حد أقصى للإخراج يبلغ 32,000 رمز لكل طلب.
