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

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

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

سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاحك على الفور. لا يلزم رقم هاتف. يبقى المفتاح صالحاً حتى تقوم بإلغائه. لا تستهلك الأخطاء رصيدك المدفوع مسبقاً، مما يضمن دفعك فقط مقابل استخدام الرمز الفعلي.

• رأس: Authorization: Bearer YOUR_API_KEY
• URL الأساسي: https://api.chatbotaiunrestricted.com/v1

POST /v1/chat/completions

The POST /v1/chat/completions نقطة النهاية تعالج مدخلاتك وتعيد مخرجات نصية. أرسل جسم JSON مع model تعيين إلى uncensored و messages مصفوفة. يستجيب النموذج بدون مرشحات المحتوى القياسية للاستخدام البالغ القانوني، مما يجعله مثاليًا للكتابة الإبداعية أو الأسئلة المباشرة.

تعيين max_tokens للتحكم في طول المخرجات. يمكنك طلب ما يصل إلى 16,000 رمز لكل طلب. تدعم نافذة السياق 100,000 رمز إجمالاً للسياق والإكمال معاً.

تكامل مكتبة Python

استخدم الرسمي openai حزمة Python للتفاعل مع واجهة برمجة التطبيقات. قم بتهيئة العميل بمفتاح واجهة برمجة التطبيقات وعنوان URL الأساسي المخصص. يتيح لك ذلك الاستفادة من هياكل الكود الحالية مع الوصول إلى النموذج غير المقيد.

ثبّت الحزمة عبر pip وابدأ العميل. مرر الرسائل كقائمة من القواميس. يحتوي كائن الاستجابة على النص المولد في choices[0].message.content. تعامل مع الاستثناءات لإدارة حدود المعدلات أو أخطاء المصادقة بسلاسة.

• الحزمة: openai
• URL الأساسي: يتطلب تكوينًا مخصصًا

تكامل Node SDK

يتبع SDK لـ Node.js نفس النمط. قم بتهيئة apiKey و baseURL الخصائص. يضمن ذلك وصول طلباتك إلى نقطة النهاية الصحيحة. استخدم chat.completions.create طريقة لإرسال الرسائل.

يتطابق هيكل الرد مع تنسيق OpenAI. استخرج المحتوى من الخيار الأول. تعمل هذه الطريقة مع كل من وحدات CommonJS و ES. توفر طريقة مباشرة لدمج الذكاء الاصطناعي غير المقيد في تطبيقات Node الخاصة بك.

البث مع أحداث الخادم (SSE)

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

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

معالجة الأخطاء واستخدام التوكن

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

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

حدود المعدلات والقيود

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

هذه الحدود تضمن أداءً مستقراً لجميع المستخدمين. إذا تجاوزت حد معدل الطلبات، ستتلقى خطأ 429. انتظر قبل إعادة المحاولة. نظام الرصيد المدفوع مسبقاً يعني أنك تدفع فقط مقابل ما تستخدمه. تسمح المدفوعات بالعملات المشفرة بإعادة التعبئة بسهولة باستخدام USDT أو USDC.

cURL

Copycurl https://api.chatbotaiunrestricted.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?"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)