مستندات فنی API هوش مصنوعی unzensierte

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

URL پایه https://api.unzensierteki.com/v1 و یک کلید API در هدر نیاز است Authorization: Bearer <KEY>. این کلید بلافاصله پس از ثبت‌نام از طریق Google یا ایمیل در صفحه "Get API key" به شما داده می‌شود. هر حساب فقط یک کلید فعال نگه می‌دارد؛ یک کلید جدید جایگزین قبلی می‌شود. احراز هویت ساده است و با هر کلاینت سازگار با OpenAI کار می‌کند.

Copycurl https://api.unzensierteki.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Rolle: du bist mein Assistent. Gib mir eine kurze Zusammenfassung."}]
  }'

یک کلید معتبر دسترسی به تمام نقاط پایانی (Endpoints) را مجاز می‌کند. یک کلید نامعتبر خطای 401 ایجاد می‌کند. اگر اتصال شکست خورد، ورودی کلید خود را بررسی کنید.

POST /v1/chat/completions: پارامتر و ساختار

پرامپت‌های خود را به نقطه پایانی /v1/chat/completions با شناسه مدل "uncensored". این نقطه پایانی ورودی‌های متنی را پردازش کرده و خروجی‌های متنی را بدون فیلتر محتوا برای کاربران بزرگسال تولید می‌کند. می‌توانید پارامترهایی مانند temperature, top_p und stop تنظیم کنید تا رفتار مدل را کنترل کنید. مدل به تمام موضوعات پاسخ می‌دهد، به شرطی که از نظر قانونی مجاز باشند.

Copyfrom openai import OpenAI

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

ساختار درخواست از استاندارد OpenAI Chat Completions پیروی می‌کند. شما همچنین می‌توانید presence_penalty und frequency_penalty برای کنترل تکرار کلمات استفاده می‌شود. این برای بازی‌های نقش‌آفرینی و ماجراجویی‌های متنی ایده‌آل است.

استریم با 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)

استریم برای کاهش تأخیر برای کاربر نهایی مفید است. می‌توانید توکن‌ها را بلافاصله پردازش کنید و نیازی به انتظار برای پاسخ کامل نیست. آمار توکن‌ها به کنترل هزینه‌ها کمک می‌کند.

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

استفاده کنید response_format: {"type": "json_object"}, برای تحمیل خروجی JSON دقیق. این برای ادغام در برنامه‌هایی که داده‌های ساختاریافته نیاز دارند حیاتی است. شما همچنین می‌توانید tools und tool_choice برای فراخوانی ویژگی‌ها استفاده می‌شود. مدل از Tool-Calling برای گردش کارهای پیچیده پشتیبانی می‌کند.

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

پایان‌نقطه مدل و محدودیت‌های توکن

نقطه پایان GET /v1/models مدل‌های موجود را فهرست کنید. مدل "uncensored" از یک پنجره زمینه 100,000 توکنی (ورودی به علاوه خروجی) پشتیبانی می‌کند. حداکثر خروجی به ازای هر درخواست 16,000 توکن است. اگر max_tokens اگر تنظیم نشده باشد، حداکثر خروجی 2.048 توکن است.

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

محدودیت‌ها، خطاها و کنترل هزینه

محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید و حداکثر ۸ درخواست موازی است. بدنه درخواست نباید بیشتر از ۸ مگابایت باشد. خطاهایی مانند ۴۰۱ (کلید نامعتبر)، ۴۰۲ (موجودی ناکافی) یا ۴۲۹ (محدودیت نرخ) به شما بازخورد می‌دهند. درخواست‌های نامعتبر محاسبه نمی‌شوند.

موجودی فقط در صورت استفاده موفقیت‌آمیز از توکن مصرف می‌شود. خطای ۴۲۹ به این معنی است که به محدودیت رسیده‌اید. قبل از تلاش مجدد برای ارسال درخواست، کمی صبر کنید. این از زیر بار رفتن زیرساخت جلوگیری می‌کند.

Node.js

Copyimport OpenAI from "openai";

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