مستندات API

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

کلید API شما هر درخواست را احراز هویت می‌کند. از URL پایه https://api.modelsaiunrestricted.com/v1 برای تمام فراخوانی‌ها. کلید خود را در صفحه Get API Key از طریق گوگل یا ایمیل ایجاد کنید. سیستم کلیدهای نامعتبر را با خطای 401 رد می‌کند. کلید خود را به صورت امن نگهداری کنید.

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

پیام‌ها را به uncensored مدل از طریق POST /v1/chat/completions. این نقطه پایانی ورودی متنی را مدیریت کرده و خروجی متنی برمی‌گرداند. کاملاً با OpenAI سازگار است.

Copyfrom openai import OpenAI

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

از SDK رسمی OpenAI یا هر کلاینت سازگار استفاده کنید. شناسه مدل را روی uncensored. پنجره زمینه از ۱۰۰,۰۰۰ توکن به صورت کلی پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. خطاها و رد شدن‌ها توکن مصرف نمی‌کنند.

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

دریافت توکن‌ها به‌صورت بلادرنگ با استفاده از رویدادهای ارسالی سرور (SSE). Streaming را با تنظیم stream: true در درخواست شما. این موضوع تأخیر ادراک‌شده برای پاسخ‌های طولانی را کاهش می‌دهد.

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)

قطعه نهایی شامل آمار کامل استفاده از توکن است. جریان را تجزیه کنید تا توکن‌ها را هنگام تولید نمایش دهید. این برای رابط‌های چت ایده‌آل است. اگر نیاز دارید متن کامل را بعداً جمع‌آوری کنید، خروجی را بافر کنید.

پارامترها: دما و Top P

خلاقیت را با temperature و تنوع را با top_p. مقادیر پایین‌تر خروجی‌ها را قطعی‌تر می‌کنند. مقادیر بالاتر تنوع بیشتری ایجاد می‌کنند.

دمای پیش‌فرض 1.0 است. top_p پیش‌فرض 0.9 است. این‌ها را برای وظایف نقش‌آفرینی یا واقعی تنظیم کنید. همچنین می‌توانید تنظیم کنید seed برای نتایج تکرارپذیر. از stop sequences برای توقف تولید زودهنگام.

پارامترهای نامعتبر خطای 400 برمی‌گردانند. محدوده‌های معتبر را در schema بررسی کنید.

Function Calling & JSON Mode

از خروجی‌های ساختاریافته برای استخراج داده‌های قابل‌اعتماد استفاده کنید. حالت JSON را با فعال کنید response_format: {"type": "json_object"}مدل JSON کاملاً معتبر را برمی‌گرداند. این از خطاهای تجزیه در کد شما جلوگیری می‌کند.

Copyimport OpenAI from "openai";

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

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

محدودیت‌ها، خطاها و & زمینه

محدودیت‌های نرخ ۳۰۰ درخواست در دقیقه به ازای هر کلید است. همزمانی به ۸ درخواست همزمان محدود می‌شود. بدنه‌های درخواست باید زیر ۸ مگابایت بمانند. تجاوز از این محدودیت‌ها باعث خطای 429 می‌شود.

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

cURL

Copycurl https://api.modelsaiunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source models for local inference."}]
  }'