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

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

استخدم عنوان URL الأساسي المخصص لجميع الطلبات. يصادق مفتاح API الخاص بك عبر Authorization رأس.

• URL الأساسي: https://api.hereticuncensored.com/v1
• معرف النموذج: uncensored

استرجع مفتاحك من لوحة التحكم. يكون صالحًا على الفور عند الإنشاء.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

الطلب الأول

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

• تعيين model إلى uncensored.
• تضمين messages مصفوفة.

تحقق من الاستجابة لـ choices تحتوي النص الذي تم إنشاؤه.

Copyfrom openai import OpenAI

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

قم بتهيئة العميل باستخدام عنوان URL الأساسي والمفتاح الخاص بك. يضمن هذا التوافق مع مكتبات OpenAI القياسية.

• ثبّت النسخة الرسمية openai حزمة.
• تمرير baseURL و apiKey أثناء التهيئة.

استدعاء chat.completions.create() مع طلبك. يعكس هيكل الاستجابة تنسيق API القياسي.

Copyimport OpenAI from "openai";

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

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

تمكين تسليم الرموز في الوقت الفعلي عن طريق ضبط stream إلى true. يقلل من زمن الاستجابة المُدرَك للمخرجات الطويلة.

• استمع لـ delta قطع.
• ادمج القطع لإعادة بناء الاستجابة الكاملة.

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

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)

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

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

• الحد الأقصى للطلبات المتزامنة: 8
• الحد الأقصى للرموز: 16,000 (الافتراضي 2,048)

تجاوز الحدود يؤدي إلى خطأ 429. أدر التزامن للحفاظ على معدل نقل ثابت لأحمال العمل عالية الحجم.

معالجة الأخطاء والرموز

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

• تشير 429 إلى استنفاد حد المعدل.
• تشير أخطاء 400 إلى هياكل طلب غير صحيحة.

لا تُصدر استردادات للرموز المستهلكة. تحقق من رصيدك بانتظام لتجنب انقطاع الخدمة.