Quickstart: Integrate NSFW LLM API

Prerequisites: API Key and SDK

ابتدا یک حساب کاربری ایجاد کنید و کلید API خود را تولید کنید. در صفحه دریافت کلید API، با استفاده از ادامه با گوگل یا ایمیل و رمز عبور ثبت‌نام کنید. شماره تلفن لازم نیست. هر حساب کاربری فقط یک کلید فعال دریافت می‌کند؛ ایجاد کلید جدید، کلید قبلی را بلافاصله جایگزین می‌کند. این کلید را امن نگه دارید، زیرا تمام درخواست‌ها به base URL ما را احراز هویت می‌کند: https://api.chatbotnsfw.com/v1.

پیشنهاد می‌کنیم SDK رسمی برای زبان مورد علاقه‌تان نصب کنید. API ما از رابط استاندارد OpenAI پیروی می‌کند، به این معنی که احتمالاً ابزارهای مورد نیازتان را از قبل دارید. تنها کافی است SDK را به base_url اختصاصی ما اشاره دهید و کلید خود را به هدر authorization تزریق کنید.

مشتری را راه‌اندازی کنید

کتابخانه کلاینت خود را برای ارتباط با سرویس LLM بدون سانسور ما پیکربندی کنید. base URL را به نقطه پایانی ما تنظیم کنید و کلید API تولید شده خود را اختصاص دهید. این اطمینان حاصل می‌کند که تمام درخواست‌های بعدی به درستی به سرورهای ما هدایت می‌شوند. نیازی به پیکربندی مسیریابی پیچیده یا انتخاب از میان مدل‌های مختلف ندارید.

• Base URL: https://api.chatbotnsfw.com/v1
• شناسه مدل: uncensored
• احراز هویت: توکن Bearer از طریق کلید API

این پیکربندی با هر کلاینتی که با OpenAI سازگار است کار می‌کند. شیء پیکربندی را مطابق با الزامات SDK خود تنظیم کنید. مدل uncensored یک مدل با وزن‌های باز است که برای محتوای بزرگسالان بدون رد کردن کاربردهای قانونی تنظیم شده است.

ارسال یک تکمیل مکالمه ساده

اولین درخواست خود را برای تولید متن ارسال کنید. از نقطه پایانی POST /v1/chat/completions استفاده کنید. یک آرایه پیام شامل درخواست کاربر ارسال کنید. مدل یک پاسخ متنی بازگردانی می‌کند. این یک فراخوانی استاندارد chat-completions است. هیچ embedding یا تولید تصویری در کار نیست.

Copycurl https://api.chatbotnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the user verification script on test account 77"}]
  }'

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

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

برای تحویل توکن‌ها به صورت بلادرنگ از رویدادهای ارسالی سرور (SSE) استفاده کنید. پخش زنده تجربه کاربری بهتری برای پاسخ‌های طولانی فراهم می‌کند. پارامتر stream را در درخواست خود روی true تنظیم کنید. API قطعات را همان‌طور که تولید می‌شوند برمی‌گرداند. هر قطعه را پردازش کنید تا رابط کاربری خود را به صورت تدریجی به‌روزرسانی کنید.

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)

تکه نهایی شامل مجموع مصرف توکن برای درخواست است. این به شما امکان می‌دهد هزینه‌ها را به دقت ردیابی کنید. استریم با تمام پارامترهای استاندارد کار می‌کند. این برای سناریوهای نقش‌آفرینی که در آن‌ها تأخیر اهمیت دارد، ایده‌آل است. رویداد پایان استریم را مدیریت کنید تا اتصال خود را به درستی ببندید.

پارامترها را برای محتوای NSFW پیکربندی کنید

رفتار مدل را با استفاده از پارامترهای استاندارد تنظیم کنید. temperature را برای خلاقیت تنظیم کنید. از top_p برای نمونه‌گیری هسته استفاده کنید. دنباله‌های stop را برای کنترل طول خروجی تنظیم کنید. از seed برای نتایج قابل تکرار استفاده کنید. این پارامترها بر نحوه تولید متن توسط مدل بدون سانسور تأثیر می‌گذارند.

Copyfrom openai import OpenAI

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

با تنظیم response_format روی {"type": "json_object"} حالت JSON را فعال کنید. این قابلیت برای خروجی‌های داده ساختاریافته مفید است. همچنین از Function calling از طریق پارامتر tools پشتیبانی می‌شود. می‌توانید tool_choice را برای رفتارهای خاص مشخص کنید. این قابلیت‌ها به‌طور یکپارچه با API ما کار می‌کنند.

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

محدودیت‌ها و کدهای خطا را درک کنید. پنجره زمینه ۱۰۰,۰۰۰ توکن در مجموع است. محدودیت جداگانه‌ای برای خروجی وجود ندارد: یک پاسخ می‌تواند از تمام فضای باقی‌مانده در پنجره استفاده کند. اگر max_tokens را تنظیم نکنید، پاسخ می‌تواند تا انتهای پنجره ادامه یابد. شما مجاز به ۳۰۰ درخواست در دقیقه هستید. درخواست‌های همزمان به ۸ درخواست در کلید محدود شده‌اند. بدنه درخواست‌ها نمی‌تواند از ۸ مگابایت بیشتر باشد.

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

Node.js

Copyimport OpenAI from "openai";

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