AR ▾
Uncensored Chatbot APIوصول مباشر إلى واجهة برمجة التطبيقات لنموذج LLM غير خاضع للرقابةاحصل على مفتاح API

Uncensored Chatbot APIالسلامة

تكامل واجهة برمجة تطبيقات روبوت الدردشة: توصيل نقطة نهاية الدردشة بتطبيقك

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

تم التحديث

أنبوب زجاجي يربط مكعب المتصفح ومكعب الخادم عبر بوابة مقفلة، يُظهر وسيط دردشة للخلفية

نقاط رئيسية

  • يتحدث المتصفح مع خادمك؛ يتحدث خادمك مع واجهة برمجة تطبيقات روبوت الدردشة بالمفتاح.
  • بث الأحداث المرسلة من الخادم بحيث تظهر الردود كلمة بكلمة.
  • حدد الحد الأقصى للسجل، اضبط الحدود لكل مستخدم وتعامل مع استجابات 429 بفترة انتظار قصيرة.
  • نقطة النهاية متوافقة مع OpenAI، لذا يعمل SDK الرسمي بعد تغيير عنوان URL الأساسي.

النمط في صورة واحدة

كل تكامل واجهة برمجة التطبيقات (API) لـ دردشة روبوت آمن يبدو متشابهًا من الأعلى. ترسل صفحة في المتصفح رسالة المستخدم إلى نقطة النهاية الخاصة بك. يضيف خادمك موجّه النظام، ويقصر السجل، ويلصق مفتاح API ويحوّل الطلب. تعود الإجابة عبر البث المتدفق بنفس الطريقة.

Browser  --POST /api/chat-->  Your server  --POST /v1/chat/completions-->  Chat API
Browser  <--SSE stream------  Your server  <--SSE stream-----------------  Chat API

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

تتبع الواجهة API تنسيق OpenAI. عنوان URL الأساسي هو https://api.uncensoredchatbotapi.com/v1، والنموذج هو uncensored، والمصادقة هي Authorization: Bearer YOUR_KEY. احصل على مفتاح من صفحة المفتاح.

الخطوة 1: وسيط الخادم

يقبل خادم Express هذا محادثةً، ويضيف موجّه النظام، ويستدعي الـ API مع البث المتدفق، ثم يعيد توجيه النص. ثبّت التبعيات باستخدام npm i express openai، واضبط المتغير CHAT_API_KEY في بيئة التشغيل.

import express from "express";
import OpenAI from "openai";

const app = express();
app.use(express.json({ limit: "200kb" }));
app.use(express.static("public"));

const client = new OpenAI({
  baseURL: "https://api.uncensoredchatbotapi.com/v1",
  apiKey: process.env.CHAT_API_KEY,
});

const SYSTEM = "You are a helpful companion for adults. Keep replies under 150 words.";

app.post("/api/chat", async (req, res) => {
  const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
  const clean = incoming
    .filter((m) => ["user", "assistant"].includes(m.role) && typeof m.content === "string")
    .slice(-20)
    .map((m) => ({ role: m.role, content: m.content.slice(0, 4000) }));

  res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache" });
  try {
    const stream = await client.chat.completions.create({
      model: "uncensored",
      messages: [{ role: "system", content: SYSTEM }, ...clean],
      stream: true,
    });
    for await (const part of stream) {
      const t = part.choices[0]?.delta?.content;
      if (t) res.write(`data: ${JSON.stringify(t)}\n\n`);
    }
    res.write("data: [DONE]\n\n");
  } catch (e) {
    res.write(`event: error\ndata: ${JSON.stringify(e.status === 429 ? "busy" : "failed")}\n\n`);
  }
  res.end();
});

app.listen(3000);

لاحظ الفلتر. يمكن للعميل إرسال أي شيء، لذا يحتفظ الخادم برسائل user و assistant فقط، ويقصر كل منها، ويتجاهل أي رسالة system يحاول المتصفح حقنها. يأتي موجّه النظام دائمًا من الكود الخاص بك.

الخطوة 2: جانب المتصفح

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

const messages = [];

async function send(text, out) {
  messages.push({ role: "user", content: text });
  const res = await fetch("/api/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ messages }),
  });

  const reader = res.body.getReader();
  const dec = new TextDecoder();
  let reply = "", buf = "";

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    buf += dec.decode(value, { stream: true });
    const events = buf.split("\n\n");
    buf = events.pop();
    for (const ev of events) {
      if (ev === "data: [DONE]") break;
      if (ev.startsWith("data: ")) {
        reply += JSON.parse(ev.slice(6));
        out.textContent = reply;
      }
    }
  }
  messages.push({ role: "assistant", content: reply });
}

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

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

يسمح المفتاح الكامل بإجراء 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح المفتاح التجريبي بإجراء 2 و60. يشغل الطلب الذي يستخدم البث المتدفق دوره حتى انتهاء التدفق، لذا يمكنك تقديم 8 ردود حية في آن واحد كحد أقصى. إذا كان موقعك يحتوي على مستخدمين متزامنين أكثر من ذلك، قم بترتيب الطلبات في خادمك وأجب بـ "انتظر لحظة" بدلاً من فشل الطلب.

  • 429 مع concurrency: عدد كبير من الطلبات قيد التنفيذ. رتّب الطلبات وأعد المحاولة.
  • 429 مع rate_limited: عدد كبير من الطلبات في الدقيقة. أبطئ.
  • 429 مع رأس Retry-After: 5: حمل زائد مؤقت. انتظر 5 ثوانٍ وحاول مرة أخرى.
  • 401: مفتاح خاطئ أو مفقود.
  • جسم الطلب فوق 8 MB: مرفوض، لذا قم بتقليص ما ترسله.

أضف عداداً صغيراً في الذاكرة المؤقتة حتى لا يفتح خادمك الخاص أكثر من 8 تدفقات للواجهة الخلفية:

let active = 0;
const MAX = 8;

app.use("/api/chat", (req, res, next) => {
  if (active >= MAX) return res.status(503).json({ error: "busy" });
  active++;
  res.on("close", () => { active--; });
  next();
});

سجّل هذا الوسيط قبل مسار الدردشة. يُطلق حدث close عندما تنتهي الاستجابة أو يغادر المستخدم، لذا لا يتسرب العداد.

التحكم في تكلفة كل محادثة

السعر هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. لأن كل دور يعيد إرسال السجل، فإن الحد الأقصى للسجل هو أكبر رافعة لديك. مع آخر 20 رسالة بحوالي 60 رمزًا لكل منها بالإضافة إلى موجّه نظام بحجم 100 رمز، يحمل الطلب حوالي 1,300 رمز إدخال. تضيف إجابة بحجم 150 رمزًا للإخراج.

التكلفة لكل دور: 1,300 / 1,000,000 × $0.15 = $0.000195، زائد 150 / 1,000,000 × $0.50 = $0.000075، أي $0.00027. جلسة مكونة من 30 دورًا بحجم هذا الطلب تكلف $0.0081 كحد أقصى، لأن الأدوار الأولى أقصر. حدود كل مستخدم يوميًا، على سبيل المثال 100 رسالة، تحد من أسوأ حالة بـ 100 × $0.00027 = $0.027 لكل مستخدم في اليوم. لمزيد من المعلومات حول تسعيم روبوت موقع، اقرأ الصفحة على تكلفة دردشة روبوت في موقع، واستخدم المستندات للمعلمات مثل max_tokens.

من الذي يستدعي الوكيل الخاص بك

يحمي الوسيط المفتاح، لكنه يصبح أيضاً نقطة نهاية دردشة مجانية لأي شخص يجد عنوان URL. قرر من يمكنه استخدامه قبل الإطلاق.

لموقع عام، تكون ملفات تعريف الارتباط للجلسة الموقعة المحددة عند تسجيل الدخول هي الإجابة المعتادة. تحقق منها في بداية المسار وأرجع 401 عندما تكون مفقودة. لنموذج أولي سريع، يعد حد كل عنوان IP مع حزمة مثل express-rate-limit أفضل من لا شيء، على الرغم من أن الشبكات المشتركة تجعل حدود عنوان IP غير دقيقة. مهما اخترت، احسب الرسائل لكل مستخدم، وليس لكل اتصال، واحفظ العداد في مكان لا يمكن لإعادة التشغيل إعادة تعيينه.

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

قبل الإطلاق

تضمن قائمة التحقق القصيرة هدوء يوم الإطلاق.

  1. يعيش المفتاح فقط في متغير بيئة على الخادم، ولا يحتوي المستودع عليه.
  2. يتجاهل الخادم أي رسالة نظام من العميل.
  3. لدى كل مستخدم حد لعدد الرسائل يومياً وحد لطول الرسالة.
  4. تعرض الأخطاء رسالة ودودة ولا تطبع تفاصيل النظام الداخلية أبدًا.
  5. تقوم بتسجيل معرفات الطلبات من رأس X-Request-Id وعدد الرموز، وليس النص الكامل.
  6. راقب X-Balance-USD واحصل على تنبيه عندما يوشك الرصيد على النفاد.
  7. تنص شروط الخدمة على جمهور البالغين فقط، ولا ينتج البوت أبدًا محتوى جنسيًا يتضمن القاصرين.

النقطة الأخيرة مشتركة مع التوجيهات حول أمان دردشة روبوت للبالغين. النموذج الذي يقف وراء هذه الواجهة البرمجية (API) مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعل قواعد التحقق من العمر والإشراف على المحتوى الخاصة بك أكثر أهمية، وليس أقل. الشحنات هنا هي العملات المشفرة فقط (USDT على TRC20 أو USDC على Base)، من $20 إلى $500، ويمكن للمستخدمين الجدد المطالبة برصيد تجريبي بقيمة $0.50 أولاً.

أسئلة وأجوبة

لماذا لا يمكنني استدعاء الـ API مباشرة من JavaScript في المتصفح؟

لأن المفتاح سيكون مرئيًا لأي شخص يفتح علامة تبويب الشبكة. وسيط الخادم يبقي المفتاح على خادمك ويسمح لك بإضافة حدود لكل مستخدم.

هل تدعم الـ API البث المتدفق؟

نعم. اضبط stream إلى true وترسل الـ API أحداثًا مرسلة من الخادم (SSE)، مع بيانات الاستخدام في النهاية. يمكن للوسيط الخاص بك إعادة بث تلك الأحداث إلى المتصفح.

أي SDK يجب أن أستخدم؟

أي SDK من OpenAI أو عميل HTTP يعمل. غيّر عنوان URL الأساسي إلى https://api.uncensoredchatbotapi.com/v1، واستخدم مفتاحك، واضبط النموذج على uncensored.

ماذا يحدث إذا تحدث الكثير من المستخدمين في آن واحد؟

المفتاح الكامل يسمح بـ 8 طلبات متزامنة. عند تجاوز ذلك، تُعيد الـ API رمز الخطأ 429 مع رمز concurrency، لذا قم بترتيب الطلبات الإضافية في خادمك وأعد المحاولة بعد فترة وجيزة.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح APIاقرأ التوثيق