AR ▾
nofilterai.top
NoFilter AI
احصل على مفتاح API

تطبيق لعب أدوار بالذكاء الاصطناعي بدون رقابة: ابنِ واحدًا باستخدام API

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

مسرح صغير متصل بتدفق بيانات متوهج بخادم، يوضح هندسة تطبيق لعب الأدوار

البنية في صورة واحدة

يُرسل المتصفح رسالة المستخدم إلى خادمك. يضيف خادمك الشخصية والسجل الحديث، ويستدعي النموذج بـ stream: true، ثم يعيد توجيه كل جزء إلى المتصفح. لا يتطلب الأمر أي شيء آخر.

  1. المتصفح: مربع نص وعنصر div ينمو مع وصول الرموز.
  2. خادمك: يحتفظ بمفتاح API، ويبني قائمة الرسائل، ويفرض حدودك الخاصة لكل مستخدم.
  3. واجهة برمجة النموذج: POST /v1/chat/completions عند https://api.nofilterai.top/v1 مع النموذج uncensored.
  4. التخزين: جدول أو ملف للرسائل لكل محادثة. SQLite كافٍ للبدء.

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

تصميم موجّه النظام

لألعاب الأدوار، يقوم موجّه النظام بمعظم العمل. قسّمه إلى ثلاثة كتل قصيرة بحيث يمكنك استبدال كل واحدة منها بشكل مستقل: العالم، والشخصية، وقواعد التنسيق.

{
  "world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
  "character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
  "format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}

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

الخلفية للبث المتدفق

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

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

const client = new OpenAI({
  baseURL: "https://api.nofilterai.top/v1",
  apiKey: process.env.API_KEY,
});

const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages

app.post("/chat", async (req, res) => {
  const { id, text, persona } = req.body;
  const history = store.get(id) ?? [];
  history.push({ role: "user", content: text });

  res.setHeader("Content-Type", "text/event-stream");
  res.setHeader("Cache-Control", "no-cache");

  const stream = await client.chat.completions.create({
    model: "uncensored",
    messages: [{ role: "system", content: persona }, ...trim(history)],
    stream: true,
    temperature: 0.9,
  });

  let reply = "";
  for await (const chunk of stream) {
    const piece = chunk.choices[0]?.delta?.content ?? "";
    if (piece) {
      reply += piece;
      res.write("data: " + JSON.stringify(piece) + "\n\n");
    }
  }
  history.push({ role: "assistant", content: reply });
  store.set(id, history);
  res.write("data: [DONE]\n\n");
  res.end();
});

app.listen(3000);

يحمل الجزء الأخير من البث معلومات الاستخدام، والتي يمكنك تسجيلها لمعرفة تكلفة كل محادثة. في الإنتاج، استبدل Map بقاعدة بيانات وأضف معالجة الأخطاء حول الاستدعاء.

تقليص السجل داخل نافذة الـ 100k

نافذة السياق تحتوي على 100,000 رمز للموجّه بالإضافة إلى الإكمال. جلسات لعب الأدوار تنمو ببطء، لكنها تنمو. دالة تقليم تعمل بالحجم تتجنب المفاجآت. تقدير تقريبي بحجم 4 أحرف لكل رمز كافٍ للميزانية.

function trim(history, maxChars = 120000) {
  let total = 0;
  const kept = [];
  for (let i = history.length - 1; i >= 0; i--) {
    total += history[i].content.length;
    if (total > maxChars) break;
    kept.unshift(history[i]);
  }
  return kept;
}

120,000 حرف تعادل حوالي 30,000 رمز، وهو أقل بكثير من الحد الأقصى، مما يبقي كل استدعاء رخيصاً. ارفعه فقط إذا كانت قصتك تحتاج إلى استرجاع طويل. تذكر قاعدة التكلفة: كل دور يعيد إرسال التاريخ المحفوظ كمدخلات بسعر $0.15 لكل مليون رمز، لذا فإن موجّه بحجم 30,000 رمز يكلف 30,000 / 1,000,000 × $0.15 = $0.0045 لكل دور قبل الرد.

عميل المتصفح

تقرأ الصفحة البث SSE بـ fetch وتلحق النص مع وصوله. نظرًا لأن الطلب هو POST، فإن EventSource لا يناسب، لذا قم بتحليل البث يدويًا.

async function send(text) {
  const out = document.getElementById("reply");
  out.textContent = "";
  const r = await fetch("/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
  });
  const reader = r.body.getReader();
  const dec = new TextDecoder();
  let buf = "";
  while (true) {
    const { value, done } = await reader.read();
    if (done) break;
    buf += dec.decode(value, { stream: true });
    const parts = buf.split("\n\n");
    buf = parts.pop();
    for (const p of parts) {
      if (p === "data: [DONE]") break;
      if (p.startsWith("data: ")) {
        out.textContent += JSON.parse(p.slice(6));
      }
    }
  }
}

الميزات التي تجعله يبدو كتطبيق

  • إعادة التوليد والتحرير. احتفظ بمعرفات الرسائل. تعني إعادة التوليد حذف رسالة المساعد الأخيرة واستدعاء واجهة برمجة التطبيقات مرة أخرى بنفس السجل. يعني التحرير إعادة كتابة رسالة مخزنة قبل الاستدعاء التالي.
  • إعدادات لكل شخصية. احفظ temperature، top_p والعقوبات مع كل شخصية. الشخصيات الهادئة تفضل 0.7، والفوضوية تفضل 1.0. مرر seed عندما تريد تشغيل اختبار قابل للتكرار.
  • عرض التكلفة. اقرأ رأس الاستجابة X-Balance-USD أو استدعِ GET /v1/balance وأظهر للمستخدم مقدار الرصيد المتبقي. إذا كنت تعيد بيع الوصول إلى خدمتك للمستخدمين الخاصين بك، فإن ذلك يوفر عليك الكثير من أسئلة الدعم.
  • حواجز السلامة التي تملكها. أضف بوابة للبالغين فقط، وزر للإبلاغ، وقاعدة تحظر أي طلب يتضمن قاصرين قبل وصوله إلى الـ API. تفرض المنصة هذا الحد أيضًا، لكن تطبيقك يجب أن يفعل ذلك أيضًا.

الحدود والأخطاء والميزانيات

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يحتفظ الطلب المتدفق بمكان في السعة حتى ينتهي البث، لذا سيصل تطبيق لعب الأدوار مع 20 مستخدمًا نشطًا إلى الحد الأقصى خلال الدقائق المزدحمة. يجيب الـ API بـ HTTP 429 مع الرمز concurrency أو rate_limited، ويضيف في حالات الحمل الزائد المؤقت Retry-After: 5. صفّ الطلبات على خادمك وأعد المحاولة بعد هذا التأخير.

الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا لا تكلفك إعادة المحاولة شيئاً. للموازنة، يكلف الدور النموذجي المكون من 3,000 رمز مدخلات و300 رمز مخرجات $0.00045 + $0.00015 = $0.0006. الرصيد مسبق الدفع من $20 ولا ينتهي. يقبل هذا الموقع العملات المشفرة، USDT على TRC20 أو USDC على Base؛ صفحة الأسعار توضح المكافآت من $50 فما فوق.

إلى أين تذهب بعد ذلك

احصل على مفتاح واختبره مع الرصيد التجريبي المجاني: توفر صفحة مفتاح API رصيدًا بقيمة $0.50 بعد تسجيل الدخول، صالح لمدة 7 أيام، دون الحاجة لتفاصيل الدفع. يسمح مفتاح التجربة بـ 2 طلبات متزامنة، وهو كافٍ لنموذج أولي لمستخدم واحد. تذكر الوثائق كل معلمة، بما في ذلك استدعاء الأدوات إذا كنت تريد أن تُعامل رمي النرد أو المخزون كاستدعاءات دوال.

للحصول على نسخة بأسلوب رفيق مع شخصية واحدة ثابتة، اطّلع على مقال API رفيق الذكاء الاصطناعي. ولروبوت دردشة داخل خادم، اقرأ دليل بوت Discord.

أسئلة وأجوبة

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

يمكنك ذلك، لكنك ستكشف مفتاحك لكل زائر. احتفظ بالمفتاح على خادم واعرض فقط المسار الخاص بك.

كيف أمنع النموذج من كتابة أفعال شخصيتي؟

اذكر ذلك في موجّه النظام، وإذا كنت تستخدم تنسيق المحادثة، أضف تسلسل توقف. كلاهما يعمل مع معاملات الإرسال المباشر.

هل يحتاج التطبيق إلى تخزين المحادثات؟

الـ API نفسه عديم الحالة، لذا تعيد إرسال سجل المحادثة في كل دور. لا تُستخدم الموجّهات للتدريب.

ما هي أرخص طريقة للنمذجة الأولية؟

استخدم مفتاح التجربة و Map في الذاكرة. انتقل إلى قاعدة بيانات ومفتاح ممول بمجرد أن تعمل الحلقة.

مفتاحك على بُعد استمارة واحدة

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

احصل على مفتاح API