راهنمای شروع سریع API بدون سانسور

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

ابتدا SDK خود را به URL پایه ما اشاره دهید و کلید خود را در هدر احراز هویت ارسال کنید. ما یک سرویس مستقیم تک‌مدلی بدون هزینه‌های مسیریابی پروکسی ارائه می‌دهیم. از استاندارد Authorization: Bearer scheme برای احراز هویت درخواست‌ها. کلید شما بلافاصله پس از ثبت‌نام از طریق گوگل یا ایمیل ایجاد می‌شود. مطمئن شوید که کلید جایگزین را در پیکربندی مشتری خود با کلیدی که در داشبورد نمایش داده می‌شود جایگزین کنید. URL پایه https://api.uncensoredmodelsollama.com/v1. این انتهای‌بند از کلاینت‌های سازگار با OpenAI پشتیبانی می‌کند و به شما امکان می‌دهد بدون بازنویسی منطق برنامه، ارائه‌دهنده را تغییر دهید. کلید خود را امن نگه دارید، زیرا دسترسی به موجودی اعتبار ازپیش‌پرداخت‌شده شما را فراهم می‌کند.

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

درخواست‌های متنی را به /v1/chat/completions اندپوینت برای تولید پاسخ‌ها. این اندپوینت تاریخچه مکالمات استاندارد و دستورات سیستم را مدیریت می‌کند. شما باید شناسه مدل را به عنوان uncensored در بدنه درخواست. API پاسخ‌های فرمت‌شده JSON را برمی‌گرداند که شامل متن تولید شده و آمار استفاده از توکن است. خطاهایی مانند اعتبار ناکافی یا کلیدهای نامعتبر با کدهای وضعیت HTTP مناسب بازگردانده می‌شوند. از این نقطه پایانی برای تمام وظایف استاندارد تولید متن استفاده کنید. این نقطه پایانی از جاسازی‌ها، تصاویر یا تنظیم دقیق پشتیبانی نمی‌کند. بدنه درخواست خود را زیر 8 MB نگه دارید تا پردازش قابل اعتماد باشد. مدل توکن‌های ورودی و خروجی را در یک پنجره زمینه مشترک پردازش می‌کند.

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

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

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

از tools پارامتری برای فعال‌سازی قابلیت‌های فراخوانی تابع. توابع خود را در بدنه درخواست تعریف کنید تا به مدل اجازه دهید داده‌های ساختاریافته بازگرداند. تنظیم response_format به {"type": "json_object"} برای خروجی JSON دقیق. این ویژگی برای استخراج داده‌ها یا تولید payloadهای ساختاریافته مفید است. مدل از پارامترهای انتخاب ابزار برای کنترل رفتار فراخوانی تابع پشتیبانی می‌کند. از این ویژگی‌ها برای ادغام API در جریان‌های کاری خودکار استفاده کنید. مطمئن شوید تعاریف تابع شما با طرحواره ورودی مورد انتظار مطابقت دارد تا نتایج قابل اعتمادی داشته باشید. API فراخوانی‌های ابزار را در فرمت استاندارد OpenAI برمی‌گرداند تا تجزیه آن آسان باشد.

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

رفتار تولید را با پارامترهایی مانند تنظیم کنید temperature, top_p، و seed. تنظیم max_tokens برای محدود کردن طول خروجی، که در صورت عدم مشخص‌سازی به 2,048 پیش‌فرض می‌شود. API محدودیت نرخ 300 درخواست در دقیقه به ازای هر کلید را اعمال می‌کند. درخواست‌های همزمان به 8 درخواست به ازای هر کلید محدود می‌شوند. اگر از این محدودیت‌ها تجاوز کنید، API کد وضعیت 429 را برمی‌گرداند. درخواست‌ها بر اساس استفاده واقعی از توکن‌ها شارژ می‌شوند، و خطاها و رد پاسخ‌ها رایگان هستند. اعتبار منقضی نمی‌شود و مبالغ پیش‌پرداخت شفاف هستند. کلیدهای خود را با دقت مدیریت کنید، زیرا هر حساب فقط از یک کلید فعال پشتیبانی می‌کند.

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

پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای ورودی و خروجی ترکیبی پشتیبانی می‌کند. درخواست‌هایی که از محدودیت بدنه ۸ مگابایت تجاوز کنند، با خطا مواجه می‌شوند. خطاهای رایج شامل ۴۰۱ برای کلیدهای نامعتبر و ۴۰۲ برای اعتبار ناکافی است. این خطاها را به صورت ایمن در منطق برنامه خود مدیریت کنید. API درخواست‌های حاوی محتوای جنسی مرتبط با کودکان را، صرف‌نظر از سایر تنظیمات، رد می‌کند. سایر محتواها برای استفاده قانونی بزرگسالان بدون سانسور است. مصرف توکن خود را پایش کنید تا از هزینه‌های غیرمنتظره جلوگیری کنید. سیستم اعتبار پیش‌پرداخت تضمین می‌کند که تنها بابت آنچه استفاده می‌کنید پرداخت کنید. هیچ هزینه اشتراک یا هزینه پنهانی برای یکپارچه‌سازی شما اعمال نمی‌شود.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

پایتون

Copyfrom openai import OpenAI

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