مستندات API

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

آدرس پایه HTTPS://api.nsfwcom.com/v1. کلید API خود را به Authorization هدر به عنوان یک توکن bearer. این هدر هر درخواست ارسالی به نقطه پایگاه را احراز هویت می‌کند.

• کلید خود را در هر درخواست قرار دهید.
• کلید خود را امن نگه دارید و آن را به صورت عمومی به اشتراک نگذارید.

کلید خود را از طریق داشبورد ایجاد کنید و بلافاصله شروع به یکپارچه‌سازی (integration) کنید.

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

یک درخواست POST به /v1/chat/completions با پیام‌ها و نام مدل. API بر اساس پرامپت شما، تکمیل‌های متنی برمی‌گرداند.

Copycurl https://api.nsfwcom.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five benefits of remote work for engineers"}]
  }'

شناسه مدل را استفاده کنید uncensored برای اطمینان از خروجی‌های یکسان و بدون فیلتر برای مورد استفاده شما. پارامترهایی مانند temperature برای کنترل خلاقیت.

SDK Python

از کتابخانه رسمی پایتون OpenAI برای ارتباط با API به سادگی استفاده کنید. آدرس پایه را به انتهای کار ما تنظیم کرده و کلید API خود را ارائه دهید.

Copyfrom openai import OpenAI

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

این رویکرد به شما اجازه می‌دهد از روش‌های آشنا SDK برای تکمیل چت استفاده کنید. می‌توانید لیستی از پیام‌ها را ارسال کنید و پاسخ‌های متنی ساختاریافته را مستقیماً در اسکریپت‌های Python دریافت کنید.

Node SDK

پکیج OpenAI Node.js را نصب کنید و آن را با URL پایه ما پیکربندی کنید. این به شما اجازه می‌دهد API را به راحتی در پروژه‌های JavaScript یا TypeScript خود ادغام کنید.

Copyimport OpenAI from "openai";

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

آرایه پیام‌های خود را تعریف کنید و endpoint تکمیل را فراخوانی کنید. SDK درخواست‌های HTTP و تجزیه را مدیریت می‌کند و متن تولیدشده را برای منطق برنامه شما بازمی‌گرداند.

پاسخ‌های استریم از طریق 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 Window) در مجموع ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. محدودیت‌های درخواست خود را مانیتور کنید تا از اختلال در سرویس جلوگیری کنید. خطاهای رایج شامل 401 برای کلیدهای نامعتبر، 402 برای اعتبار کافی نیست، و 429 برای محدودیت‌های نرخ.

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