دمج واجهة Uncensored Local LLM البرمجية

عنوان URL الأساسي والمصادقة

تتوافق واجهة برمجة التطبيقات (API) لدينا تمامًا مع حزم SDK الخاصة بـ OpenAI. تحتاج فقط إلى تحديث base_url وتقديم مفتاح API الخاص بك. سجّل في صفحة الحصول على مفتاح API لتلقي مفتاحك على الفور. لا يلزم رقم هاتف أو بطاقة ائتمان للبدء باستخدام رصيد التجربة. عنوان URL الأساسي هو https://api.uncensoredlocalllm.com/v1. احفظ مفتاحك بأمان؛ يمكنك تجديده في أي وقت، مما يؤدي إلى إلغاء سريان المفتاح القديم على الفور. يضمن ذلك حصولك دائمًا على نقطة نهاية واحدة ومستقرة لتطبيقاتك دون تعقيدات إدارة الاستدلال المحلي.

الطلب الأول

قم بإجراء أول استدعاء لواجهة برمجة التطبيقات (API) باستخدام عميل HTTP المفضل لديك. تدعم نقطة النهاية تنسيق chat-completions القياسي. فيما يلي مثال cURL يوضح طلبًا أساسيًا. استبدل YOUR_API_KEY بمفتاحك الفعلي. يرسل هذا الطلب الموجّه ويتوقع استجابة نصية. معرف النموذج هو uncensored. هذا النموذج مفتوح الأوزان مُعدّ للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يوفر مخرجات مباشرة لحالة الاستخدام الخاصة بك.

Copycurl https://api.uncensoredlocalllm.com/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."}]
  }'

ستحتوي الاستجابة على النص المُولّد في مصفوفة choices. إذا واجهت خطأ 401، فإن مفتاح API غير صالح أو مفقود. تأكد من استخدام عنوان URL الأساسي الصحيح وأن مفتاحك لم يُسحب بعد إعادة توليده.

تكامل حزمة Python SDK

استخدم حزمة SDK الرسمية لـ Python الخاصة بـ OpenAI للتكامل بسرعة. قم بتعيين base_url و api_key في تهيئة العميل. يتيح لك هذا النهج استخدام طرق مألوفة مثل chat.completions.create(). تتولى حزمة SDK تجسيد التسلسل الهرمي للبيانات (JSON) وطلبات HTTP تلقائيًا. هذا مثالي لخدمات الخلفية أو البرامج النصية التي تحتاج إلى معالجة كميات كبيرة من النصوص. تذكر أن معرف النموذج يظل uncensored بغض النظر عن إصدار حزمة SDK الذي تستخدمه.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredlocalllm.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)

هذه الطريقة فعالة للمعالجة الدفعوية أو عندما تحتاج إلى معالجة منطق الاستجابة في Python. تأكد من تثبيت حزمة openai في بيئة العمل الخاصة بك. تدعم حزمة SDK كل من العمليات المتزامنة وغير المتزامنة، مما يناسب احتياجات معمارية مختلفة.

تكامل حزمة Node SDK

لبيئات JavaScript أو TypeScript، توفر حزمة Node.js الخاصة بـ OpenAI تجربة مماثلة. قم بتهيئة العميل باستخدام عنوان URL الأساسي ومفتاح API الخاص بك. هذا مفيد بشكل خاص لتطبيقات الويب أو الوظائف الخالية من الخوادم (serverless). تقوم حزمة SDK بتجريد تفاصيل HTTP، مما يتيح لك التركيز على منطق التطبيق. يمكنك استدعاء نقطة النهاية الخاصة بإكمال النصوص بنفس الهيكل المستخدم في الخدمات المتوافقة مع OpenAI.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredlocalllm.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);

استخدم هذا التكامل لواجهات الويب في الوقت الفعلي أو خدمات Node.js المصغرة. تدعم الحزمة أنماط الوعود و async/await، مما يجعل معالجة الأخطاء أمرًا مباشرًا. تأكد من معالجة أخطاء الشبكة المحتملة بسلاسة، خاصة في الأنظمة الموزعة.

استجابات البث المتدفق

فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. يتيح لك ذلك تلقي الاستجابات الجزئية بمجرد توليدها، مما يحسن زمن الاستجابة المدرك للمستخدمين. تدعم واجهة برمجة التطبيقات (API) أحداث الإرسال من الخادم (SSE) للبث المتدفق. هذا أمر حاسم لواجهات الدردشة حيث يُتوقع ملاحظات فورية. لا يؤثر البث المتدفق على جودة مخرجات النموذج أو نافذة السياق.

Copystream = 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)

عالج أحداث البث في كود العميل الخاص بك. يحتوي كل جزء على جزء من الاستجابة النهائية. اجمع هذه الأجزاء لإعادة بناء الرسالة الكاملة. يعمل هذا النهج بسلاسة مع حزم SDK الخاصة بـ OpenAI في كل من Python وNode.js.

حدود المعدل، والأخطاء، ونافذة السياق

تفرض واجهة برمجة التطبيقات (API) حدًا قدره 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. ستتلقى خطأ 429 إذا تجاوزت حد المعدل. يشير خطأ 402 إلى عدم توفر رصيد مسبق كافٍ. تأكد من مراقبة استخدامك وشحن حسابك عبر لوحة التحكم. لا تنتهي صلاحية الرصيد أبدًا، ويمكنك الدفع بالعملات المشفرة (USDT أو USDC).

نافذة السياق هي 100,000 رمز (token)، وتغطي كلًا من الموجّه والإكمال. يتيح ذلك إجراء محادثات موسعة أو معالجة مستندات كبيرة. إذا تجاوزت الحد، سترفض واجهة برمجة التطبيقات (API) الطلب. معرف النموذج هو uncensored، ويدعم استدعاء الدوال (tool/function calling) لإمكانيات موسعة.