راهنمای شروع سریع API

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

اتصال به API LLM بدون سانسور ما با استفاده از URL پایه سازگار با OpenAI. کلید API شما هر درخواست را احراز هویت می‌کند، بنابراین آن را امن نگه دارید اما در دسترس برنامه خود. ما از یک هدر ساده برای اعتبارسنجی استفاده می‌کنیم، تضمین می‌کند که پرامپت‌های شما بدون اصطکاک به مدل می‌رسند.

Copycurl https://api.modelsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all available endpoint urls"}]
  }'

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

نقطه پایانی تکمیل چت

پیام‌ها را به مدل "uncensored" از طریق نقطه پایانی تکمیل چت استاندارد ارسال کنید. این نقطه پایانی تعاملات متن-ورودی، متن-خروجی را با پنجره بافت ۱۰۰,۰۰۰ توکن مدیریت می‌کند. می‌توانید دستورالعمل‌های system را برای تعریف رفتار شامل کنید، یا فقط پیام‌های user را برای تعامل مستقیم ارسال کنید.

Copyfrom openai import OpenAI

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

این مدل به‌طور پیش‌فرض محتوای قانونی بزرگسالان یا موضوعات جنجالی را رد نمی‌کند. پارامترهایی مانند دما برای خلاقیت یا top_p برای تنوع را تنظیم کنید. اگر max_tokens را حذف کنید، خروجی پیش‌فرض 2,048 توکن است. برای پاسخ‌های طولانی‌تر تا 16,000 توکن درخواست دهید. این نقطه پایانی برای بیشتر وظایم خودکارسازی چیزی است که نیاز دارید.

پاسخ‌های استریم (SSE)

تولید توکن بلادرنگ را با استفاده از رویدادهای ارسال‌شده توسط سرور (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)

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

فراخوانی تابع و حالت JSON

استخراج داده ساختاریافته را با استفاده از فراخوانی تابع یا حالت JSON انجام دهید. ابزارها را در درخواست مشخص کنید تا فرمت خروجی مدل را هدایت کنید. این برای خطوط لوله اتوماسیونی که به ساختارهای داده قابل اعتماد از LLM بدون سانسور نیاز دارند حیاتی است. حالت JSON پاسخ را به JSON معتاد مجبور می‌کند که خطاهای پارس را کاهش می‌دهد.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.modelsaiuncensored.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 یا فعال‌سازی عملیات خارجی را آسان می‌سازد. از این قابلیت برای ساخت عامل‌ها یا کارکردهای پردازش داده بدون مراحل اعتبارسنجی دستی استفاده کنید.

محدودیت‌های نرخ و محدودیت‌ها

API ما محدودیت‌های سخت‌گیرانه برای اطمینان از پایداری برای همه کاربران اعمال می‌کند. شما مجاز به ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید هستید. هر بدنه درخواست باید کمتر از ۸ مگابایت باشد تا از مشکلات payload بیش از حد جلوگیری شود. این محدودیت‌ها به ازای هر کلید API اعمال می‌شوند، بنابراین اگر نیاز است بار را بین کلیدها توزیع کنید.

خطاهایی مانند ۴۰۱ نشان‌دهنده کلید نامعتبر یا فاقد کلید است. خطای ۴۰۲ به این معنی است که اعتبار پیش‌پرداخت شما تمام شده است. وضعیت ۴۲۹ نشان می‌دهد که به محدودیت نرخ رسیده‌اید. مکث کنید و پس از یک تأخیر کوتاه دوباره تلاش کنید. این محدودیت‌ها شفاف هستند و در زمان‌های اوج ترافیک، محدودیت پنهانی اعمال نمی‌شود.

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

مدل از پنجره زمینه ۱۰۰,۰۰۰ توکنی پشتیبانی می‌کند که شامل هر دو بخش prompt و completion است. این امکان را برای تحلیل اسناد گسترده یا تاریخچه مکالمات طولانی فراهم می‌آورد. با این حال، حداکثر خروجی در هر درخواست به ۱۶,۰۰۰ توکن محدود است. اگر max_tokens را مشخص نکنید، پیش‌فرض ۲,۰۴۸ توکن است.

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