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

پیش‌نیازها و کلید API

کلید خود را از طریق داشبورد با استفاده از گوگل یا ایمیل دریافت کنید. نیازی به شماره تلفن نیست. هر حساب جدید $0.50 اعتبار آزمایشی برای 7 روز دریافت می‌کند.

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

آدرس پایه را به HTTPS://api.llmsnsfw.com/v1 تنظیم کنید. کلید خود را در هدر Authorization ارسال کنید. این با هر کلاینت استاندارد بدون کد سفارشی کار می‌کند.

Copycurl https://api.llmsnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word description of a dark fantasy scene"}]
  }'

ارسال یک درخواست تکمیل ساده (Basic Completion Request)

یک درخواست POST به /v1/chat/completions ارسال کنید. از مدل "uncensored" برای دسترسی مستقیم استفاده کنید. مدل بدون رد شدن‌های نرم (soft refusals) برای محتوای بزرگسالان قانونی پاسخ می‌دهد. از embedding یا تولید تصویر پشتیبانی نمی‌کند.

Copyfrom openai import OpenAI

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

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

از رویدادهای ارسالی سرور برای خروجی توکن‌به‌توکن استفاده کنید. stream را در بدنه روی true تنظیم کنید. قطعه‌ی نهایی شامل آمار استفاده است. این تأخیر ادراک‌شده را برای رابط‌های چت کاهش می‌دهد.

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

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

Copyimport OpenAI from "openai";

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

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

به دنبال خطاهای 401 (کلید نامعتبر) یا 402 (عدم اعتبار) بگردید. محدودیت نرخ 300 درخواست در دقیقه است. پنجره زمینه 100,000 توکن در مجموع است. حداکثر خروجی 16,000 توکن است مگر اینکه خلاف آن ذکر شود.