شروع سریع: کد خود را متصل کنید

نصب و پیکربندی

کلید API درخواست‌های شما را احراز هویت می‌کند. یکی را بلافاصله از طریق داشبورد با استفاده از Google یا ایمیل و رمز عبور تولید کنید. شماره تلفن لازم نیست. کلید را در متغیرهای محیطی خود ذخیره کنید. این کلید دسترسی به مدل بدون سانسور یکتا را فراهم می‌کند. می‌توانید کلید را جایگزین کنید، اما فقط یکی در هر زمان فعال می‌ماند. URL پایه ترافیک را به سرورهای ما هدایت می‌کند. با هر کتابخانه کلاینت سازگار با OpenAI کار می‌کند. تغییر base_url پارامتر به اینجا اشاره کنید. این منطق پراکسی یا مسیریابی پیچیده را حذف می‌کند. پرامپت‌ها و تکمیل‌های شما در اعتبار پیش‌پرداخت شما حساب می‌شوند. خطاها توکن مصرف نمی‌کنند. این تضمین می‌کند که فقط برای تولید واقعی پرداخت می‌کنید.

انجام اولین تکمیل چت

یک درخواست POST به /v1/chat/completions با شناسه مدل. از "uncensored" به عنوان مقدار مدل. پیام‌های سیستم و کاربر خود را در messages آرایه. API متن تولید شده را برمی‌گرداند. هیچ فیلتر محتوایی موضوعات بزرگسالان قانونی را مسدود نمی‌کند. می‌توانید پارامترهایی مانند temperature یا top_p. این‌ها تصادفی‌سازی و خلاقیت را کنترل می‌کنند. تنظیم max_tokens برای محدود کردن طول خروجی. پیش‌فرض 2,048 توکن است. می‌توانید این مقدار را تا 16,000 توکن افزایش دهید. پنجره زمینه 100,000 توکن را به طور کلی پشتیبانی می‌کند. این اجازه می‌دهد نقش‌آفرینی‌های طولانی و دقیق داشته باشید. درخواست‌های خود را زیر 8 مگابایت نگه دارید. این محدودیت عملکرد پایدار برای پیکربندی‌های بزرگ را تضمین می‌کند.

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

استریم‌دهی توکن‌ها را همان‌طور که تولید می‌شوند ارسال می‌کند. این تأخیر ادراک‌شده را برای کاربران کاهش می‌دهد. تنظیم stream: true در درخواست شما. API یک جریان رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. هر قطعه شامل محتوای جزئی است. می‌توانید این قطعات را به هم متصل کنید تا پاسخ کامل را تشکیل دهید. قطعه نهایی شامل آمار مصرف توکن است. این به شما کمک می‌کند مصرف اعتبار را به دقت ردیابی کنید. پخش جریان برای رابط‌های چت بلادرنگ ایده‌آل است. این بازخورد فوری در حین تولید فراهم می‌کند. مدیریت خطا چه در حالت پخش جریان و چه در غیر این صورت یکسان باقی می‌ماند. کد وضعیت را برای شکست‌ها بررسی کنید. خطای 402 نشان‌دهنده اعتبار ناکافی است. خطای 401 به این معنی است که کلید شما نامعتبر است. منطق تلاش مجدد باید این کدهای خاص را در نظر بگیرد.

استفاده از فراخوانی تابع و ابزارها

ابزارها را در درخواست خود تعریف کنید تا قابلیت‌های فراخوانی تابع را فعال کنید. مدل می‌تواند داده‌های ساختاریافته برای برنامه شما بازگرداند. مشخص کنید tool_choice برای کنترل رفتار فراخوانی. استفاده "auto" برای انتخاب خودکار. تعاریف ابزار را در tools آرایه. مدل در صورت لزوم با فراخوانی‌های تابع پاسخ می‌دهد. تابع را اجرا کرده و نتیجه را برمی‌گردانید. مدل بر اساس خروجی گفتگو را ادامه می‌دهد. این از منطق پیچیده در ربات‌های نقش‌آفرینی پشتیبانی می‌کند. می‌توانید ابزارهای متعددی برای اقدامات مختلف تعریف کنید. API پردازش و مسیریابی را مدیریت می‌کند. مطمئن شوید که طرح‌های ابزار شما JSON معتبر هستند. این از خطاها در فرآیند فراخوانی تابع جلوگیری می‌کند.

فعال‌سازی حالت JSON

مدل را مجبور به خروجی JSON معتبر کنید. تنظیم response_format به {"type": "json_object"}. این اطمینان حاصل می‌کند که داده‌های ساختاریافته برای تجزیه وجود دارد. این را برای وضعیت‌های بازی یا پاسخ‌های API استفاده کنید. مدل فرمت‌بندی markdown اضافه نمی‌کند. آن تنها JSON خام برمی‌گرداند. این برای پایپ‌لاین‌های خودکار مفید است. می‌توانید خروجی را مستقیماً در کد خود تجزیه کنید. خطاها در ساختار JSON نادر اما امکان‌پذیر هستند. خروجی را در لایه برنامه خود اعتبارسنجی کنید. این یک تور ایمنی برای سیستم‌های تولید اضافه می‌کند. حالت JSON در کنار فراخوانی تابع کار می‌کند. می‌توانید هر دو را برای تعاملات پیچیده ترکیب کنید. پنجره زمینه‌ی کل تبادل را در بر می‌گیرد. مصرف توکن خود را به طور مناسب برنامه‌ریزی کنید تا در حدود محدودیت‌ها بمانید.

Limits, errors, and context window

شما به ۳۰۰ درخواست در دقیقه به ازای هر کلید محدود هستید. درخواست‌های همزمان به ۸ به ازای هر کلید محدود شده‌اند. بدنه درخواست نباید از ۸ مگابایت تجاوز کند. این محدودیت‌ها از بارگذاری بیش از حد سرور در زمان‌های اوج استفاده جلوگیری می‌کنند. خطاها کدهای وضعیت HTTP استاندارد را برمی‌گردانند. 401 نشان‌دهنده کلید نامعتبر یا منقضی شده است. 402 نشان می‌دهد که اعتبار پیش‌پرداخت شما تمام شده است. 429 به این معنی است که شما از محدودیت نرخ تجاوز کرده‌اید. قبل از تلاش مجدد پس از خطای 429 صبر کنید. پنجره متن ۱۰۰,۰۰۰ توکن است. این شامل توکن‌های پرامپت و تکمیل است. مکالمات طولانی ممکن است نیاز به استراتژی‌های برش داشته باشند. استفاده از توکن خود را مدیریت کنید تا از هزینه‌های غیرمنتظره جلوگیری کنید. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید استفاده را هر زمان متوقف کنید. این انعطاف‌پذیری برای تولید حجم بالا به صورت متناوب مناسب است.

cURL

Copycurl https://api.restrictionsnoai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three spicy dialogue lines for a vampire character"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)