مستندات API مدل زبانی بزرگ بدون سانسور

URL پایه و احراز هویت

این API از یک URL پایه واحد برای تمام درخواست‌ها استفاده می‌کند. شما با استفاده از کلید API که در Authorization هدر. یک حساب کاربری از طریق گوگل یا ایمیل در دریافت کلید API صفحه برای دریافت فوری کلید خود.

• URL پایه: https://api.hereticia.com/v1
• Auth: Authorization: Bearer YOUR_API_KEY

برای ثبت‌نام نیاز به شماره تلفن نیست و کلید برای تمام endpointها معتبر است. با تنظیم URL پایه و کلید API، از SDKهای رسمی OpenAI استفاده کنید. کلید تنها یک بار نمایش داده می‌شود، بنابراین آن را به طور ایمن ذخیره کنید.

اولین درخواست

یک درخواست استاندارد chat.completions درخواست برای تولید متن از مدل بدون سانسور. نقطه پایانی پیک‌های JSON را با یک messages آرایه و یک model field set to uncensored.

این درخواست یک تعامل ساده را نشان می‌دهد. مدل متنی را بدون رد محتوای بزرگسالان قانونی برمی‌گرداند. برای محتوای تولید شده، پاسخ را بررسی کنید.

Copycurl 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."}]
  }'

یکپارچه‌سازی SDK Python

از کتابخانه رسمی پایتون OpenAI برای یکپارچه‌سازی API در اسکریپت‌های خود استفاده کنید. URL پایه را به https://api.hereticia.com/v1 و کلید API خود را ارائه دهید. کتابخانه قالب‌بندی درخواست را به صورت خودکار انجام می‌دهد.

کتابخانه را از طریق pip نصب کنید. سپس کلاینت را با URL پایه سفارشی مقداردهی اولیه کنید. یک پیام ارسال کنید و پاسخ را چاپ کنید. این روش برای اکثر کلاینت‌های سازگار با OpenAI کار می‌کند.

Copyfrom 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 و کلید API خود پیکربندی کنید. SDK ایجاد درخواست و تجزیه پاسخ را ساده می‌کند.

کلاینت را با URL پایه صحیح مقداردهی دهید. یک درخواست تکمیل چت را با uncensored مدل. پاسخ را مدیریت کنید تا متن تولید شده استخراج شود. این روش برای برنامه‌های سمت سرور کارآمد است.

Copyimport 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 در درخواست شما. API یک جریان قطعات رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. هر قطعه شامل متن جزئی و داده‌های مصرف توکن در قطعه نهایی است.

استریمینگ تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. هر قطعه را هنگام دریافت پردازش کنید. قطعه نهایی شامل تعداد کل توکن برای درخواست است. این ویژگی برای رابط‌های چت بلادرنگ ضروری است.

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)

محدودیت‌ها، خطاها و پنجره زمینه

پنجره زمینه (context window) تا ۱۰۰,۰۰۰ توکن در مجموع (ورودی به علاوه خروجی) پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. اگر max_tokens تنظیم نشده است، محدودیت 2,048 توکن است.

محدودیت‌های نرخ اجازه ۳۰۰ درخواست در دقیقه به ازای هر کلید را می‌دهند. درخواست‌های همزمان به ۸ درخواست به ازای هر کلید محدود می‌شوند. اندازه بدنه درخواست نباید بیشتر از ۸ مگابایت باشد. خطاها شامل ۴۰۱ برای کلیدهای نامعتبر، ۴۰۲ برای اعتبار ناکافی و ۴۲۹ برای محدودیت نرخ هستند. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند.