البدء السريع: واجهة برمجة التطبيقات لنموذج اللغات الكبير غير الخاضع للرقابة

المتطلبات الأساسية والتثبيت

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك المفضلة واعدد متغيرات البيئة. تتصرف واجهة برمجة التطبيقات الخاصة بنا تمامًا مثل نقطة نهاية OpenAI القياسية، لذا يمكنك استبدال المكتبات دون إعادة كتابة المنطق. نستخدم الرؤوس القياسية ولا نحتاج إلى حزم مخصصة. تحتاج فقط إلى مفتاح API صالح من لوحة التحكم.

تهيئة العميل

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

تكوين Python

اضبط عنوان URL الأساسي ومفتاح API قبل إجراء أي مكالمات. يعمل هذا الإعداد مع Python 3.8+.

Copyfrom openai import OpenAI

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

استخدم عميل Node الرسمي لتهيئة الاتصال. تأكد من تمرير سلسلة عنوان URL الأساسي الصحيحة.

Copyimport OpenAI from "openai";

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

أجرِ أول طلب لك

أرسل طلب POST قياسي لإكمال المحادثات مع تعيين معرف النموذج الخاص بك إلى uncensored. يقبل هذا النموذج أي إدخال قانوني دون تصفية المواضيع البالغة أو المثيرة للجدل. تعود الاستجابة ككتلة نصية كاملة. يمكنك اختبار الاتصال باستخدام أمر curl بسيط.

Copycurl https://api.promptuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

التعامل مع الاستجابات المتدفقة

فعّل البث عن طريق تعيين stream: true في جسم الطلب الخاص بك. يُعيد هذا البيانات عبر أحداث مُرسلة من الخادم (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)

تكوين المعلمات لأفضل النتائج

اضبط معلمات مثل درجة الحرارة وtop_p والبذرة للتحكم في الإبداع. تنتج درجات الحرارة الأعلى نصاً أكثر تنوعاً، بينما تضمن القيم الأقل الاتساق. يدعم النموذج استدعاء الوظائف القياسي ووضع JSON. يمكنك فرض تنسيقات مخرجات صارمة باستخدام response_format. تساعد هذه الضوابط في ضبط سلوك النموذج غير الخاضع للرقابة لحالة الاستخدام الخاصة بك.

فهم استخدام الرموز وحدودها

يدعم نافذة السياق 100,000 رمز للنص البرمجي والإكمال المجمع. يمكنك توليد ما يصل إلى 16,000 رمز لكل طلب. تحد حدود معدل الطلب من 300 طلب في الدقيقة لكل مفتاح. تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 أنك بحاجة إلى المزيد من الرصيد. يشير 429 إلى أنك وصلت إلى حد معدل الطلب. الرصيد غير المستخدم لا ينتهي صلاحيته أبداً.