Abliter API Quickstart

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

تواصل مع واجهة برمجة التطبيقات باستخدام عنوان URL الأساسي المقدم ومفتاح واجهة برمجة التطبيقات الفريد الخاص بك. تقع النقطة النهائية عند https://api.abliter.cc/v1المصادقة رأس الصفحة كرمز حامل (Bearer token). هذا الإعداد يعمل مع أي مكتبة عميل قياسية متوافقة مع OpenAI. المصادقة مباشرة: ولّ مفتاحك عبر لوحة التحكم وألصقه في الكود الخاص بك. لا توجد تدفقات OAuth معقدة أو رموز ثانوية مطلوبة للوصول الأساسي. يمنحك مفتاحك الوصول الفوري إلى قدرات النموذج غير المقيد.

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

أرسل استدعاءك الأول باستخدام نقطة نهاية إكمال المحادثة القياسية. يرسل هذا الطلب مطالبة ويستقبل استجابة نصية. يمكنك استخدام curl أو أي عميل HTTP لاختبار الاتصال. مُعرّف النموذج هو uncensored. تأكد من تحديد النموذج بشكل صحيح في حمولتك. يسمح هذا الهيكل البسيط لك بالتحقق من أن تكاملك يعمل قبل بناء تطبيقات معقدة. تعيد واجهة برمجة التطبيقات النص مباشرة، مما يضمن التوافق مع سير العمل الحالي.

Copycurl https://api.abliter.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current server status?"}]
  }'

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

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

Copyfrom openai import OpenAI

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

تكامل SDK Node.js

دمج واجهة برمجة التطبيقات في مشاريع JavaScript أو TypeScript الخاصة بك باستخدام مكتبة Node SDK. قم بتكوين العميل بعنوان URL الأساسي ومعلومات الاعتماد الخاصة بك. يتيح لك ذلك معالجة الطلبات داخل الدوال غير المتزامنة بسلاسة. يمكنك إدارة الاستجابات المتدفقة أو المتزامنة بناءً على احتياجاتك. تدعم المكتبة أنماط async/await الحديثة للكود النظيف. هذا يجعل من السهل دمج واجهة برمجة التطبيقات في خوادم الويب أو أدوات سطر الأوامر. تأكد من أن بيئتك تدعم إصدار Node المطلوب.

Copyimport OpenAI from "openai";

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

معالجة استجابات التدفق

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

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) لدينا حدودًا محددة لضمان الاستقرار. تحصل على 300 طلبًا في الدقيقة و8 طلبات متزامنة لكل مفتاح. تدعم نافذة السياق 100,000 رمز إجمالي، مع حد أقصى للإخراج يبلغ 16,000 رمز. تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 عدم كفاية الرصيد. يشير رمز الحالة 429 إلى أنك وصلت إلى حد معدل الطلبات. ستفشل الطلبات التي تتجاوز حجم الجسم البالغ 8 ميجابايت. لا ينتهي صلاحية الرصيد، لذا يمكنك إعادة الشحن حسب وتيرتك. تساعد هذه القيود في الحفاظ على توفر عالٍ لجميع المستخدمين.