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

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

تعمل واجهة برمجة التطبيقات abliterated كبديل جاهز للاستخدام لنقاط نهاية OpenAI القياسية. توجه طلباتك إلى https://api.aiabliterated.cc/v1 والمصادقة باستخدام رمز حامل في Authorization الرأس. يعمل هذا الإعداد مع أي عميل يدعم بروتوكول OpenAI.

• URL الأساسي: https://api.aiabliterated.cc/v1
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY
• معرف النموذج: uncensored

المصادقة صارمة. إذا أرسلت مفتاحاً غير صالح، يُرجع النظام خطأ 401 فوراً.

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

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

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

Copyfrom openai import OpenAI

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

استجابات البث واستهلاك الرموز

فعّل البث عن طريق تعيين 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)

استدعاء الوظائف ووضع JSON

يدعم نموذج abliterated المخرجات المهيكلة عبر response_format معامل. اضبط هذا على {"type": "json_object"} لإجبار الامتثال الصارم لـ JSON. هذا ضروري للتكامل الموثوق مع أنظمة الخلفية.

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

Copyimport OpenAI from "openai";

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

المعلمات: درجة الحرارة وTop-P والبذلة

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

تشمل المعاملات الأخرى المتاحة stop التسseqs، presence_penalty، و frequency_penalty. تتيح هذه الخيارات تحكماً دقيقاً في تكرار الرموز والتزام الموضوع. يستجيب النموذج غير الخاضع للرقابة بشكل جيد لإعدادات درجة الحرارة المنخفضة لتوليد الكود ودرجات الحرارة العالية للكتابة الإبداعية.

حدود المعدلات والقيود

تفرض واجهة برمجة التطبيقات حدودًا صارمة لضمان استقرار جميع المستخدمين. أنت محدود بـ 300 طلب في الدقيقة لكل مفتاح. الطلبات المتزامنة محدودة بـ 8 في وقت واحد. يجب ألا يتجاوز حجم جسم الطلب 8 ميجابايت.

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

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'