البدء السريع: قم بدمج دردشة apertus ai

المتطلبات الأساسية والإعداد

ابدأ بإنشاء حساب والحصول على مفتاح API الخاص بك. اشترك باستخدام Google أو كلمة مرور بريد إلكتروني في صفحة إنشاء المفتاح. يعرض النظام مفتاحك على الفور، لذا يمكنك نسخه دون تأخير. لا يلزم رقم هاتف للتسجيل. تتلقى $0.50 من رصيد تجريبي صالح لمدة سبعة أيام، لذا يمكنك اختبار الاتصال دون إضافة أموال.

قم بتكوين متغير البيئة أو عميل SDK الخاص بك للإشارة إلى عنوان URL الأساسي الصحيح. يعمل هذا العنوان مع مكتبات OpenAI القياسية. غيّر عنوان URL الأساسي ومفتاحك فقط. معرف النموذج هو "uncscribed". تتعامل نقطة النهاية هذه مع جميع إكمال النصوص. لا تحتاج إلى إدارة التوجيه أو اختيار نماذج مختلفة.

تأكد من أن مكتبة العميل الخاصة بك تدعم بروتوكولات إكمال الدردشة الخاصة بـ OpenAI. تعمل معظم المكتبات الحديثة خارج الصندوق. تحقق من أن شبكتك تسمح بطلبات HTTPS الصادرة. تقبل الخدمة أحمال JSON القياسية. لا توجد رؤوس خاصة مطلوبة بخلاف المصادقة.

المصادقة بمفاتيح API

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

حافظ على أمان مفتاحك. يحتفظ كل حساب بمفتاح نشط واحد. يؤدي إنشاء مفتاح جديد إلى إبطال المفتاح السابق. لا تشارك مفتاحك في المستودعات العامة. مفتاح API هو المعرف الوحيد لاستخدامك. تنطبق حدود المعدلات (Rate limits) لكل مفتاح، وليس لكل حساب.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

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

إرسال طلبك الأول

أرسل طلب POST إلى نقطة نهاية إكمال الدردشة. ضمّن معرف النموذج "uncensored" وسجل رسائلك. تُعيد الواجهة البرمجية استجابة نصية. يمكنك تدفق المخرجات أو الانتظار حتى الاكتمال الكامل. كل طلب يستهلك رموز الإدخال والإخراج. الأخطاء لا تستهلك الرصيد. الرفض مجاني.

Copyfrom openai import OpenAI

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

يشمل الرد إحصائيات الاستخدام. تتبع استهلاك الرموز لإدارة رصيدك المدفوع مسبقًا. يجيب النموذج دون رفض المحتوى للاستخدام القانوني للبالغين. يمكنك إرسال تعليمات النظام لتحديد السلوك. تدفع رسائل المستخدم المحادثة. تدعم نافذة السياق 100,000 رمز إجمالاً.

ابدل بتبادل بسيط لرسالتين. هذا يتحقق من الاتصال وجودة الاستجابة. اضبط درجة الحرارة و top_p للمخرجات الإبداعية أو الدقيقة. يدعم API المعاملات القياسية. تعمل تسلسلات التوقف كما هو متوقع. تضمن قيم البذور نتائج قابلة للتكرار.

استجابات البث عبر SSE

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

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)

يقلل البث من زمن الاستجابة المُدرَك. يرى المستخدمون النص يظهر في الوقت الفعلي. هذا مثالي لواجهات الدردشة. تعامل مع الرموز الجزئية بعناية. اربط الأجزاء لتكوين الاستجابة الكاملة. يغلق الخادم الاتصال عند انتهاء التوليد.

راقب أخطاء التدفق. قد تؤدي انقطاعات الشبكة إلى إنهاء التدفق. نفذ منطق إعادة الاتصال إذا لزم الأمر. لا تعيد واجهة برمجة التطبيقات (API) إرسال السجل. ابدأ طلبًا جديدًا إذا فشل التدفق. تعكس عد الرموز في الكتلة الأخيرة التوليد بأكمله.

معالجة المعاملات والأوضاع

استخدم المعلمات القياسية للتحكم في التوليد. اضبط temperature للعشوائية. اضبط top_p لأخذ العينات النووية. حدد تسلسلات التوقف لإيقاف التوليد مبكرًا. مرر seed للحصول على مخرجات حتمية. فعّل وضع JSON عن طريق ضبط response_format على json_object. يعيد النموذج JSON صالح عند الطلب.

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

Copyimport OpenAI from "openai";

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

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

فهم الحدود والأخطاء

تحمي حدود المعدلات استقرار الخدمة. يمكنك إرسال 300 طلب في الدقيقة. يقتصر التزامن على ثمانية طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز حجم الطلب 8 ميجابايت. يؤدي تجاوز الحدود إلى إرجاع خطأ 429 Too Many Errors. انتظر قبل إعادة المحاولة.

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

إدارة نافذة السياق أمر بالغ الأهمية. اجمع رموز الطلب والإكمال. حافظ على مسافة أمان كبيرة تحت حد 100,000 رمز. قم بقص الرسائل القديمة عند الحاجة. لا تقوم الـ API بالقص التلقائي. أنت تتحكم في طول السجل. الاستخدام الفعال للسياق يقلل التكاليف.