مستندات API سازگار با OpenAI

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

هر درخواست را با تنظیم base_url به https://api.nsfwgemma.com/v1 و کلید API خود را در Authorization header. کلید خود را بلافاصله پس از ثبت‌نام با گوگل یا ایمیل، بدون نیاز به شماره تلفن دریافت می‌کنید. این کلید را امن نگه دارید، زیرا تنها اعتبار مورد نیاز برای دسترسی به سرویس است.

POST /v1/chat/completion: پارامترها و مثال‌ها

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

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

اطمینان حاصل کنید که پیکربندی شما شامل model field set to "uncensored" and a messages آرایه‌ای شامل پرامپت شما. سیستم یک پاسخ JSON ساختاریافته شامل متن تولید شده برمی‌گرداند.

GET /v1/models: فهرست مدل‌های موجود

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

Copyfrom openai import OpenAI

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

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

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

استریمینگ را با تنظیم stream: true برای دریافت توکن‌ها به‌صورت بلادرنگ از طریق رویدادهای ارسالی سرور (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)

هر شیء دلتا را پارز کنید تا متن را به‌صورت تدریجی رندر کنید و تجربه کاربری روان‌تری برای برنامه‌های کاربردی چت‌بات NSFW تعاملی فراهم کنید.

مدیریت خطا و مصرف توکن

خطاهای رایج HTTP را به‌خوبی مدیریت کنید: 401 نشان‌دهنده کلید نامعتبر یا منقضی‌شده است، 402 به این معنی است که نیاز به شارژ اعتبار دارید و 429 نشان‌دهنده اشباع محدودیت نرخ است. خطاها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند، بنابراین می‌توانید بدون جریمه تلاش مجدد کنید. همیشه بررسی کنید usage field in successful responses to track consumption.

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

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

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

پارامترهای پشتیبانی‌شده: دما، Top P و موارد دیگر

تصادفی بودن و قطعیت را با استفاده از کنترل کنید temperature, top_p, stop, seed, و پارامترهای جریمه. از response_format تنظیم شده روی {"type": "json_object"} برای خروجی‌های داده ساختاریافته. فراخوانی تابع از طریق tools پارامتر برای یکپارچه‌سازی‌های پیشرفته.

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

Node.js

Copyimport OpenAI from "openai";

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