مستندات API

کلیدهای احراز هویت

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

Copycurl https://api.mostunhingedai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send my invoice for 50k tokens"}]
  }'

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

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

پیام‌ها را به POST /v1/chat/completions برای استنتاج. URL پایه https://api.mostunhingedai.com/v1. درخواست‌ها آرایه‌های پیام استاندارد را با role و content فیلدها. شناسه مدل uncensored. پاسخ‌های متنی بدون رد شدن محتوا برای مواد بزرگسالان قانونی دریافت می‌کنید. خطاهایی مانند کلیدهای نامعتبر کدهای وضعیت 401 برمی‌گردانند.

Copyfrom openai import OpenAI

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

پنجره‌های زمینه در مجموع 100,000 توکن را نگه می‌دارند. محدودیت‌های خروجی به طور پیش‌فرض 2,048 توکن هستند مگر اینکه مقدار بالاتری مشخص کنید max_tokens مقدار تا 16,000. توکن‌های ورودی و خروجی از موجودی از پیش پرداخت شده شما کسر می‌شوند.

نقطه پایانی مدل‌ها

مدل‌های موجود را از طریق GET /v1/models. این انتهای‌بند، متاداده‌ای درباره مدل میزبانی‌شده تکی را برمی‌گرداند. شناسه uncensored و قابلیت‌های آن. هیچ مدل دیگری در این نمونه وجود ندارد. از این نقطه پایانی برای بررسی اتصال قبل از ارسال بارهای سنگین استفاده کنید.

Copyimport OpenAI from "openai";

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

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

پارامترها و تنظیمات

رفتار تولید را با پارامترهای استاندارد استفاده کنید temperature برای تصادفی بودن و top_p برای نمونه‌گیری هسته. Set seed برای خروجی‌های تکرارپذیر هنگام رفع اشکال. مدل stop پارامتر را برای فراخوانی تابع تنظیم کنید. تولید را در رشته‌های خاص متوقف می‌کند. مقدار presence_penalty و frequency_penalty برای کاهش تکرار.

این تنظیمات مستقیماً بر قدرت استنتاج تأثیر می‌گذارند. هیچ فیلتر پنهانی این مقادیر را تغییر نمی‌دهد. شما کنترل کاملی بر توزیع خروجی دارید. مقادیر پیش‌فرض با استانداردهای رایج صنعتی برای پایداری مطابقت دارند.

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

فعال‌سازی تحویل توکن بلادرنگ با تنظیم stream: true. API رویدادهای ارسال سرور (SSE) را برمی‌گرداند. هر قطعه متن جزئی و آمار استفاده را شامل می‌شود. قطعه نهایی شامل تعداد کلی توکن برای درخواست است. تجزیه choices آرایه در هر شیء 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)

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

Limits, errors, and context

به محدودیت نرخ 300 درخواست در دقیقه به ازای هر کلید احترام بگذارید. همزمانی به 8 درخواست همزمان محدود می‌شود. بدنه درخواست‌ها باید کمتر از 8 مگابایت باشد. وضعیت 429 نشان می‌دهد که از این محدودیت‌ها عبور کرده‌اید. صبر کنید و با استفاده از بازگشت نمایی مجدداً تلاش کنید.

خطاها کدهای خاصی دارند. 401 به این معنی است که کلید شما نامعتبر است. 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. بازپرداخت برای توکن‌های مصرف شده امکان‌پذیر نیست، اما اعتبار استفاده نشده هرگز منقضی نمی‌شود. پنجره زمینه 100,000 توکن شامل هر دو توکن ورودی و خروجی است. اندازه ورودی خود را به دقت برنامه‌ریزی کنید تا از بریدگی جلوگیری کنید.