مستندات API بدون سانسور

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

کلید API شما هر درخواست را احراز هویت می‌کند. از URL پایه HTTPS://api.uncensores.cc/v1 با هر SDK استاندارد OpenAI استفاده کنید. شناسه مدل "uncensored" است. کلید خود را در هدر Authorization به عنوان یک توکن Bearer ارسال کنید. می‌توانید کلیدی را از طریق داشبورد با استفاده از گوگل یا ایمیل ایجاد کنید. هر حساب یک کلید فعال دارد که کلید قبلی را جایگزین می‌کند.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

شما باید فیلد model را در هر درخواستی گنجانید. نقطه پایانی یک آرایه messages شامل تاریخچه مکالمه شما را انتظار دارد. اگر کلید وجود نداشته باشد یا نامعتبر باشد، API خطای 401 برمی‌گرداند. این تضمین می‌کند که فقط کاربران مجاز از اعتبار از پیش پرداخت شده شما استفاده کنند.

نقطه پایانی تکمیل گفتگو

درخواست‌های POST را به /v1/chat/completions برای تولید متن ارسال کنید. این نقطه پایدار درخواست‌های گفتگوی استاندارد را مدیریت کرده و پاسخ‌های متنی ساختاریافته برمی‌گرداند. از جاسازی یا تولید تصویر پشتیبانی نمی‌کند. شما پیام‌های system، user و assistant را برای راهنمایی مدل ارائه می‌دهید. مدل با محتوای متنی خام درون آرایه choices پاسخ می‌دهد.

Copyfrom openai import OpenAI

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

کلاینت را با URL پایه و کلید خود مقداردهی اولیه کنید. لیست پیام‌ها را با نقش و محتوای مورد نظر خود تعریف کنید. متد chat.completions.create را اجرا کنید. شیء پاسخ شامل متن تولید شده و آمار مصرف است. این رویکرد مستقیم، پیچیدگی مسیریابی را برای وظایف NSFW یا نویسندگی خلاق حذف می‌کند.

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

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

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)

قطعه نهایی شامل آمار کامل استفاده برای درخواست است. این امکان ردیابی مصرف توکن را به صورت بلادرنگ فراهم می‌کند. استریم برای رابط‌های چت که کاربران انتظار بازخورد فوری دارند ایده‌آل است. این ویژگی به صورت یکپارچه با فرمت خروجی مدل uncensored کار می‌کند.

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

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensores.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 ارسال کنید. مدل بر اساس ورودی، تابع مناسب را انتخاب می‌کند. نام تابع و آرگومان‌ها را در پاسخ دریافت می‌کنید. این قابلیت در کنار تکمیل‌های چت استاندارد و بدون نیاز به اندپوینت‌های اضافی کار می‌کند. برای استخراج داده‌های ساختاریافته یا رفتار شبیه به عامل (agent) از آن استفاده کنید.

پارامترها: دما، Top-P و Seeds

دمای (temperature) را برای کنترل تصادفی‌سازی تنظیم کنید. مقادیر بالاتر از ۱ خلاقیت را افزایش می‌دهند، در حالی که مقادیر کمتر از ۱ خروجی‌ها را قطعی‌تر می‌کنند. از top_p برای محدود کردن نمونه‌گیری به درصد بالایی از جرم احتمالی استفاده کنید. seed را برای نتایج قابل تکرار در درخواست‌های یکسان تنظیم کنید. این پارامترها به شما امکان می‌دهند سبک خروجی مدل uncensored را تنظیم کنید.

شما همچنین می‌توانید از دنباله‌های توقف (stop sequences) برای توقف تولید در رشته‌های خاص استفاده کنید. presence_penalty و frequency_penalty به کاهش تکرار کمک می‌کنند. دمای پیش‌فرض ۱.۰ است. تنظیم این پارامترها به بهینه‌سازی برای نقش‌آفرینی یا نگارش فنی کمک می‌کند. هر درخواست از این پارامترهای استاندارد سازگار با OpenAI پشتیبانی می‌کند.

محدودیت‌های توکن و پنجره زمینه

پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن برای ورودی (Prompt) و خروجی (Completion) پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست خروجی بگیرید. اگر max_tokens را نادیده بگیرید، پیش‌فرض ۲,۰۴۸ توکن است. این محدودیت شامل ورودی و خروجی ترکیبی می‌شود. درخواست‌هایی که از حجم بدنه ۸ مگابایت تجاوز کنند، شکست می‌خورند. API نرخ محدودیت ۳۰۰ درخواست در دقیقه را اعمال می‌کند. درخواست‌های همزمان به ۸ به ازای هر کلید محدود شده‌اند. خطاهایی مانند 402 (بدون اعتبار) یا 429 (حد نرخ) بازخورد واضحی ارائه می‌دهند. اعتبار استفاده نشده هرگز منقضی نمی‌شود، بنابراین شما فقط بابت استفاده واقعی پرداخت می‌کنید.