واجهة برمجة التطبيقات التوثيق

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

المصادقة على كل طلب عن طريق تمرير مفتاح API الخاص بك في Authorization الرأس. تستخدم خدمتنا عنوان URL أساسي واحد لجميع العمليات، مما يضمن قدرتك على التبديل من مزودي الخدمات الآخرين دون تغيير منطقك الأساسي. استبدل ببساطة عنوان URL الأساسي الافتراضي في تكوين العميل الخاص بك بـ https://api.abliteratedgemma.com/v1 وأدرج مفتاحك. هذا يعمل مع أي واجهة برمجة تطبيقات (SDK) قياسية متوافقة مع OpenAI، مما يتيح لك استخدام نفس كود العميل للنموذج غير المقيد لدينا كما تفعل مع العمالقة التجاريين.

إجراء أول طلب

أرسل طلب POST إلى /v1/chat/completions باستخدام معرف النموذج uncensored. يقبل API رسائل المحادثة القياسية ويعيد النص مباشرة. استخدم أمر cURL التالي للتحقق من الاتصال وتلقي استجابة فورًا.

Copycurl https://api.abliteratedgemma.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"}]
  }'

يدعم هذا الـ Endpoint ما يصل إلى 100,000 رمز (token) في الطلب والإكمال المدمج. إذا لم تحدد حدًا للرموز، فإن النموذج يستخدم افتراضيًا 2,048 رمز للإخراج. تأكد من أن طلباتك تبقى ضمن حد حجم الجسم البالغ 8 MB لتجنب أخطاء الاقتطاع.

استخدام مكتبة Python SDK

ثبّت الحزمة الرسمية لـ Python الخاصة بـ OpenAI واعددها لتشير إلى عنوان URL الأساسي الخاص بنا. يتيح لك ذلك الاستفادة من الأساليب المألوفة مثل chat.completions.create للطلبات المتزامنة. يوضح المثال التالي كيفية تهيئة العميل وإرسال مطالبة بسيطة إلى النموذج غير الخاضع للرقابة.

Copyfrom openai import OpenAI

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

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

استخدام مكتبة Node.js SDK

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

Copyimport OpenAI from "openai";

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

يتعامل SDK لـ Node مع تسلسل الطلبات تلقائياً، ولكن لا يزال يتعين عليك إدارة رصيد الرصيد الخاص بك. تحقق من صفحة التسعيع لمعدلات الرموز الحالية وخيارات الشحن بالعملات المشفرة.

استجابات البث

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد الـ API شرائح من النص بمجرد توليدها، مما يتيح زمن استجابة أقل في التطبيقات الموجهة للمستخدم. استخدم هذا الكود لمعالجة التدفق رمزًا تلو الآخر.

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)

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

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

راقب حدود طلباتك لتجنب الانقطاع. يُسمح لك بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا تجاوزت حد المعدل، يعيد الـ API خطأ 429. تعامل دائمًا مع أخطاء 401 بالتحقق من مفتاحك وأخطاء 402 بشحن رصيدك المشفر. رصيدك المدفوع مسبقًا لا ينتهي، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.

نافذة السياق وتفاصيل النموذج

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