عنوان URL الأساسي والمصادقة
ابدأ كل طلب بتوجيه مكتبة (SDK) الخاصة بك إلى عنوان URL الأساسي الخاص بك وتقديم مفتاح واجهة برمجة التطبيقات (API) في رأس المصادقة.
نقطة النهاية هي https://api.openrouterabliteratedmodels.com/v1. تقوم بالمصادقة باستخدام رمز حامل تم إنشاؤه على لوحة حسابك. هذا المفتاح هو الاعتماد الوحيد المطلوب لجميع المكالمات اللاحقة، مما يضمن توجيه طلباتك مباشرة إلى بنية نموذجنا غير المقيد دون طبقات توجيه وسيطة.
الطلب الأول
أرسل أول إكمال عن طريق إرسال رسالة إلى نقطة نهاية إكمال الدردشة باستخدام عميل HTTP المفضل لديك.
معرف النموذج هو بشكل صارم uncensored. يمكنك إرسال موجهات نصية مع معلمات قياسية مثل درجة الحرارة أو top_p. تُرجع واجهة برمجة التطبيقات (API) ردًا نصيًا دون رفضات محتوى للمواضيع البالغة القانونية، مع الحفاظ على سلوك "إزالة الحواجز" (abliterated) الذي تتوقعه من النماذج مفتوحة الوزن والمضبوطة للإخراج غير المقيد.
curl https://api.openrouterabliteratedmodels.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the factorial of 5."}]
}'
واجهة برمجة تطبيقات Python
قم بدمج واجهة برمجة التطبيقات في مشاريع Python الخاصة بك عن طريق تعيين عنوان URL الأساسي واسم النموذج في تكوين عميل OpenAI.
يُمكّنك هذا النهج من إعادة استخدام الكود الموجود الذي يتوقع نقطة نهاية متوافقة مع OpenAI. مر مفتاح API الخاص بك عبر متغيرات البيئة أو التهيئة المباشرة. يتعامل العميل مع التسلسل وتحليل الأخطاء تلقائيًا، مما يوفر رموز نصية خام أو JSON منظم اعتمادًا على إعدادات تنسيق الاستجابة الخاصة بك.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterabliteratedmodels.com/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 SDK
قم بتوصيل تطبيقات Node.js الخاصة بك عن طريق تكوين حزمة OpenAI لتشير إلى عنوان URL الأساسي المحدد لدينا بدلاً من الافتراضي.
اضبط apiKey و baseURL الخصائص قبل إجراء أي مكالمات. يضمن ذلك توجيه مكالمات الوظائف، واستجابات التدفق، وطلبات وضع JSON إلى البنية التحتية غير الخاضعة للرقابة لدينا. يمكنك الاستمرار في استخدام الأساليب المألوفة مثل chat.completions.create بتوافق كامل.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterabliteratedmodels.com/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);
البث مع أحداث الخادم (SSE)
استلم توليد نص فوري بتفعيل وضع التدفق، الذي يسلم الرموز بمجرد توفرها عبر أحداث الإرسال من الخادم.
عيّن معلمة stream إلى true في طلبك. يعيد الـ API سلسلة من الشرائح، مما يتيح لك عرض النص تدريجيًا في واجهة المستخدم. يتم تضمين إحصائيات استخدام الرموز في الشريحة الأخيرة، لذا يمكنك تتبع الاستهلاك بدقة دون انتظار انتهاء توليد الاستجابة بأكملها.
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)
وضع JSON واستدعاء الوظائف
فرض المخرجات المهيكلة أو تمكين استخدام الأدوات من خلال ضبط تنسيق الطلب وتعريفات الأدوات في payload الخاص بك.
استخدام response_format تعيين إلى json_object لضمان أن يعيد النموذج JSON صالحاً بدون أغطية Markdown. لاستدعاء الوظائف، عرّف أدواتك في جسم الطلب واترك النموذج يقرر متى يستدعيها. يدعم هذا سير العمل المعقد حيث يجب أن يعيد النموذج غير الخاضع للرقابة بيانات مهيكلة للمعالجة اللاحقة.