مستندات API Unzensierte

شروع سریع: ارسال اولین درخواست خود

API بدون سانسور یک سرویس سازگار با OpenAI است. شما به ازای هر توکن تولید متن بدون فیلترهای محتوا پرداخت می‌کنید. یک درخواست POST به endpoint تکمیل چت با کلید API خود ارسال کنید. مدل پرامپت شما را پردازش کرده و خروجی متنی را مستقیماً برمی‌گرداند.

ابتدا با کلید خود احراز هویت کنید. سپس شناسه مدل را به‌عنوان "uncensored" تعریف کنید. آرایه پیام‌های خود را با نقش و محتوا مشخص کنید. سرور با متن تولیدشده پاسخ می‌دهد. این کار با هر کلاینت HTTP یا SDK استاندارد کار می‌کند. شما متن خام دریافت می‌کنید، بدون سربار قالب‌بندی اضافی. خطاها JSON با کد خطا برمی‌گردانند. از این مسیر سریع برای بررسی تنظیمات خود قبل از ساخت برنامه‌های پیچیده استفاده کنید.

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

احراز هویت از یک کلید API واحد که در هدر ارسال میشود استفاده میکند. URL پایه HTTPS://api.unzensierte.cc/v1 است. این URL با SDKهای رسمی OpenAI با تنظیم پارامتر base_url کار میکند. کلید شما حساب و مصرف توکن را شناسایی و ردیابی میکند. کلید را در صفحه Get API key تولید کنید. بلافاصله پس از ثبت‌نام از طریق گوگل یا ایمیل ظاهر میشود. این کلید را در هر درخواست استفاده کنید. کلیدهای نامعتبر خطای 401 و کلیدهای منقضی یا دارای اعتبار ناکافی خطای 402 برمیگردانند.

کلید خود را امن نگه دارید. یک کلید فعال برای هر حساب کاربری. کلید جدید جایگزین کلید قبلی می‌شود. برای ثبت‌نام نیاز به شماره تلفن نیست. کلید API تنها اعتبار مورد نیاز برای دسترسی است.

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

نقطه پایانی اصلی POST /v1/chat/completions است. این نقطه پیکربندی‌های JSON شامل مدل، پیام‌ها و پارامترها را می‌پذیرد. شناسه مدل "uncensored" است. پیام‌ها نیازمند نقش و رشته محتوا هستند. سیستم با متن تولید شده در آرایه choices پاسخ می‌دهد. می‌توانید دما، top_p و دنباله‌های توقف را تنظیم کنید. این پارامترها خلاقیت و طول خروجی را کنترل می‌کنند. API مصرف توکن را در پاسخ باز می‌گرداند. خطاها شامل پیام و نوع هستند. از این نقطه پایانی برای تمام وظایف تولید متن استفاده کنید. این تنها نقطه پایانی متن موجود است. اینجا امبدینگ یا تولید تصویر وجود ندارد.

پاسخ‌های استریم‌شده و استفاده

با تنظیم stream به true، پخش زنده را فعال کنید. API رویدادهای سربرگ‌فرستاده‌شده (SSE) ارسال می‌کند. هر قطعه حاوی متن ناقص است. قطعه نهایی شامل داده‌های مصرف توکن است. این امکان نمایش بلادرنگ متن تولیدشده را فراهم می‌کند. قطعات را در برنامه خود بافر کنید. آن‌ها را ترکیب کنید تا پاسخ کامل را تشکیل دهند. پخش زنده، تأخیر ادراک‌شده را برای خروجی‌های طولانی کاهش می‌دهد. از این روش برای رابط‌های چت یا پردازش داده‌های زنده استفاده کنید. شیء usage تنها در آخرین قطعه ظاهر می‌شود. توکن‌های ورودی و خروجی را برای صورت‌حساب‌دهی ردیابی کنید. خطاهای حین پخش زنده نیز شیء خطا را در یک قطعه برمی‌گردانند.

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

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

Limits and error handling

محدودیت‌های نرخ ۳۰۰ درخواست در دقیقه به ازای هر کلید است. همزمانی به ۸ درخواست همزمان محدود است. بدنه‌های درخواست باید زیر ۸ مگابایت باشند. خطاها شامل کدهای خاصی مانند 401 برای کلیدهای نامعتبر هستند. 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. 429 نشان‌دهنده تجاوز از محدودیت نرخ است. پنجره زمینه ۱۰۰,۰۰۰ توکن به صورت کلی است. حداکثر خروجی ۱۶,۰۰۰ توکن به ازای هر درخواست است. خطاها JSON با جزئیات خطا را برمی‌گردانند. برای خطاهای 429 تلاش مجدد انجام دهید. قبل از استفاده سنگین، موجودی اعتبار را بررسی کنید. بازپرداخت برای اعتبار مصرف شده موجود نیست.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)