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

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

عنوان URL الأساسي لجميع الطلبات هو https://api.uncesoredai.com/v1. تقوم بالمصادقة عن طريق تمرير مفتاح API الخاص بك في Authorization رأس الصفحة كرمز حامل (Bearer token). هذا الإعداد يعمل مع أي عميل أو مكتبة SDK متوافقة مع OpenAI. تتلقى مفتاحك على الفور بعد التسجيل باستخدام Google أو عنوان بريد إلكتروني. لا حاجة لرقم الهاتف لإنشاء الحساب. مفتاحك فريد لحسابك ويستبدل أي مفتاح نشط سابق.

الطلب الأول

أرسل إكمال عن طريق الإرسال POST إلى /v1/chat/completions. معرف النموذج هو uncensored. تقبل نقطة النهاية هذا إدخالاً نصياً وتعيد إخراجاً نصياً. لا تدعم التضمينات أو الصور أو الصوت. يمكنك البدء بإرسال مطالبة نظام بسيطة ورسالة مستخدم. تستجيب واجهة برمجة التطبيقات بنص مُولّد بناءً على تعليماتك. لا تستهلك الأخطاء والرفضات رصيدك المدفوع مسبقاً.

Copycurl https://api.uncesoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source LLMs for local deployment"}]
  }'

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

استخدم مكتبة بايثون الرسمية من OpenAI للتفاعل مع واجهة برمجة التطبيقات. قم بتعيين عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا وقدم مفتاح واجهة برمجة التطبيقات الخاص بك. تتولى المكتبة عمليات التسلسل وتنسيق الطلب تلقائيًا. يمكنك تحديد النموذج على أنه uncensored للتوليد غير المقيد. يدعم الوضعين المتدفق (Streaming) وJSON عبر واجهة العميل نفسها. يقلل هذا النهج من الكود الإضافي (boilerplate) في تطبيقاتك.

Copyfrom openai import OpenAI

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

يتبع SDK لـ Node.js نفس نمط التكوين. قم بتكوين عنوان URL الأساسي ومفتاح API في مثيل العميل. اضبط اسم النموذج على uncensored للوصول إلى النموذج غير المقيد. يمكنك إرسال طلبات متزامنة أو غير متزامنة اعتماداً على حالة الاستخدام الخاصة بك. يدير SDK مجموعة الاتصال وإعادة المحاولة تلقائياً. يضمن هذا تكاملاً موثوقاً في مشاريع JavaScript أو TypeScript الخاصة بك.

Copyimport OpenAI from "openai";

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

استجابات البث

فعّل البث عن طريق تعيين 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)

حدود، أخطاء، والسياق

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