مستندات API برای مدل uncensored

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

ابتدا با ارسال درخواست‌ها به https://api.bestllmapiprovider.com/v1 با کلید API خود. URL پایه، نقطه پایانی استاندارد OpenAI را در پیکربندی کلاینت شما جایگزین می‌کند. کلید را در Authorization: Bearer <key> هدر برای هر تماس. این با SDKهای رسمی OpenAI و هر کلاینت سازگار با OpenAI کار می‌کند.

هدرهای الزامی

• Content-Type: application/json
• Authorization: Bearer YOUR_API_KEY

کلید خود را امن نگه دارید. اگر آن را گم کردید، کلید جدیدی از داشبورد تولید کنید. کلید قبلی بلافاصله از کار می‌افتد.

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

شروع سریع: ارسال اولین درخواست بدون سانسور

یک درخواست POST به /v1/chat/completions برای دریافت خروجی متنی. شناسه مدل همیشه uncensored. پرامپت خود را در messages آرایه. API پاسخی مستقیم بدون فیلترهای محتوا برای استفاده بزرگسالان قانونی برمی‌گرداند.

پیک‌لود نمونه

• model: "uncensored"
• messages: [{"role": "user", "content": "Explain quantum entanglement."}]

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.bestllmapiprovider.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 و Seed

خلاقیت را با temperature و top_p. تنظیم temperature to 0.7 for balanced output or 1.5 for more variation. Use top_p برای محدود کردن جرم احتمال توکن‌های نمونه‌برداری شده. تنظیم یک seed عدد صحیح برای نتایج قابل تکرار. این پارامترها به شما کمک می‌کنند مدل را برای وظایف خاص تنظیم کنید.

پارامترهای کلیدی

• temperature: ۰.۰ تا ۲.۰
• top_p: ۰.۱ تا ۱.۰
• seed: هر عدد صحیح

این‌ها را با max_tokens برای کنترل طول. مدل محدودیت‌های پنجره زمینه را به دقت رعایت می‌کند.

Copyimport OpenAI from "openai";

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

پاسخ‌های استریم‌شده و شمارش توکن

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

مدیریت جریان

• قطعات را هنگام رسیدن بخوانید
• تجزیه delta field
• بررسی usage در آخرین قطعه

استریم با تمام پارامترها کار می‌کند. بر قیمت‌گذاری به ازای هر توکن تأثیر نمی‌گذارد. شما بابت توکن‌های واقعی تولید شده پرداخت می‌کنید.

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 برای خروجی JSON. تنظیم response_format به {"type": "json_object"} برای JSON دقیق. مدل داده‌های ساختاریافته‌ای را برمی‌گرداند که برای تجزیه مناسب است. این ویژگی برای ساخت عامل‌ها یا پایپ‌لاین‌های استخراج داده مفید است.

پیکربندی

• tools: آرایه‌ای از تعاریف تابع
• response_format: {"type": "json_object"}

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

مثال حالت JSON

تنظیم response_format برای اجبار به خروجی JSON سخت‌گیرانه. این نیاز به پردازش پس‌از تولید را کاهش می‌دهد.

محدودیت‌ها، خطاها و پنجره زمینه

پنجره زمینه ۱۰۰,۰۰۰ توکن به‌طور کلی است. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. می‌توانید ۳۰۰ درخواست در دقیقه برای هر کلید ارسال کنید. هشت درخواست همزمان به‌طور همزمان مجاز است. خطاها کدهای HTTP استاندارد را برمی‌گردانند.

خطاهای رایج

• 401: کلید نامعتبر یا گمشده
• 402: اعتبار ناکافی
• 429: تجاوز از محدودیت نرخ

ردّهاها به دلیل محدودیت‌های محتوا اعتبار هزینه ندارند. خطاها نیز اعتبار هزینه ندارند. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود.

محدودیت‌های درخواست

حداکثر اندازه بدنه درخواست ۸ مگابایت است. تجاوز از این مقدار خطای 413 برمی‌گرداند. مصرف توکن‌های خود را با دقت مدیریت کنید.