شروع سریع: ادغام API برتر NSFW

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

API برتر NSFW از یک URL پایه واحد برای تمام درخواست‌ها استفاده می‌کند. URL پایه را در پیکربندی SDK OpenAI خود تغییر دهید تا https://api.nsfwtop.cc/v1. کلید API خود را در Authorization header. یک کلید فعال برای هر حساب دریافت می‌کنید. کلید بلافاصله پس از ثبت‌نام با گوگل یا ایمیل ظاهر می‌شود.

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

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

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

یک درخواست تکمیل چت را با استفاده از SDK رسمی پایتون OpenAI ارسال کنید. کلاینت را با URL پایه سفارشی و کلید API خود پیکربندی کنید. از شناسه مدل uncensored برای پاسخ‌ها بدون ردی‌های استاندارد محتوا.

Copyfrom openai import OpenAI

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

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

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

از SDK نود OpenAI برای یکپارچه‌سازی API در برنامه‌های جاوااسکریپت یا تایپ‌اسکریپت خود استفاده کنید. کلاینت را با baseURL pointing to the NSFW top endpoint. کلید API خود را به عنوان apiKey مقدار.

Copyimport OpenAI from "openai";

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

فراخوانی chat.completions.create() با مدل uncensored. پاسخ شامل متن تولید شده و جزئیات مصرف توکن است. می‌توانید پاسخ‌ها را به صورت پخشی (Stream) دریافت کنید یا آن‌ها را به صورت یکجا بسته به نیاز خود دریافت نمایید.

پاسخ‌های جریان‌دار با SSE

استریمینگ را با تنظیم 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) را به صورت بلادرنگ ردیابی کنید. استریم با تمام پارامترهایی مانند temperature و top_p.

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

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

فراخوانی تابع از طریق tools پارامتر. توابع را در tools آرایه. مدل می‌تواند این توابع را فراخوانی کرده و استدلال‌های ساختاریافته را برگرداند. از tool_choice برای کنترل زمان فراخوانی توابع.

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

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

اگر اعتباری نداشته باشید، درخواست‌ها خطای 402 برمی‌گردانند. خطاها و رد شدن‌ها توکن مصرف نمی‌کنند. پنجره زمینه (context window) اجازه می‌دهد 100,000 توکن به طور کلی برای prompt و completion وجود داشته باشد. مصرف توکن‌های خود را به دقت مدیریت کنید تا از هزینه‌های غیرمنتظره جلوگیری کنید.