مستندات API برای توسعه‌دهندگان

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

کلید API شما هر درخواست را احراز هویت می‌کند. از https://api.nsfwtext.cc/v1 به‌عنوان آدرس پایه (base URL). کلید را در Authorization header. این پیکربندی با هر کلاینت سازگار با OpenAI کار می‌کند.

Copycurl https://api.nsfwtext.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status now"}]
  }'

کلید خود را به‌طور فوری از طریق Google یا ایمیل ایجاد کنید. نیاز به شماره تلفن نیست. کلید بلافاصله پس از ثبت‌نام ظاهر می‌شود.

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

ارسان اولین پیام به مدل uncensored. از شناسه مدل uncensored برای خروجی خام. نقطه پایانی بارهای chat-completions استاندارد را می‌پذیرد.

Copyfrom openai import OpenAI

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

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

پاسخ‌های استریم

توکن‌ها را به‌صورت بلادرنگ از طریق رویدادهای ارسال‌شده توسط سرور (SSE) دریافت کنید. پخش زنده را با تنظیم 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)

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

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

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

Copyimport OpenAI from "openai";

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

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

پارامترها و زمینه

تولید را با کنترل کنید temperature, top_p، و seed. پنجره زمینه از ۱۰۰,۰۰۰ توکن به صورت کلی پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است.

تنظیم max_tokens برای جلوگیری از استفاده بیش از حد. استفاده stop توالی‌ها برای کوتاه کردن زودهنگام خروجی. تنظیم presence_penalty برای تنوع.

Limits and Errors

محدودیت‌های نرخ اجازه ۳۰۰ درخواست در دقیقه را می‌دهند. همزمانی به ۸ درخواست همزمان محدود می‌شود. حجم بدنه درخواست باید کمتر از ۸ مگابایت باشد.

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