راهنمای شروع سریع Uncensored-llm.vercel.app

پیش‌نیازها: کلید API و URL پایه

ابتدا یک کلید API واحد از داشبورد دریافت کنید. ما از ورود با Google یا ثبت‌نام با ایمیل بدون تأیید شماره تلفن پشتیبانی می‌کنیم. کلید شما تمام درخواست‌ها را به URL پایه: HTTPS://api.uncensoredllmvercelapp.com/v1 احراز هویت می‌کند. این اندپوینت با هر کتابخانه کلاینت سازگار با OpenAI کار می‌کند. نیازی به مدیریت چندین اندپوینت برای انواع مختلف مدل ندارید.

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

یک درخواست POST به /v1/chat/completions با شناسه مدل "uncensored" ارسال کنید. سیستم پارامترهای استاندارد مانند دما و top_p را می‌پذیرد. می‌توانید همزمان تا ۸ درخواست را به ازای هر کلید ارسال کنید. بدنه هر درخواست باید زیر ۸ مگابایت باشد. خطاها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند.

Copycurl https://api.uncensoredllmvercelapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France"}]
  }'

این تماس ساده قابلیت مستقیم متن-ورودی، متن-خروجی را نشان می‌دهد. پاسخ شامل محتوای تولید شده و آمار مصرف توکن است. می‌توانید پنجره زمینه را تا 100,000 توکن برای پرامپت و تکمیل ترکیبی تنظیم کنید.

پاسخ‌های جریان‌دار با SSE

با تنظیم stream به true در درخواست خود، پخش زنده (streaming) را فعال کنید. سرور زمانی که توکن‌ها در دسترس می‌شوند، رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. این امر تأخیر ادراکی برای خروجی‌های طولانی را کاهش می‌دهد. می‌توانید آخرین قطعه را تجزیه کنید تا تعداد کل توکن‌ها را دریافت کنید. پخش زنده دقیقاً مانند فرمت استاندارد OpenAI کار می‌کند.

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)

این رویکرد برای برنامه‌های بلادرنگ ایده‌آل است. مدل uncensored از طریق‌بالا (throughput) بالایی در حین استریم پشتیبانی می‌کند. شما کنترل کامل بر فرآیند تولید دارید و نیازی به انتظار برای دریافت پاسخ کامل نیست.

فراخوانی تابع و حالت JSON

از پارامتر tools برای قابلیت‌های فراخوانی تابع استفاده کنید. API از tool_choice و خروجی JSON ساختاریافته از طریق response_format پشتیبانی می‌کند. response_format را روی json_object تنظیم کنید تا از انطباق دقیق JSON اطمینان حاصل کنید. این باعث می‌شود تجزیه در برنامه‌های شما قابل‌اعتماد باشد. می‌توانید توابع متعددی برای گردش کارهای پیچیده تعریف کنید.

Copyimport OpenAI from "openai";

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

حالت JSON برای وظایف استخراج داده مفید است. فراخوانی تابع به مدل اجازه می‌دهد داده‌های ساختاریافته بازگرداند. هر دو ویژگی در پنجره بدون سانسور کار می‌کنند. کنترل کاملی بر فرمت خروجی مدل دارید.

مدیریت توکن‌ها و محدودیت‌ها

مصرف توکن‌ها را برای مدیریت هزینه‌ها پایش کنید. توکن‌های ورودی ۰.۱۵ دلار به ازای هر میلیون، و توکن‌های خروجی ۰.۵۰ دلار به ازای هر میلیون هزینه دارند. اعتبارها پیش‌پرداخت شده و منقضی نمی‌شوند. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست تولید کنید. پنجره زمینه از ۱۰۰,۰۰۰ توکن در مجموع پشتیبانی می‌کند.

Copyfrom openai import OpenAI

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

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

مدیریت خطا و رد شدن‌ها

کدهای خطای HTTP استاندارد را برای عیب‌یابی مدیریت کنید. 401 نشان‌دهنده کلید API نامعتبر است. پاسخ 402 به معنای تمام شدن اعتبار پیش‌پرداخت شماست. خطای 429 نشان می‌دهد که از محدودیت نرخ فراتر رفته‌اید. این خطاها توکن‌های شما را مصرف نمی‌کنند.

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