Heretic LLM: توثيق API

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

للبدء في استخدام API الخاص بـ Heretic LLM، وجه عميلك المتوافق مع OpenAI إلى عنوان URL الأساسي الخاص بنا: https://api.hereticllm.com/v1. يستخدم API المصادقة القياسية باستخدام رمز Bearer. يمكنك إنشاء مفتاح API عن طريق التسجيل باستخدام البريد الإلكتروني وكلمة المرور فقط في صفحة Get API Key. يظهر المفتاح فوراً بعد التسجيل ويمكن تجديده في أي وقت، مما يلغي صلاحية المفتاح السابق.

قم بتعيين متغير البيئة OPENAI_API_KEY أو مرر المفتاح مباشرة في تكوين العميل الخاص بك. تأكد من تحديث عنوان URL الأساسي إلى نقطة النهاية الخاصة بـ Heretic. يتيح لك هذا الإعداد استخدام SDKs الرسمية الخاصة بـ OpenAI بدون تغييرات في الكود، فقط عن طريق تبديل عنوان URL الأساسي والمفتاح.

الطلب الأول

قم بإرسال طلبك الأول إلى نقطة النهاية chat completions. معرف النموذج هو uncensored. هذا نموذج مفتوح الأوزان تم ضبطه للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله مثالياً للبرمجة بدون رقابة، الكتابة الإبداعية، أو البحث. تدعم نافذة السياق ما يصل إلى 100,000 رمز (token) للموجّه والنص المُنشأ معاً.

يوجد أدناه مثال أساسي باستخدام cURL لاختبار نقطة النهاية. استبدل YOUR_API_KEY بمفتاحك الفعلي.

سيكون الرد كائناً بتنسيق OpenAI القياسي يحتوي على النص المُنشأ.

Copycurl https://api.hereticllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

تكامل SDK الخاص بـ Python

قم بدمج API في تطبيقات Python الخاصة بك باستخدام الحزمة الرسمية openai. تتعامل المكتبة مع تسلسل JSON والبث المتدفق تلقائياً. قم بتهيئة العميل باستخدام مفتاح API الخاص بك وعنوان URL الأساسي الصحيح. ثم، قم باستدعاء chat.completions.create بمعرف النموذج uncensored.

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

Copyfrom openai import OpenAI

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

تكامل SDK الخاص بـ Node.js

لمشاريع JavaScript و TypeScript، استخدم حزمة npm openai. قم بتكوين العميل باستخدام عنوان URL الأساسي الخاص بـ Heretic ومفتاح API الخاص بك. يدعم API هياكل الطلب القياسية، بما في ذلك تعريفات الأدوات واستدعاء الدوال.

تأكد من معالجة الرد بشكل صحيح، خاصة عند استخدام أنماط async/await. يعيد النموذج نصوصاً يمكن معالجتها مباشرة في منطق تطبيقك. هذا التكامل مثالي لبناء واجهات الدردشة، الوكلاء الآليين، أو خطوط معالجة البيانات التي تتطلب قدرات LLM بدون رقابة.

Copyimport OpenAI from "openai";

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

الردود المتدفقة

فعّل الردود في الوقت الفعلي عن طريق تفعيل البث المتدفق في طلب API الخاص بك. قم بتعيين المعامل stream إلى true. سيعيد API تدفق أحداث Server-Sent Events (SSE) يحتوي على أجزاء من النص كما يتم توليدها. هذا يقلل من زمن الاستجابة المتصور ويوفر تجربة مستخدم أكثر سلاسة لتطبيقات الدردشة.

يحتوي كل جزء في التدفق على جزء من الرد. تعامل مع هذه الأجزاء تدريجياً لتحديث واجهة المستخدم الخاصة بك في الوقت الفعلي. ميزة البث المتدفق متوافقة تماماً مع SDKs الخاصة بـ OpenAI، لذا يمكنك استخدام المكررات القياسية stream أو مستمعي الأحداث لمعالجة البيانات بكفاءة.

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 MB. إذا تجاوزت حدّ المعدل، ستتلقى خطأ 429. تعيد أخطاء المصادقة حالة 401، مما يشير إلى مفتاح API غير صالح أو مفقود. إذا استنفدت رصيدك المسبق الدفع، يعيد API خطأ 402، مما يتطلب شحن الرصيد.

لا ينتهي صلاحية الرصيد، ويمكنك شحن الرصيد من $10 باستخدام العملات المشفرة (USDT أو USDC)، مع رصيد إضافي للإيداعات الأكبر. يدعم النموذج نافذة سياق بحجم 100,000 رمز (token). تأكد من أن موجّهاتك والنصوص المُنشأة تتناسب ضمن هذا الحد. لمزيد من التفاصيل حول الأسعار والحدود، قم بزيارة صفحة الأسعار.