البدء السريع في واجهة برمجة التطبيقات والتكامل

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

يوفر مشروع Heretic نقطة نهاية واحدة مستضافة لتوليد النصوص. استخدم https://api.hereticproject.com/v1 كعنوان URL الأساسي. تعتمد المصادقة على رمز حامل يتم تمريره عبر Authorization رأس. أنشئ مفتاحك بتسجيل الدخول باستخدام Google أو البريد الإلكتروني في لوحة التحكم. يصدر النظام مفتاحاً نشطاً واحداً لكل حساب؛ يؤدي إنشاء مفتاح جديد إلى إبطال المفتاح السابق فوراً.

تدفع فقط مقابل الرموز المميزة المستهلكة. لا يتم خصم الأخطاء والرفض من رصيدك المدفوع مسبقاً. يحصل الحساب الجديد على رصيد تجريل بقيمة $0.50 صالح لمدة 7 أيام. تقوم بالإيداع باستخدام USDT (TRC20) أو USDC (Base) بمبالغ تتراوح بين $20 و $500.

نقطة نهاية /v1/chat/completions

أرسل الرسائل إلى نقطة نهاية إكمال الدردشة القياسية. معرف النموذج هو uncensored. يقبل قائمة من كائنات الرسائل مع أدوار مثل system, user, أو assistant. لا يرفض النموذج المواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل. إنه نموذج مفتوح الوزن مضبوط للإجابات المباشرة.

تعيد الطلبات كائن JSON يحتوي على النص المولد. تدعم نافذة السياق 100,000 رمز مميز إجمالي للمطالبة والإكمال. الإخراج محدود بـ 16,000 رمز مميز لكل طلب ما لم تحدد حدًا أقل max_tokens القيمة.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

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

استخدم مكتبة بايثون الرسمية من OpenAI مع عنوان URL أساسي مخصص. قم بتعيين api_key سلسلة الواجهة البرمجية (API) الخاصة بك. قم بتكوين base_url لإشارة إلى خادم مشروع Heretic. يتيح لك هذا استخدام الأساليب المألوفة مثل chat.completions.create() بدون تعديل هيكل الكود الحالي بشكل كبير.

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

Copyfrom openai import OpenAI

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

تعمل حزمة Node.js SDK بشكل مطابق لنسخة Python. قم بتهيئة العميل باستخدام مفتاح API الخاص بك وعنوان URL الأساسي الصحيح. يمكنك إرسال طلبات الإكمال باستخدام توقيعات الأساليب نفسها. يضمن هذا الاتساق عبر أجزاء مختلفة من البنية البرمجية الخاصة بك.

تعامل مع الاستجابات بشكل غير متزامن. تقوم SDK ببث البيانات إذا استخدمت طريقة البث. وإلا، فإنها تعيد استجابة JSON الكاملة. يدعم هذا المرونة كلًا من المعالجة الدفعية والواجهات في الوقت الفعلي. احفظ مفتاح API الخاص بك بأمان في متغيرات البيئة.

Copyimport OpenAI from "openai";

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

استجابات البث (SSE)

فعّل البث عن طريق تعيين stream: true في طلبك. يرسل الخادم أحداث خادم المراسلة (SSE). يحتوي كل جزء على تحديثات نصية جزئية. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين النهائيين. تظهر بيانات استخدام الرموز في الجزء الأخير من التدفق.

معالجة كل كائن جزء (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)

حدود، أخطاء، والسياق

احترم حدود معدل الطلبات لتجنب انقطاعات الخدمة. يُسمح لك بـ 300 طلب في الدقيقة لكل مفتاح. يقتصر التزامن على 8 طلبات متزامنة. لا يمكن أن يتجاوز حجم جسم الطلب 8 ميجابايت. يؤدي تجاوز هذه الحدود إلى إرجاع رمز حالة 429. انتظر briefly قبل إعادة المحاولة.

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