المصادقة: استخدام مفتاح API الخاص بك
مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب ترسله إلى خوادمنا. نصدر مفتاحًا واحدًا لكل حساب يمكنك إنشاؤه عبر لوحة التحكم. مرر هذا المفتاح في Authorization رأس باستخدام مخطط Bearer. إذا أرسلت مفتاحاً غير صالح، نعيد خطأ 401. إذا نفد رصيدك المدفوع مسبقاً، نعيد خطأ 402 يتطلب منك إضافة رصيد عبر العملات المشفرة قبل الاستمرار.
هيكل عنوان URL الأساسي ونقطة النهاية
وجه جميع الطلبات إلى عنوان URL الأساسي الوحيد الخاص بنا لإكمال الدردشة. لا نقدم نقاط نهاية للتضمين (embeddings)، أو توليد الصور، أو ضبط النماذج. استخدم القياسي POST /v1/chat/completions المسار لإرسال مطالباتك. يمكنك أيضًا استعلام GET /v1/models للتحقق من معرف النموذج المتاح. يضمن هذا الهيكل التوافق مع عملاء مكتبات SDK الخاصة بـ OpenAI الموجودين دون الحاجة إلى منطق توجيه مخصص.
بداية سريعة: طلبك الأول مع ablated AI
أرسل طلب نصي بسيط لاختبار النموذج غير المقيد على الفور. استخدم مكتبة OpenAI الرسمية أو أي عميل HTTP لإرسال طلب POST لرسالتك. يُرجع النموذج ردًا نصيًا دون تصفية المحتوى البالغ القانوني. استبدل المفتاح الافتراضي ببيانات الاعتماد الفعلية الخاصة بك من لوحة التحكم.
curl https://api.aiablated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "what is the current version of the api"}]
}'يُظهر هذا الطلب تدفق التفاعل الأساسي. تتلقى إجابة مباشرة من النموذج abladed. اضبط نظام الطلب لتحديد الشخصية أو السياق لحالة الاستخدام الخاصة بك.
تكامل واجهة برمجة تطبيقات Python
استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI لدمج واجهة برمجة التطبيقات في تطبيقاتك. قم بتعيين عنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات في تكوين العميل. يتعامل هذا النهج مع التسلسل وتحليل الأخطاء تلقائيًا. يمكنك تدفق الاستجابات أو جلبها بشكل متزامن. تدير مكتبة العميل دورة حياة الاتصال لك.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiablated.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)يبدأ هذا المقتطف البرمجي العميل بشكل صحيح. يشير إلى عنوان URL الأساسي المحدد لدينا. تأكد من تثبيت أحدث حزمة openai للتوافق الكامل مع ميزات التدفق واستدعاء الوظائف.
تكامل SDK Node.js
دمج واجهة برمجة التطبيقات في مشاريع JavaScript أو TypeScript الخاصة بك باستخدام المكتبة القياسية. قم بتكوين عنوان URL الأساسي للإشارة إلى خدمتنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create. يتعامل مكتبة البرمجيات (SDK) مع رؤوس الطلبات وتحليل الاستجابة. يمكنك بسهولة إضافة معالجة الأخطاء لانتهاء الحد أو فشل المصادقة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiablated.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);يضمن هذا الإعداد تواصل تطبيق Node الخاص بك بشكل صحيح. يعد تجاوز عنوان URL الأساسي الخطوة الحاسمة. بدونه، سيحاول SDK الوصول إلى سحابة OpenAI بدلاً من خوادمنا.
استجابات البث واستهلاك الرموز
استلم الاستجابات رمزًا تلو الآخر باستخدام أحداث الإرسال من الخادم (SSE). هذا يقلل من زمن الاستجابة المُدرَك للمخرجات الطويلة. تحتوي الشريحة النهائية من البث على إجمالي استخدام الرمز المميز للطلب. يمكنك تتبع استهلاك رصيدك المدفوع مسبقًا في الوقت الفعلي. اضبط stream: true في حمولة الطلب الخاصة بك لتفعيل هذا الوضع. هذا مثالي لواجهات الدردشة وتوليد النص المباشر.
stream = 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)يوفر هذا النهج التدفقي تجربة مستخدم سلسة. يتضمن الشق الأخير إحصائيات الاستخدام. راقب هذه الأرقام لإدارة رصيدك المدفوع مسبقاً بفعالية. تتعامل مكتلة SDK بسلاسة مع الأخطاء أثناء التدفق.
