دليل البدء السريع لـ API بدون رقابة

التثبيت والمكتبات المطلوبة

تم تصميم API بدون رقابة ليعمل بشكل مباشر مع حزم SDK والعملاء الخاصين بـ OpenAI. للبدء في التكامل، كل ما عليك فعله هو تعيين قيمة base_url في الكود الحالي الخاص بك إلى https://api.sansursuzapi.com/v1 وتكوين مفتاح API الخاص بك. يكفي تثبيت حزمة SDK المناسبة للغة التي تستخدمها؛ لا حاجة إلى تكوين خادم إضافي أو آليات مصادقة معقدة. يستخدم نظامنا مصادقة الرمز المميز Bearer القياسية ونمرر المفتاح مباشرة في رؤوس الطلب.

مثال الطلب الأساسي

يمكنك تفعيل توليد النص بإرسال طلب POST بسيط لبدء استخدام الـ API. يوضح المثال التالي كيفية الوصول إلى نموذج uncensored عبر curl. يحدد جسم الطلب اسم النموذج ورسالة المستخدم وتنسيق الاستجابة. يتوافق هذا الهيكل مع مخطط chat-completions القياسي الخاص بـ OpenAI.

Kopyalacurl https://api.sansursuzapi.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."}]
  }'

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

البث واستدعاء الدوال

بالنسبة إلى كتل النص الكبيرة أو سيناريوهات سجلات المحادثات الطويلة، يمكنك استخدام وضع البث (streaming). يتيح لك هذا الوضع معالجة البيانات القادمة من الخادم قطعة بقطعة، مما يحسن تجربة المستخدم. كما يتم دعم ميزة استدعاء الدوال (function calling) التي تتيح للنموذج التفاعل مع الأدوات الخارجية. تتيح هذه الميزة للنموذج إرجاع البيانات وفقًا لمخطط JSON معين ومعالجتها في تطبيقك.

Kopyalafrom openai import OpenAI

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

Kopyalaimport OpenAI from "openai";

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

توفر حزم SDK الخاصة بـ Python و Node.js الأدوات اللازمة لإدارة هياكل البث واستدعاء الدوال. يمكنك الحصول على الاستجابة قطعة بقطعة باستخدام المعلمة stream: true، أو تكوين إنتاج البيانات بواسطة النموذج باستخدام هيكل tools.

قائمة النماذج والتوافق

توفر API الخاصة بنا حاليًا نموذج لغة كبير واحد فقط: uncensored. هذا النموذج مبني على أوزان مفتوحة تم ضبطها خصيصًا وتم تحسينه لإزالة التصفية الاصطناعية الموجودة في النماذج القياسية. يمكنك التحقق من النموذج الحالي عبر نقطة النهاية الخاصة بقائمة النماذج (GET /v1/models). يعمل النموذج على خوادم GPU الخاصة بنا بشكل مستقل عن سلاسل GPT أو Claude أو Gemini أو Grok الخاصة بـ OpenAI. يتيح لك هذا التوافق استخدام عملاء OpenAI الحاليين مباشرة.

رموز الأخطاء والحدود

رموز الحالة الرئيسية التي قد تواجهها أثناء استخدام API هي: 401 مفتاح API غير صالح أو مفقود، 402 عدم وجود رصيد كافٍ، و 429 تجاوز حد 300 طلب في الدقيقة. ينطبق مفتاح API واحد فقط لكل حساب؛ عند تجديد المفتاح، يصبح المفتاح القديم غير صالح. يجب ألا يتجاوز حجم جسم الطلب 8 ميجابايت. نافذة السياق (context window) محدودة بـ 100,000 رمز؛ وهذا يشير إلى إجمالي عدد الرموز لكل من الموجّه والنص المكتمل. هذه الحدود حاسمة لاستقرار عمل API.

التسعير وإدارة الرصيد

يعمل API بدون رقابة بنظام الدفع حسب الاستخدام (pay-as-you-go). يتم تحصيل رسوم 0.25 دولار لكل مليون رمز إدخال، و 1.00 دولار لكل مليون رمز إخراج. يتم حفظ الرصيد المدفوع إلى الأبد ولا توجد رسوم اشتراك. تحصل الحسابات الجديدة على رصيد تجريبي بقيمة 0.50 دولار صالح لمدة 7 أيام دون الحاجة إلى بطاقة ائتمان. عند نفاد الرصيد، لا يتم إيقاف الخدمة، بل يجب عليك شحن رصيد فقط للطلبات الجديدة. يتم تطبيق مكافأة +5% على شحنات 50 دولارًا، ومكافأة +10% على شحنات 100 دولار.

البث المتدفق

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