مستندات API

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

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

Copycurl https://api.trulyuncensoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 python libraries for data analysis"}]
  }'

اولین درخواست

اولین درخواست تأیید میکند که یکپارچه‌سازی شما با API LLM uncensored کار می‌کند. یک پرسش ساده ارسال کنید تا بررسی کنید که مدل بدون ردی‌های استاندارد پاسخ می‌دهد. می‌توانید از SDKهای رسمی OpenAI یا هر مشتری سازگاری با اشاره به URL پایه ما استفاده کنید. این مرحله تأیید میکند که کلید شما فعال است و اعتبار موجود است.

Copyfrom openai import OpenAI

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

مستقیماً در پروژه‌های JavaScript یا TypeScript خود با استفاده از Node SDK ادغام کنید. URL پایه و کلید API را یک بار پیکربندی کنید، سپس به نقطه پایانی تکمیل چت تماس بگیرید. این رویکرد کد شما را تمیز نگه می‌دارد و احراز هویت را به طور خودکار مدیریت می‌کند. این رویکرد برای رندر سمت سرور یا خدمات بک‌اند ایده‌آل است.

Copyimport OpenAI from "openai";

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

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

پخش زنده را فعال کنید تا توکن‌ها به محض تولید دریافت شوند. این کار تأخیر ادراک‌شده را برای وظایف نقش‌آفرینی طولانی یا نوشتن خلاقانه کاهش می‌دهد. قطعه نهایی شامل کل مصرف توکن برای صورتحساب دقیق است. پخش به‌طور یکپارچه با تجزیه‌کننده‌های استاندارد SSE در اکثر SDKهای مدرن کار می‌کند.

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)

Limits and Errors

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

پنجره زمینه

مدل از پنجره زمینه ۱۰۰,۰۰۰ توکن برای ترکیب ورودی و خروجی پشتیبانی می‌کند. این امکان تاریخچه گسترده در سناریوهای نقش‌آفرینی یا تحلیل اسناد بزرگ را فراهم می‌کند. خروجی به ۱۶,۰۰۰ توکن در هر درخواست محدود می‌شود، یا ۲,۰۴۸ اگر مشخص نکنید max_tokens. استفاده از توکن خود را برای ماندن در این حدود نظارت کنید.