ar ▾
ابدأ الآن

Heretic IAوثائق واجهة برمجة تطبيقات نموذج لغوي كبير غير خاضع للرقابة

وثائق واجهة برمجة تطبيقات نموذج لغوي كبير غير خاضع للرقابة

ابدأ باستخدام واجهة برمجة التطبيقات (API) الخاصة بـ Heretic Ia في دقائق. يغطي دليل البدء السريع المصادقة، والطلبات، والتدفق، والحدود الخاصة بنموذج اللغة الكبيرة (LLM) غير المقيد.

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

تستخدم واجهة برمجة التطبيقات عنوان URL أساسي واحد لجميع الطلبات. يمكنك المصادقة باستخدام مفتاح API يتم تمريره في Authorization رأس. أنشئ حساباً عبر Google أو البريد الإلكتروني على احصل على مفتاح API صفحة لتلقي مفتاحك على الفور.

  • URL الأساسي: https://api.hereticia.com/v1
  • المصادقة: Authorization: Bearer YOUR_API_KEY

لا يتطلب التسجيل رقم هاتف، والمفتاح صالح لجميع نقاط النهاية. استخدم مكتلات SDK الرسمية الخاصة بـ OpenAI عن طريق ضبط عنوان URL الأساسي ومفتاح API. يظهر المفتاح مرة واحدة فقط، لذا احفظه بأمان.

الطلب الأول

معايير chat.completions طلب لتوليد نص من النموذج غير المقيد. تقبل النقطة حمولات JSON مع messages مصفوفة و model field مضبوطًا إلى uncensored.

يُظهر هذا الطلب تفاعلاً بسيطاً. يعيد النموذج نصاً بدون رفضات محتوى للاستخدام البالغ القانوني. تحقق من الاستجابة للحصول على المحتوى المولد.

curl https://api.hereticia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the sum of 2048 and 512."}]
  }'

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

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI لدمج واجهة برمجة التطبيقات في سكريبتاتك. قم بتعيين عنوان URL الأساسي إلى https://api.hereticia.com/v1 وتوفير مفتاح API الخاص بك. تتعامل المكتبة مع تنسيق الطلب تلقائياً.

ثبّت المكتبة عبر pip. ثم قم بتهيئة العميل باستخدام عنوان URL الأساسي المخصص. أرسل رسالة وطبع الاستجابة. تعمل هذه الطريقة مع معظم العملاء المتوافقين مع OpenAI.

from openai import OpenAI

client = OpenAI(base_url="https://api.hereticia.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 عن طريق تثبيت حزمة OpenAI. قم بتكوين العميل بعنوان URL الأساسي لـ Heretic Ia ومفتاح واجهة برمجة التطبيقات الخاص بك. تبسط الحزمة إنشاء الطلبات وتحليل الاستجابات.

تهيئة العميل باستخدام عنوان URL الأساسي الصحيح. أنشئ طلب إكمال محادثة مع uncensored النموذج. تعامل مع الاستجابة لاستخراج النص المولد. هذه الطريقة فعالة لتطبيقات الخادم.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticia.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 في طلبك. تُعيد واجهة برمجة التطبيقات تدفق أحداث الإرسال الخادم (SSE) من الشرائح. تحتوي كل شريحة على نص جزئي وبيانات استخدام الرموز المميزة في الشريحة الأخيرة.

يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. قم بمعالجة كل جزء عند وصوله. يتضمن الجزء الأخير عدد الرموز الإجمالي للطلب. هذه الميزة أساسية لواجهات الدردشة في الوقت الفعلي.

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)

حدود، أخطاء، ونافذة السياق

تدعم نافذة السياق 100,000 رمز موحّد إجمالاً (النص التوجيهي بالإضافة إلى الإكمال). الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. إذا max_tokens غير مضبوط، الحد هو 2,048 رمزًا.

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى للطلبات المتزامنة هو 8 لكل مفتاح. يجب ألا يتجاوز حجم جسم الطلب 8 ميجابايت. تشمل الأخطاء: 401 للمفاتيح غير الصالحة، و402 لنقص الرصيد، و429 لحدود معدل الطلبات. لا تستهلك الأخطاء والرفضات أي رصيد.

الأسئلة الشائعة

كيف أبدأ مع Heretic Ia API؟

سجّل في صفحة الحصول على مفتاح API باستخدام حساب Google أو البريد الإلكتروني. ستتلقى مفتاح API على الفور. استخدم هذا المفتاح مع أي SDK متوافق مع OpenAI عن طريق تعيين عنوان URL الأساسي إلى HTTPS://api.hereticia.com/v1.

ما هو نافذة السياق وحد الإخراج؟

نافذة السياق تتكون من 100,000 رمز، وتشمل كلًا من النص الموجه والرد المكتمل. الحد الأقصى للمخرجات لكل طلب هو 16,000 رمز، أو 2,048 رمز إذا لم يتم تحديد max_tokens.

كيف يعمل البث وأين يتم الإبلاغ عن استخدام الرموز المميزة؟

عيّن stream: true لتلقي تدفق أحداث Server-Sent Events. تحتوي كل شريحة على نص جزئي. يتم توفير تفاصيل استخدام الرموز في الشريحة الأخيرة من التدفق.

أنشئ مفتاح API الخاص بك

سجّل حساباً، استرد المفتاح، وحدّث عنوان URL الأساسي. هذه هي التكوين بأكمله.