مستندات API

شروع سریع: URL پایه و احراز هویت

از نقطه پایانی میزبانی شده ما با کلید API خود برای دسترسی فوری استفاده کنید. URL پایه HTTPS://api.unfilteredaichatbots.com/v1 است و با هر کلاینت سازگار با OpenAI کار می‌کند. ما یک کلید API واحد برای هر حساب نیاز داریم و می‌توانید آن را به سرعت از طریق ورود با گوگل یا ایمیل ایجاد کنید. به شماره تلفنی نیاز نیست و کلید بلافاصله روی صفحه ظاهر می‌شود.

احراز هویت به استاندارد Authorization: Bearer <api-key> هدر. خطاهایی مانند 401 به معنای نامعتبر یا ناموجود بودن کلید شما است. اعتبارها از طریق ارز دیجیتال پیش‌پرداخت می‌شوند، بنابراین یک 402 خطا نشان‌دهنده این است که باید شارژ کنید. متن‌های شما برای آموزش استفاده نمی‌شوند و اعتبار هرگز منقضی نمی‌شود.

Copycurl https://api.unfilteredaichatbots.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten bugs in this python script"}]
  }'

شناسه مدل: 'uncensored'

همه درخواست‌ها را به شناسه مدل uncensored. این یک مدل با وزن باز است که برای پاسخ‌دهی بدون رد محتوای قانونی بزرگسالان بهینه‌سازی شده است. این مدل GPT، Claude یا هیچ ارائه‌دهنده دیگری نیست. ما بین ارائه‌دهندگان مختلف مسیریابی نمی‌کنیم و آدرس پایه برای هر درخواست ثابت می‌ماند.

مدل از پنجره زمینه ۱۰۰,۰۰۰ توکنی برای متن ورودی و خروجی ترکیب‌شده پشتیبانی می‌کند. می‌توانید جزئیات مدل را از طریق یک GET /v1/models تماس. متن وارد می‌شود، متن خارج می‌شود، بدون امبدینگ یا قابلیت تولید تصویر در این نقطه پایانی گنجانده شده است.

استریمینگ از طریق SSE

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

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

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

از tools پارامتری برای فعال‌سازی فراخوانی تابع. همچنین می‌توانید با response_format به {"type": "json_object"}. این اطمینان حاصل می‌کند که داده‌های ساختاریافته برای برنامه‌های شما وجود دارد بدون مراحل تجزیه اضافی. مدل بهینه‌سازی شده است تا این محدودیت‌ها را به طور قابل اعتماد دنبال کند.

هنگام استفاده از ابزارها، طرحواره تابع را در بدنه درخواست مشخص کنید. API در صورتی که مدل تصمیم به استفاده از آن بگیرد، فراخوانی تابع را در پاسخ بازگردانده می‌شود. این ویژگی در کنار استریم و پارامترهای استاندارد کار می‌کند. این ویژگی برای ساخت عامل‌هایی (agents) که نیاز به تعامل با سیستم‌های خارجی یا فرمت‌های داده ساختاریافته دارند، عالی است.

Copyfrom openai import OpenAI

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

پارامترها: دما، Top-p، Stop

تولید را با پارامترهای استاندارد مانند کنترل کنید temperature, top_p، و stop. این‌ها به شما امکان می‌دهند خلاقیت را تنظیم کرده و طول خروجی را کنترل کنید. مدل seed پارامتر قابلیت تکرار را برای تست فراهم می‌کند. همچنین می‌توانید presence_penalty و frequency_penalty برای تأثیر بر تنوع توکن‌ها.

مقادیر پیش‌فرض در صورت حذف این فیلدها اعمال می‌شوند. مدل بیشتر موارد استفاده رایج را به صورت پیش‌فرض مدیریت می‌کند. برای تنظیم دقیق خاص، این مقادیر را بر اساس نوع محتوای خود تنظیم کنید. استریم و فراخوانی تابع با این پارامترها به راحتی کار می‌کنند. از max_tokens field to cap output at 16,000 tokens.

Copyimport OpenAI from "openai";

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

Limits, errors, and context window

پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است، یا ۲,۰۴۸ اگر max_tokens تنظیم نشده است. می‌توانید 300 درخواست در دقیقه در هر کلید ارسال کنید، با محدودیت همزمانی 8 درخواست در لحظه. اندازه بدنه درخواست نباید از 8 مگابایت تجاوز کند.

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