شروع سریع API مدل NSFW

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

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

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

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

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

درخواست POST را به /v1/chat/completions ارسال کنید و نام مدل و آرایه پیام‌ها را وارد کنید. API تکمیل‌های متنی بر اساس زمینه پرامپت شما برمی‌گرداند. باید شناسه مدل را روی "uncensored" تنظیم کنید تا نتایج یکسانی دریافت کنید.

توکن‌های ورودی به ازای هر میلیون توکن ۰.۱۵ دلار هزینه دارند، در حالی که توکن‌های خروجی ۰.۵۰ دلار به ازای هر میلیون توکن هستند. هزینه‌ها فقط برای تکمیل‌های موفق اعمال می‌شوند، نه خطاها.

• مدل را روی "uncensored" تنظیم کنید.
• یک آرایه پیام‌ها با نقش و محتوا ارائه دهید.
• کلید API خود را در هدرها قرار دهید.

این پیکربندی ساده برای نقش‌آفرینی، نویسندگی خلاق یا وظایف پردازش داده کار می‌کند.

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

استفاده از SDK‌های Python و Node

SDKهای رسمی OpenAI Python یا Node را نصب کنید و آن‌ها را به URL پایه ما اشاره دهید. این به شما اجازه می‌دهد از روش‌های آشنا مانند .chat.completions.create() بدون بازنویسی منطق خود استفاده کنید.

کلید API خود را به عنوان آرگومان api_key ارسال کنید. base_url را روی HTTPS://api.modelnsfw.cc/v1 تنظیم کنید تا درخواست‌ها به درستی هدایت شوند. این روش یکپارچه‌سازی برای پروژه‌های موجود را ساده می‌کند.

هر دو SDK سریال‌سازی JSON و منطق تلاش مجدد را به صورت خودکار مدیریت می‌کنند. می‌توانید پارامترهایی مانند temperature یا top_p را برای کنترل خلاقیت تنظیم کنید.

خطاها به عنوان کدهای وضعیت HTTP استاندارد بازگردانده می‌شوند. می‌توانید استثناها را دریافت کرده و آن‌ها را در منطق برنامه خود مدیریت کنید.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

پاسخ‌های استریم و مصرف توکن

استریمینگ را با تنظیم stream به true در بدنه درخواست فعال کنید. API از طریق رویدادهای Server-Sent (SSE) برای خروجی بلادرنگ، قطعات را برمی‌گرداند. این کار تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد.

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

استریم برای رابط‌های چت یا تولید متن زنده خوب عمل می‌کند. به کاربران اجازه می‌دهد محتوا را همان‌طور که تولید می‌شود ببینند.

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

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)

Function Calling & JSON Mode

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

حالت JSON را با تنظیم response_format به json_object فعال کنید. مدل خروجی JSON کاملاً معتبر برمی‌گرداند و تضمین می‌کند که پارسر شما هرگز شکست نمی‌خورد. این برای یکپارچه‌سازی‌های API که به ساختارهای داده خاص نیاز دارند ایده‌آل است.

هر دو ویژگی را برای کارهای پیچیده ترکیب کنید. می‌توانید داده‌ها را استخراج و همزمان توابع را فراخوانی کنید.

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

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

پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای ورودی (prompt) و خروجی (completion) ترکیبی پشتیبانی می‌کند. این امکان اسناد بزرگ یا مکالمات طولانی را فراهم می‌کند. شما می‌توانید تا ۱۶,۰۰۰ توکن را در یک پاسخ واحد ارسال کنید.

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

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

اعتبار شما منقضی نمی‌شود. می‌توانید هر زمان با رمزارز شارژ کنید بدون اینکه موجودی خود را از دست بدهید.