EmbeddingApis/الدليل
واجهة API نصية بلا رقابة لخط العمل (pipeline) الخاص بك
أنشئ روبوت محادثة يعتمد على نموذج لغوي كبير باستخدام واجهة برمجة تطبيقات على غرار OpenAI
روبوت الدردشة المدعوم بنموذج لغوي كبير هو حلقة: أخذ رسالة المستخدم، وإضافتها إلى سجل محفوظ، وإرسال ذلك السجل إلى النموذج، ثم نشر الرد. يبني هذا الدليل هذه الحلقة في Python، ثم يغلفها لـ Discord ويغطي حدود المعدل والتكلفة.
تم التحديث
نقاط رئيسية
النموذج عديم الحالة، لذا يجب على روبوتك تخزين وإعادة إرسال السجل.
استخدم النموذج uncensored مع حزمة SDK الخاصة بـ OpenAI وعنوان URL الأساسي للموقع.
حدد التزامن عند 8 وأدرج الباقي في قائمة انتظار لتجنب أخطاء 429.
تتكلف دورة محادثة نموذجية جزءاً صغيراً من سنت واحد.

ما يجب أن يفعله البوت
لا يتذكر الـ API أي شيء بين الطلبات. يجب أن يحتوي كل طلب على كامل المحادثة التي تريد أن يراها النموذج. لذا، فإن عمل بوت الدردشة هو في الغالب إدارة للبيانات: الاحتفاظ بقائمة من الرسائل لكل مستخدم أو قناة، إضافة الرسالة الجديدة، إرسال القائمة، تخزين الإجابة وتكرار العملية.
هذه الخدمة هي واجهة برمجة تطبيقات (API) نصية فقط متوافقة مع OpenAI. تعمل باستمارة واحدة مفتوح الأوزان، ويشغّله مزوّد مستقل ومضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. لا توجد نقطة نهاية للصور أو الصوت أو التضمينات، على الرغم مما قد يوحي به اسم النطاق، لذا فإن كل ما يلي يتعلق بإكمال الدردشة. لا يُسمح بمحتوى جنسي يتضمن القاصرين.
الحلقة الأساسية في Python
ثبّت الـSDK باستخدام pip install openai، وعيّن مفتاحك كمتغير API_KEY، وابدأ بنسخة وحدة التحكم. إذا لم يكن لديك مفتاح بعد، فإن صفحة مفتاح API تقدم رصيداً تجريبياً بقيمة $0.50 عند إنشاء الحساب.
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.embeddingapis.com/v1", api_key=os.environ["API_KEY"])
SYSTEM = "You are Mira, a friendly assistant for a game community. Keep answers short."
history = [{"role": "system", "content": SYSTEM}]
def reply(user_text: str) -> str:
history.append({"role": "user", "content": user_text})
resp = client.chat.completions.create(
model="uncensored",
messages=history,
temperature=0.8,
max_tokens=400,
)
text = resp.choices[0].message.content
history.append({"role": "assistant", "content": text})
return text
while True:
print(reply(input("you> ")))
هذا بوت يعمل. كل ما تبقى في هذا المقال يجعله آمنًا للتشغيل من قبل العديد من الأشخاص في وقت واحد.
اكتب موجّه نظام يصمد
رسالة النظام هي المكان الذي يحصل فيه البوت على اسمه، نبرته وحدوده. بعض العادات تجعله يثبت عبر المحادثات الطويلة:
- حدد الدور والجمهور في جملة أو جملتين.
- قدم قواعد التنسيق: الطول، اللغة، ما إذا كان يجب استخدام القوائم.
- اذكر ما يجب أن يفعله البوت عندما لا يعرف شيئًا، مثل طرح سؤال.
- ضع الحقائق الدائمة، مثل قواعد الخادم أو تفاصيل المنتج، في رسالة النظام وليس في أدوار الدردشة.
بالنسبة للبوتات الخيالية، وتمثيل الأدوار، وبوتات الرفقة للبالغين، أضف الإعداد وصوت الشخصية هنا، وقل إن الشخصية تظل في دورها ما لم يخرج المستخدم عن ذلك. اختبر الموجّه مع عشر أو خمس عشرة رسالة صعبة قبل نشر البوت.
احتفظ بسجل واحد لكل محادثة
قائمة عالمية مثل تلك المذكورة أعلاه ستخلط جميع المستخدمين معاً. احفظ سجلاً منفصلاً لكل قناة Discord أو معرف دردشة Telegram أو جلسة ويب. يعمل القاموس للنموذج الأولي؛ استخدم قاعدة البيانات عندما يجب أن يتحمل الروبوت عمليات إعادة التشغيل.
السياق كبير: 100,000 رمز تغطي الموجّه والرد معًا. ومع ذلك، لا ترسل كل شيء إلى الأبد. السجلات الطويلة تكلف أكثر في كل خطوة وتبطئ الإجابة. سياسة بسيطة هي الاحتفاظ برسالة النظام بالإضافة إلى آخر 20 رسالة:
histories = {}
def trim(msgs, keep=20):
return [msgs[0]] + msgs[1:][-keep:]
def reply_for(chat_id, user_text):
msgs = histories.setdefault(chat_id, [{"role": "system", "content": SYSTEM}])
msgs.append({"role": "user", "content": user_text})
msgs[:] = trim(msgs)
resp = client.chat.completions.create(model="uncensored", messages=msgs)
text = resp.choices[0].message.content
msgs.append({"role": "assistant", "content": text})
return text
بالنسبة للبوتات التي تحتاج إلى ذاكرة طويلة، مثل الرفقاء، قم بتلخيص الرسائل الأقدم في ملاحظة قصيرة كل فترة من الوقت واحتفظ بالملاحظة في أعلى السجل.
نسخة Discord
مع مكتبة discord.py، يرد الروبوت عند ذكره. استدعاءات الـAPI تعيق التنفيذ، لذا شغّلها في خيط للحفاظ على اتصال Discord نشطاً.
import asyncio, os
import discord
from openai import OpenAI
client = OpenAI(base_url="https://api.embeddingapis.com/v1", api_key=os.environ["API_KEY"])
intents = discord.Intents.default()
intents.message_content = True
bot = discord.Client(intents=intents)
slots = asyncio.Semaphore(8)
histories = {}
SYSTEM = "You are Mira, a friendly assistant. Keep answers under 120 words."
def ask(chat_id, text):
msgs = histories.setdefault(chat_id, [{"role": "system", "content": SYSTEM}])
msgs.append({"role": "user", "content": text})
msgs[:] = [msgs[0]] + msgs[1:][-20:]
r = client.chat.completions.create(model="uncensored", messages=msgs, max_tokens=300)
out = r.choices[0].message.content
msgs.append({"role": "assistant", "content": out})
return out
@bot.event
async def on_message(message):
if message.author.bot or bot.user not in message.mentions:
return
async with slots:
async with message.channel.typing():
text = await asyncio.to_thread(ask, message.channel.id, message.clean_content)
await message.reply(text[:1900])
bot.run(os.environ["DISCORD_TOKEN"])
نفس دالة ask تتصل ببوت Telegram (python-telegram-bot) أو نقطة نهاية ويب صغيرة دون تغييرات. الجزء الوحيد الذي يختلف هو الجزء الذي يستقبل ويرسل الرسائل.
حدود المعدل، البث المتدفق والأخطاء
يسمح المفتاح الكامل بـ8 طلبات متزامنة و300 طلب في الدقيقة. يسمح المفتاح التجريبي بـ2 و60. يحافظ السيمافور (semaphore) في مثال Discord على بقائك ضمن حدّ التزامن بجعل الرسائل الإضافية تنتظر. إذا رأيت خطأ HTTP 429، اقرأ رمز الخطأ: يعني rate_limited تجاوز الحد في الدقيقة، يعني concurrency تجاوز الحد في آن واحد، ويعني رأس Retry-After: 5 حملاً زائداً مؤقتاً. انتظر 5 ثوانٍ وحاول مرة أخرى.
لنافذة دردشة الويب، اضبط stream على true وأرسل الرموز إلى المتصفح عند وصولها، ليظهر النص للمستخدمين بدلاً من الانتظار. يحتفظ البث المتدفق بخانة تزامن حتى ينتهي، لذا أغلقه عندما يغادر الزائر. الطلبات الفاشلة أو المرفوضة لا تُحسب، وكل استجابة تتضمن X-Balance-USD، الذي يمكنك استخدامه لتنبيه نفسك قبل نفاد الرصيد.
قواعد مجتمعك
النموذج بدون رقابة يجيب بصراحة أكبر من معظم المساعدين المستضافين، لذا قرر ما يجب أن يفعله البوت الخاص بك. النموذج مخصص للاستخدام القانوني للبالغين، والمحتوى الجنسي الذي يتضمن قاصرين هو حدّ صارم للخدمة. إذا كان البوت يعمل على خادم Discord عام أو في مجموعة Telegram، أضف التالي بنفسك:
- التحقق من العمر أو تقييد للقنوات المحددة للبالغين عندما يكون البوت مهيأً للخيال الموجّه للبالغين.
- سطر في موجّه النظام يحدد المواضيع والنبرة المسموح بها في هذا المكان.
- أمر قصير، مثل
/reset، الذي يمسح السجل المخزن ليتمكن المستخدمون من البدء من جديد. - حدّ معدل أساسي لكل مستخدم، على سبيل المثال طلب واحد كل بضع ثوانٍ، بحيث لا يستطيع شخص واحد استخدام جميع فتحات الطلبات المتزامنة البالغ عددها 8.
قواعد المنصات من Discord أو Telegram أو مضيف الويب الخاص بك لا تزال سارية على الروبوت. اقرأها قبل أن تدعو الروبوت إلى خادم.
شغّله بشكل حقيقي
النموذج الأولي على جهازك المحمول يصبح خدمة عندما يتحمل عمليات إعادة التشغيل ويخبرك عند حدوث عطل. قائمة مراجعة معقولة:
- احتفظ بالمفتاح في متغير بيئة أو مخزن أسرار، وليس في المستودع.
- احفظ السجلات في SQLite أو Redis باستخدام معرف الدردشة كمفتاح، واحذف تلك الخاملة منذ أيام.
- سجّل
X-Request-Idوحالة HTTP لكل استدعاء لتتبع الردود الغريبة. - اقرأ
X-Balance-USDمن رؤوس الاستجابة وأنذر نفسك عندما ينخفض الرصيد دون مستوى تختاره. - اضبط مهلة زمنية على العميل، على سبيل المثال 60 ثانية، وأرسل رسالة اعتذار قصيرة إذا انقضت.
client = OpenAI(base_url="https://api.embeddingapis.com/v1", api_key=os.environ["API_KEY"], timeout=60, max_retries=2)
اضبط إعدادين أولاً عندما تبدو الردود غير صحيحة. اخفض temperature نحو 0.5 للمساعدين الواقعيين، وارفعه نحو 1.0 للشخصيات الإبداعية. استخدم تسلسلات stop إذا كان النموذج يميل لكتابة سطر المستخدم التالي، و frequency_penalty صغير إذا كان يكرر نفسه.
تكلفة الدردشة
التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. خذ روبوتاً يتعامل مع 1,000 دورة في اليوم، حيث ترسل كل دورة حوالي 2,000 رمز إدخال (موجه النظام زائد السجل) ويعيد حوالي 300 رمز.
- الإدخال: 1,000 × 2,000 = 2,000,000 رمز، وهو 2 × $0.15 = $0.30.
- الإخراج: 1,000 × 300 = 300,000 رمز، وهو 0.3 × $0.50 = $0.15.
- المجموع: $0.45 في اليوم لـ1,000 دورة.
تقليص السجل هو الرافعة الرئيسية، حيث تهيمن رموز الإدخال. الرصيد مسبق الدفع، لا ينتهي، ولا يوجد اشتراك. قم بشحن الرصيد بأي مبلغ صحيح من $20 إلى $500، بالعملات المشفرة فقط (USDT على TRC20، USDC على Base)، مع مكافأة +5% من $50، و+10% من $100، و+15% من $200. انظر صفحة التسعير للتفاصيل والمستندات للحصول على قائمة المعاملات الكاملة. لا تُستخدم الموجّهات للتدريب.
المزيد من الأدلة
أسئلة وأجوبة
هل أحتاج مكتبة خاصة لبناء بوت دردشة LLM مع هذا API؟
لا. تعمل حزم SDK الرسمية من OpenAI بعد ضبط عنوان URL الأساسي ومفتاح API. استخدم معرف النموذج uncensored.
هل يتذكر الـ API الرسائل السابقة؟
لا. يجب إرسال سجل المحادثة مع كل طلب. احفظه لكل محادثة وقصّه مع نموه.
كم عدد المستخدمين الذين يمكن للروبوت خدمتهم في وقت واحد؟
يسمح المفتاح الكامل بإجراء 8 طلبات متزامنة و300 طلب في الدقيقة. ضع الرسائل الزائدة في قائمة انتظار لضمان بقاء الروبوت ضمن هذه الحدود.
هل يمكنني الدفع بالبطاقة؟
نعم. تقبل عمليات شحن الرصيد بالعملات المشفرة (USDT على TRC20، USDC على Base)، من $20 إلى $500.
هل يمكن للروبوت نفسه إنشاء تضمينات أو صور؟
لا. الخدمة مخصصة للنصوص فقط، ولا توفر نقاط نهاية للتضمينات أو الصور أو الصوت أو الفيديو.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.