دليل التكامل: إكمال محادثات بلا رقابة

عنوان URL الأساسي والمصادقة

يبدأ أساس تكاملك من عنوان URL الأساسي. استخدم https://api.loginllm.com/v1 لجميع الطلبات. هذه النقطة النهائية متوافقة تمامًا مع OpenAI، مما يعني أنه يمكنك تبديل مفاتيحك الحالية دون إعادة كتابة منطق العميل.

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

مرر المفتاح في الـ Authorization رأس الصفحة كرمز حامل (Bearer token). لا توجد تدفقات OAuth معقدة أو ملفات تعريف ارتباط للجلسة مطلوبة لـ API نفسه.

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

نقطة نهاية chat/completions

أرسل الرسائل إلى POST /v1/chat/completions endpoint. هذه الواجهة القياسية لتوليد النص. حدد النموذج على أنه uncensored وتوفير قائمة بالرسائل في جسم الطلب.

تتطلب كل رسالة دوراً (system, user, أو assistant) والمحتوى. يعالج النظام هذه المدخلات ويعيد إكمالًا. لا تحتاج إلى إدارة توجيه النموذج أو الاختيار من بين متغيرات متعددة؛ نحن نستضيف نموذجًا واحدًا مفتوح الوزن مُحسّنًا للإخراج غير المقيد.

يُبقي هذا النهج الكود الخاص بك بسيطًا. تتجنب العبء الناتج عن إدارة إصدارات متعددة من النماذج أو التعامل مع غرائب محددة للبائع. هيكل الاستجابة يتطابق مع تنسيق OpenAI، مما يضمن توافقًا واسعًا مع SDK.

تحقق من رصيدك بانتظام. يتم خصم الرصيد بناءً على استخدام الرموز الفعلي، ولا تستهلك الأخطاء الرصيد.

البث مع أحداث الخادم (SSE)

لتجارب المستخدم في الوقت الفعلي، فعّل التدفق عن طريق ضبط stream: true في طلبك. تُعيد الـ API تدفقًا لأحداث الإرسال من الخادم (SSE) بدلاً من كائن JSON واحد.

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

هذه الميزة ضرورية لواجهات الدردشة حيث يتوقع المستخدمون ملاحظات فورية. يتيح لتطبيقك التعامل مع الاستجابات الطويلة دون حظر الخيط الرئيسي.

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

استدعاء الوظائف والأدوات

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

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

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

تأكد من أن تعريفات الأدوات الخاصة بك دقيقة. يعتمد النموذج على هذه المخططات لفهم تنسيقات الإدخال والإخراج المتوقعة لكل وظيفة.

حدود نافذة السياق

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

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

راقب حدود المعدل بعناية. تسمح واجهة البرمجة (API) بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. سيؤدي تجاوز هذه الحدود إلى حدوث خطأ 429.

مقيد حجم جسم الطلب بـ 8 ميجابايت. تستهلك نوافذ السياق الكبيرة رصيداً أكثر، لذاوازن بين متطلبات الذاكرة وميزانيتك.

معالجة الأخطاء واستخدام التوكن

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

تعني خطأ 402 أن رصيدك المدفوع مسبقاً غير كافٍ. قم بإضافة رصيد باستخدام USDT (TRC20) أو USDC (Base) لاستئناف الخدمة. لا تنتهي صلاحية الرصيد، لذا يمكنك إضافة الأموال في أي وقت يناسبك.

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

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

cURL

Copycurl https://api.loginllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python loop"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)