توثيق API: التكامل السريع في 5 دقائق

إعداد البيئة والمصادقة

للبدء، يجب عليك استرداد مفتاح API الفريد الخاص بك من لوحة التحكم. سيُستخدم هذا المفتاح كمعرف لمصادقة طلباتك. على عكس النماذج العامة، يعتمد API الخاص بنا على نقطة النهاية القياسية التي تتيح لك استخدام واجهات برمجة التطبيقات الرسمية أو أي عميل متوافق مع OpenAI. لا تحتاج إلى تقديم رقم هاتف أو بطاقة ائتمان للوصول إلى رصيد التجربة الأولي.

نقطة النهاية الأساسية هي https://api.llmnoncensure.com/v1. تأكد من تكوين بيئتك لاستخدام هذا الرابط الأساسي المحدد. يجب تمرير مفتاح API عبر رأس Authorization: Bearer <YOUR_API_KEY>. يتم إنشاء مفتاح واحد لكل حساب؛ يمكنك إعادة توليد مفتاح في أي وقت، مما يؤدي إلى إلغاء سريان المفتاح القديم تلقائيًا.

أول طلب باستخدام cURL

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

إليك الهيكل الأساسي لاختبار الاتصال:

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

تسمح هذه الأمر بالتحقق من أن مفتاحك نشط وأن النموذج جاهز لاستقبال الموجّهات المعقدة.

التكامل مع SDK Python

إذا كنت تطور بلغة Python، استخدم مكتبة openai لتكامل سلس. عيّن متغير البيئة OPENAI_BASE_URL أو مرر base_url مباشرةً في العميل. يتيح ذلك إعادة استخدام الكود الموجود مع تغيير مصدر النموذج فقط. يتولى الـ SDK التعامل مع التحويل إلى صيغة JSON وأخطاء الشبكة نيابةً عنك.

إليك مثال بسيط:

Copierfrom openai import OpenAI

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

يقبل النموذج uncensored المعاملات القياسية مثل temperature و max_tokens. يمكنك ضبط إبداع الاستجابة دون الخوف من أن تمنع الذكاء الاصطناعي استجابة تُعتبر "محفوفة" وفقًا للمعايير العامة.

الاستخدام مع Node.js وJavaScript

لبيئات JavaScript أو TypeScript، يعمل SDK openai بنفس الطريقة. قم بتكوين العميل باستخدام الرابط الأساسي ومفتاح API. هذا النهج مثالي لتطبيقات الخلفية أو خوادم API التي تحتاج إلى دمج استجابات AI ديناميكية دون قيود المزودين الكبار.

Copierimport OpenAI from "openai";

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

تأكد من معالجة الاستجابات غير المتزامنة بشكل صحيح. تُعالج كل طلب بشكل فردي، مما يضمن عدم توقف منطق عملك بسبب تأخرات توليد النموذج. تتيح نافذة السياق التي تتسع لـ 100,000 رمز إرسال تعليمات نظام طويلة أو سجلات محادثات موسعة.

دعم البث المتدفق SSE

لتجربة مستخدم سلسة، فعّل البث المتدفق عبر أحداث الخادم المرسلة (SSE). هذا يسمح بعرض الاستجابة كلمة بكلمة بدلاً من انتظار انتهاء التوليد. هذا مفيد بشكل خاص لواجهات الدردشة حيث تكون زمن الاستجابة المتصور حاسمًا. تدفق البيانات منظم وفقًا لمعيار OpenAI، مما يسهل التحليل من جانب العميل.

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

لا يغير البث المتدفق منطق النموذج؛ إنه يغير فقط نقل البيانات. كل قطعة هي جزء من الاستجابة النهائية. يمكنك إيقاف البث في أي وقت إذا عدل المستخدم الموجّه، مما يحسن استخدام رصيدك.

حدّ المعدل، الأخطاء والنافذة السياقية

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