توثيق واجهة برمجة التطبيقات

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

يصادق مفتاح واجهة برمجة التطبيقات (API) على طلباتك. أنشئ واحدًا عبر Google أو البريد الإلكتروني على احصل على مفتاح API صفحة. احفظه بأمان. استخدم عنوان URL الأساسي هذا لجميع المكالمات: https://api.whatisuncensoredai.com/v1.

اضبط Authorization الرأس إلى Bearer YOUR_API_KEY. يحدد المفتاح حسابك المدفوع مسبقًا. الأخطاء والرفض لا تستهلك رموزًا. فقط الإكمالات الصالحة تُخصم من رصيدك.

نقطة نهاية إكمال الدردشة

أرسل الرسائل إلى النموذج غير الخاضع للرقابة الوحيد عبر طلبات POST. نقطة النهاية هي /v1/chat/completions. مرر معرّف النموذج كـ uncensored. لا يرفض النموذج المواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل.

هيكل حمولة JSON الخاصة بك مع messages مصفوفة. كل رسالة تحتوي على role و content. تُعيد الـ API النص المُولّد في الاستجابة.

Copycurl https://api.whatisuncensoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 100 lines of code for a basic API."}]
  }'

نقطة نهاية سرد النماذج

اكتشف النماذج المتاحة بطلب GET بسيط. اتصل /v1/models لعرض نقاط النهاية. النموذج الوحيد المتاح هو uncensored. إنه نموذج مفتوح المصدر مضبوط للتوليد غير المقيد. إنه ليس GPT أو Claude أو أي نموذج لمورد آخر.

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

البث وبيانات الاستخدام

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

قم بتحليل تدفق 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)

المعاملات ووضع JSON

تحكّم في التوليد باستخدام المعاملات القياسية. استخدم temperature للعشوائية. اضبط top_p للعينة النواة. مكن وضع JSON مع response_format: {"type": "json_object". هذا يضمن مخرجات مهيكلة للمحللات.

خيارات أخرى تشمل stop التسseqs، seed للتكرار، والعقوبات على الوجود والتكرار. يعمل استدعاء الوظائف مع tools و tool_choice. اضبط هذه لتناسب سير عملك.

Copyfrom openai import OpenAI

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

حدود المعدلات ومعالجة الأخطاء

يتيح كل مفتاح 300 طلب في الدقيقة و8 طلبات متزامنة. يجب أن يبقى حجم جسم الطلب أقل من 8 ميجابايت. يؤدي تجاوز هذه الحدود إلى إرجاع رمز الحالة 429. انتظر وأعد المحاولة. استخدم زيادة الأثر الأسي للمتانة.

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

Copyimport OpenAI from "openai";

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