تكامل سريع لنموذج كبير بدون رقابة عبر API

الإعداد الأساسي

الوصول إلى بوابة API يعتمد بشكل أساسي على تكوين عنوان URL الأساسي (Base URL) وبيانات المصادقة بشكل صحيح. خدمتنا متوافقة تمامًا مع بروتوكول OpenAI؛ ما عليك سوى تعيين عنوان URL الأساسي إلى https://api.llmzhongzhuan.com/v1 وإرفاق مفتاح API الخاص بك في رؤوس الطلب.

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

واجهة المحادثة التوليدية

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

يعمل النموذج على خوادم GPU عالية الأداء مُدارة بشكل مستقل، مع نافذة سياق تصل إلى 100,000 رمز (token). سواء كان ذلك لمعالجة النصوص الطويلة أو اتباع التعليمات المعقدة، فإننا نوفر تجربة وصول مباشرة إلى واجهة برمجة التطبيقات (API) مستقرة.

复制curl https://api.llmzhongzhuan.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."}]
  }'

الاستجابة المتدفقة (SSE)

لتطبيقات تحتاج إلى ملاحظات فورية، فعّل المعلمة stream: true للحصول على استجابات مجزأة عبر أحداث الإرسال من الخادم (SSE). يقلل البث المتدفق بشكل كبير من زمن ظهور الكلمة الأولى (TTFT)، مما يحسن تجربة المستخدم.

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

复制from openai import OpenAI

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

الاستعلام عن قائمة النماذج

يمكنك الحصول على قائمة النماذج المتاحة حاليًا عبر GET /v1/models. سيعيد الطلب استجابة JSON قياسية تحتوي على حقول id، وobject، وowned_by، وغيرها.

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

复制import OpenAI from "openai";

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

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

تتبع الخدمة معايير رموز حالة HTTP القياسية. يشير 401 Unauthorized إلى أن مفتاح API غير صالح؛ يشير 402 Payment Required إلى أن رصيد الحساب غير كافٍ، ويجب شحن الرصيد قبل مواصلة الطلبات؛ يشير 429 Too Many Requests إلى تجاوز حدّ المعدل، والحد الحالي هو 300 طلب في الدقيقة.

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

复制stream = 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)

أكواد الأمثلة

يُعد ما يلي مثالاً كاملاً لإجراء طلب متدفق باستخدام Python SDK. يوضح الكود كيفية تهيئة العميل، وبناء سجل الرسائل، ومعالجة تدفق بيانات SSE.

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