مستندات API & شروع سریع

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

هر درخواست را با اشاره کلاینت خود به HTTPS://api.uncensoredia.com/v1 و کلید خود را ضمیمه کنید. Authorization از استاندارد Bearer scheme، بنابراین شما به سادگی توکنی را که پس از ثبت‌نام با گوگل یا ایمیل دریافت کرده‌اید جایگذاری می‌کنید. نقطه پایانی به طور کامل openai compatible API مطابق، به این معنی که شما فقط نیاز دارید base_url و کلید API را در پیکربندی موجود خود تغییر دهید. نیازی به مدیریت لایه‌های پیچیده مسیریابی یا هدرهای پروکسی ندارید. فقط مطمئن شوید که Authorization هدر شامل توکن منحصر به فرد شماست. این پیکربندی تضمین می‌کند که درخواست‌های شما به مدل uncensored اختصاصی بدون هیچ فیلتر میانی می‌رسند. اگر یک 401 خطا، بررسی کنید که کلید شما فعال و به درستی فرمت شده است.

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

پیام‌ها را به POST /v1/chat/completions برای دریافت پاسخ‌های متنی از مدل بدون سانسور. این نقطه پایان واحد تمام نیازهای تولید شما را مدیریت می‌کند، از پرس‌و‌جوهای ساده تا مکالمات چندمرحله‌ای پیچیده. می‌توانید طول خروجی و تصادفی‌سازی را با استفاده از پارامترهایی مانند max_tokens, temperature، و top_p. مدل از یک توکن ۱۰۰,۰۰۰ تایی پنجره زمینه، به شما امکان می‌دهد مستندات گسترده یا تاریخچه‌های مکالمه طولانی را وارد کنید. می‌توانید تا 16,000 توکن در پاسخ ارسال کنید. اگر حذف کنید max_tokens, محدودیت پیش‌فرض ۲,۰۴۸ توکن است. این نقطه پایانی از تولید تصویر یا صدا پشتیبانی نمی‌کند. این صرفاً متن به متن است. برای آزمایش فوری اتصال خود، از دستور curl زیر استفاده کنید.

یکپارچه‌سازی SDK Python

از کتابخانه رسمی پایتون OpenAI برای ارتباط با API با حداقل تغییرات کد استفاده کنید. تنها نیاز دارید که base_url و api_key در پیکربندی کلاینت قرار دهید. این روش تضمین می‌کند که منطق موجود شما برای مدیریت پاسخ‌ها، خطاها و تلاش مجدد‌ها دست‌نخورده باقی می‌ماند. کتابخانه به طور خودکار سریال‌سازی JSON و پخش زنده را مدیریت می‌کند اگر آن را فعال کنید. این روش برای خدمات سمت سرور یا اسکریپت‌هایی که نیاز به پردازش حجم بالایی از متن دارند ایده‌آل است. مدل بدون سانسور به درخواست‌های تکمیل چت استاندارد پاسخ می‌دهد و نیازی به منطق تجزیه سفارشی ندارد. کلاینت خود را یک بار پیکربندی کنید و در سراسر برنامه خود از آن استفاده کنید. در اینجا نحوه مقداردهی اولیه کلاینت و ارسال یک درخواست ساده آمده است.

راه‌اندازی SDK Node.js

API را به برنامه‌های JavaScript یا TypeScript خود با استفاده از @anthropic-ai/sdk یا SDK رسمی openai بسته را تنظیم کنید baseURL به نقطه پایان و کلید API خود را ارائه دهید. این به شما اجازه می‌دهد از روش‌های آشنا مانند chat.completions.create() مستقیماً. SDK درخواست‌های HTTP را مدیریت می‌کند و پاسخ‌های JSON را برای شما پارس می‌کند. می‌توانید خطاها را به راحتی مدیریت کنید مانند 402 (اعتبار ناکافی) یا 429 (محدودیت نرخ) در منطق برنامه خود. این تنظیم برای سرورهای وب، ربات‌ها یا هر محیط Node.js عالی است. مدل بدون سانسور به طور یکپارچه با فرمت درخواست استاندارد کار می‌کند. کلاینت خود را برای اطمینان از سازگاری با انتظارات API پیکربندی کنید.

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

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

محدودیت‌های نرخ و محدودیت‌های context

API محدودیت‌های سخت‌گیرانه‌ای را برای تضمین عملکرد پایدار برای همه کاربران اعمال می‌کند. می‌توانید تا ۳۰۰ درخواست در دقیقه per key and have ۸ درخواست همزمان در هر زمان فعال. حداکثر اندازه بدنه درخواست 8 مگابایت است. اگر از این محدودیت‌ها فراتر بروید، دریافت خواهید کرد 429 کد وضعیت. اطمینان حاصل کنید که تلاش مجدد را با افزایش نمایی انجام می‌دهید تا از برخورد مکرر با این محدودیت‌ها جلوگیری کنید. پنجره زمینه ۱۰۰,۰۰۰ توکن است، اما حداکثر خروجی ۱۶,۰۰۰ توکن است. اگر به خروجی بیشتری نیاز دارید، max_tokens پارامتر. خطاهایی مانند 401 (کلید نامعتبر) و 402 (بدون اعتبار) فوری هستند و سهمیه توکن شما را مصرف نمی‌کنند. سهمیه خود را به دقت مدیریت کنید تا از وقفه‌های خدمات در حین وظایف تولید با حجم بالا جلوگیری کنید.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)