البدء السريع: قم بدمج واجهة برمجة التطبيقات لنماذج اللغات الكبيرة غير الخاضعة للرقابة
يوضح لك هذا الدليل كيفية دمج نموذجنا غير الخاضع للرقابة في تطبيقك باستخدام مكتبات SDK القياسية المتوافقة مع OpenAI. ستقوم بتكوين المصادقة، وإرسال طلبك الأول، والتعامل مع التدفق، وإدارة الفواتير بدون رسوم خفية.
المتطلبات الأساسية: حزمة التطوير (SDK) ومتغيرات البيئة
ابدأ بتثبيت حزمة OpenAI الرسمية للغة المفضلة لديك. نقدم واجهة برمجة تطبيقات (API) لاستكمال الدردشة متوافقة مع OpenAI، تعمل مع أي عميل قياسي. تحتاج إلى تكوين متغيرين للبيئة: OPENAI_API_KEY و OPENAI_BASE_URL.
عنوان URL الأساسي لهذه الخدمة هو HTTPS://api.llmsunrestricted.com/v1. يضمن هذا العنوان وصول طلباتك إلى بنية تحتية غير خاضعة للرقابة. يقوم مفتاح API الخاص بك بمصادقة حساب رصيدك المدفوع مسبقاً. لا يتطلب الإعداد رقم هاتف، فقط بريدك الإلكتروني أو حساب Google.
المصادقة: ضبط مفتاح API الخاص بك
المصادقة تعتمد على مفتاح API واحد يتم إنشاؤه أثناء التسجيل. تتلقى هذا المفتاح فوراً بعد إنشاء حساب عبر Google أو البريد الإلكتروني. احفظ هذا المفتاح بأمان في متغيرات البيئة لتجنب تعريضه في كود جانب العميل.
يتحقق النظام من المفتاح مقابل رصيدك المدفوع مسبقًا. إذا كان المفتاح غير صالح أو منتهي الصلاحية، تعيد واجهة برمجة التطبيقات خطأ 401. يمكنك إنشاء مفتاح جديد في أي وقت، والذي يستبدل المفتاح السابق. احتفظ بمفتاحك خاصًا لمنع الاستخدام غير المصرح به لرموزك.
إرسال طلب إكمال الدردشة الأول
أرسل طلب POST إلى /v1/chat/completions endpoint. استخدم معرف النموذج uncensored للوصول إلى نموذجنا مفتوح الوزن والمضبط للمحتوى البالغ والإبداعي. لا يرفض النموذج المواضيع القانونية، مما يضمن حصولك على المخرجات المتوقعة.
إليك مثال أساسي باستخدام cURL للتحقق من اتصالك والفوترة.
curl https://api.llmsunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List three common use cases for this API"}]
}'يستهلك هذا الطلب رموز الإدخال بناءً على طول طلبك. يتم تحصيل الرسوم عليك فقط مقابل الرموز التي تمت معالجتها فعلياً. الأخطاء والرفضات بسبب التنسيق غير صالح مجاني.
معالجة استجابات التدفق (SSE)
فعّل البث عن طريق تعيين 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)تأكد من أن مكتبة العميل الخاصة بك تتعامل مع الاستجابات الجزئية بشكل صحيح. ينتهي التدفق عندما ينتهي النموذج من التوليد أو يصل إلى حد الرموز المميزة.
تكوين المعلمات: درجة الحرارة و Top_P
اضبط سلوك التوليد باستخدام المعلمات القياسية. اضبط temperature للتحكم في العشوائية؛ تجعل القيم الأقل المخرجات أكثر حتمية. استخدم top_p لتقييد تنوع المفردات. تساعد هذه الإعدادات في ضبط النموذج غير الخاضع للرقابة لتجسيد الأدوار أو الكتابة الإبداعية.
يمكنك أيضًا استخدام response_format مع {"type": "json_object"} لبيانات مُهيّأة. دعم استدعاء الوظائف عبر tools و tool_choice. يدعم النموذج ما يصل إلى 100,000 رمز لنافذة السياق بأكملها.
from openai import OpenAI
client = OpenAI(base_url="https://api.llmsunrestricted.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)تمنحك هذه المعلمات تحكمًا كاملًا في نمط مخرجات النموذج. جرب التركيبات للوصول إلى أفضل توازن لحالة الاستخدام الخاصة بك.
فهم استخدام الرموز والفوترة
الفوترة مسبقة الدفع حصرياً وتعتمد على استهلاك الرموز الفعلية. تكلفة الرموز المدخلة 0.15 دولار لكل مليون، وتكلفة الرموز المخرجة 0.50 دولار لكل مليون. تدفع فقط مقابل ما تستخدمه، دون رسوم اشتراك شهرية. الرصيد لا ينتهي، لذا يمكنك الشحن عند الحاجة.
إذا نفد رصيدك، تعيد الواجهة البرمجية خطأ 402. يمكنك الشحن باستخدام USDT (TRC20) أو USDC (Base) بدءاً من $20. تنطبق المكافآت على الإيداعات الأكبر: +5% من $50، +10% من $100، و+15% من $200. لا تستهلك الأخطاء الرصيد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.llmsunrestricted.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);راقب استخدامك عبر لوحة التحكم أو من خلال التحقق من أعداد الرموز في رؤوس استجابة واجهة برمجة التطبيقات. يضمن هذا الشفافية أنك تحتفظ بالتحكم في تكاليف التطوير الخاصة بك.
الأسئلة الشائعة
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
تفرض الـ API حدًا قدره 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429 Too Many Requests. انتظر بضع ثوانٍ وأعد المحاولة، أو قم بترقية نمط استخدامك للبقاء ضمن الحدود المجانية.
هل النموذج غير المقيد حقاً غير مقيد؟
نعم، تم ضبط النموذج للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين أو الخيالي أو المواضيع المثيرة للجدل. الحد الثابت الوحيد هو رفض المحتوى الجنسي الذي يتضمن قاصرين، والذي يتم إنفاذه دائمًا. لديك تحكم كامل في الإرشادات الأخرى عبر هندسة المطالبات.
كيف أدير مفاتيح واجهة برمجة التطبيقات الخاصة بي؟
يمكنك إنشاء مفتاح جديد على الفور عبر لوحة التحكم بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني. يحتوي كل حساب على مفتاح نشط واحد؛ يحل إنشاء مفتاح جديد محل المفتاح القديم على الفور. يمكنك أيضاً عرض تفاصيل الاستخدام والرصيد على نفس الصفحة.
أنشئ مفتاحك الآن
سجّل، انسخ المفتاح، حدّث عنوان URL الأساسي الخاص بك. هذا هو التكوين بأكمله.