دليل التكامل مع نموذج الذكاء الاصطناعي غير المقيد

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

يعيش الـ API الخاص بنا عند https://api.localuncensoredllm.com/v1. تقوم بالمصادقة عن طريق تمرير مفتاحك في Authorization الرأس. يحاكي هذا الإعداد تكاملات OpenAI القياسية. لا تحتاج إلى منطق توجيه معقد. يتولى عنوان URL الأساسي توجيه جميع الطلبات.

• استخدام Bearer <YOUR_API_KEY> للمصادقة.
• يتم إنشاء المفتاح على الفور عند التسجيل.

يضمن ذلك إرسال طلباتك مباشرة إلى النموذج غير الخاضع للرقابة لدينا. لا يوجد وسيط يقوم بتصفية مدخلاتك. تحصل على وصول خام لقدرات النموذج على الفور.

POST /v1/chat/completions: إرسال طلبك

أرسل حمولة JSON إلى نقطة نهاية إكمال المحادثة. هذه هي الطريقة القياسية للحصول على استجابات نصية من النموذج. تحدد محتوى الرسالة وتعليمات النظام. يعالج النموذج مدخلاتك ويعيد الإكمال.

Copycurl https://api.localuncensoredllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit height in meters"}]
  }'

تتعامل هذه نقطة النهاية مع جميع احتياجات توليد النصوص الخاصة بك. يمكنك ضبط معلمات مثل درجة الحرارة (temperature) و top_p. تتضمن الاستجابة النص المولد وإحصائيات استخدام الرموز المميزة. إنها بسيطة ومباشرة وموثوقة.

GET /v1/models: التحقق من نقطة النهاية الخاصة بك

استعلم عن نقطة نهاية النماذج للتحقق من الاتصال. يُرجي هذا الطلب قائمةً بالنماذج المتاحة. يجب أن ترى uncensored في الاستجابة. يؤكد هذا أن مفتاحك صالح وأن الخدمة تعمل.

Copyfrom openai import OpenAI

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

استخدم هذا للتحقق من إعدادك قبل إرسال أحمال العمل الثقيلة. إنها فحص سريع للسلامة. إذا استجابت نقطة النهاية، فإن تكاملك يعمل بشكل صحيح. يمكنك المضي قدماً بثقة.

البث، ووضع JSON، واستدعاء الأدوات

فعّل البث عن طريق تعيين stream: true. تُعيد الـ API أجزاء أثناء توليدها. يقلل هذا من زمن الاستجابة المُدرَك للاستجابات الطويلة. يمكنك أيضاً إجبار إخراج JSON باستخدام response_format. هذا مفيد لتحليل البيانات المهيكلة.

Copyimport OpenAI from "openai";

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

يدعم استدعاء الوظائف عبر tools معامل. عرّف أدواتك بتنسيق OpenAI القياسي. سيقوم النموذج بإخراج استدعاءات الأدوات عند الاقتضاء. هذا يسمح بسير عمل الوكلاء المعقد. كل شيء يعمل ضمن نفس عقد API.

حدود معدل الطلبات والتزامن

يُقتصر كل مفتاح API على 300 طلب في الدقيقة. يمكنك إرسال ما يصل إلى 8 طلبات متزامنة. يمنع ذلك العملاء الفرديين من احتكار الموارد. الحد لكل مفتاح وليس لكل حساب. قم بإدارة مفاتيحك وفقًا لذلك.

• حد حجم جسم الطلب الأقصى هو 8 ميجابايت.
• تجاوز الحدود يعيد خطأ 429.

خطط للإنتاجية الخاصة بك بناءً على هذه القيود. النظام مصمم للاستخدام المستمر عالي الحجم. يتم التعامل مع حركة المرور المتفجرة ضمن نافجة الطلبات المتزامنة.

الأخطاء، الرصيد، ونافذة السياق

يشير خطأ 401 إلى أن المفتاح غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. قم بإضافة رصيد عبر العملات المشفرة للمتابعة. لا تستهلك الأخطاء رصيدك. هذا يضمن دفعك فقط مقابل الاستجابات الناجحة.

نافذة السياق تتسع لـ 100,000 رمز. ويشمل ذلك كلًا من النص التوجيهي والإكمال. يمكنك توليد ما يصل إلى 16,000 رمز لكل طلب. اضبط الحد الأقصى الافتراضي لـ max_tokens على 2,048 إذا لزم الأمر. نصوصك التوجيهية لا تُستخدم للتدريب. الخصوصية محفوظة طوال العملية.

التدفق

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)