یکپارچه‌سازی گام‌به‌گام API LLM uncensored.com

پیش‌نیازها: SDK و پیکربندی محیط

SDK زبان مورد علاقه خود را نصب کنید تا با endpoint ارتباط برقرار کنید. اکثر توسعه‌دهندگان از SDK رسمی OpenAI برای پایتون، Node.js یا Go استفاده می‌کنند. این به این دلیل کار می‌کند که API از طرح‌بندی استاندارد تکمیل گفتگوی OpenAI پیروی می‌کند.

اطمینان حاصل کنید که محیط شما از Python 3.8+ یا Node.js 18+ پشتیبانی می‌کند. بسته را از طریق pip یا npm نصب کنید. شما به یک کلید API از داشبورد نیاز دارید. برای ثبت‌نام به شماره تلفن نیازی نیست.

• پایتون: pip install openai
• Node.js: npm install openai

کلید API خود را در یک متغیر محیطی ذخیره کنید. این کار از نمایش تصادفی آن در کنترل نسخه جلوگیری می‌کند. کلید به مدل uncensored دسترسی می‌دهد.

پیکربندی URL پایه

مشتری SDK خود را به URL پایه صحیح پیکربندی کنید. این مهم‌ترین مرحله برای یکپارچه‌سازی موفق است. URL پایه پیش‌فرض OpenAI برای این سرویس کار نخواهد کرد.

آدرس پایه را به HTTPS://api.uncensoredaicom.com/v1 تنظیم کنید. این درخواست‌ها را به زیرساخت LLM بدون سانسور هدایت می‌کند. شناسه مدلی که باید ارسال کنید "uncensored" است. این یک مدل با وزن باز است که برای حداقل رد کردن‌ها تنظیم شده است.

اتصال را با فراخوانی نقطه پایانی مدل‌ها بررسی کنید. این تأیید می‌کند که اعتبارنامه‌ها و آدرس پایه URL شما صحیح هستند. یک پاسخ موفق، شناسه مدل و نوع شیء را برمی‌گرداند.

تنظیم هدر احراز هویت

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

هدر را به صورت زیر تنظیم کنید: Authorization: Bearer YOUR_API_KEY. SDK این کار را به‌طور خودکار انجام می‌دهد اگر کلید را به سازنده کلاینت بفرستید. اطمینان حاصل کنید که فضای خالی اضافی وجود ندارد. کلیدهای نامعتبر خطای 401 Unauthorized را برمی‌گردانند.

یک کلید فعال به ازای هر حساب دریافت می‌کنید. تولید کلید جدید کلید قبلی را نامعتبر می‌کند. این چرخش و مدیریت امنیت کلید را ساده می‌کند. کلید خود را در محیط استقرار (deployment) خود امن نگه دارید.

ارسال یک درخواست چت استاندارد (Standard Chat Request)

درخواست POST به /v1/chat/completions ارسال کنید. پیام‌های خود را به صورت آرایه‌ای از اشیاء role و content ارسال کنید. سیستم از نقش‌های user، assistant و system پشتیبانی می‌کند.

ساختار نمونه: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API تکمیل متن را برمی‌گرداند. پنجره زمینه ۱۰۰,۰۰۰ توکن به‌طور کلی است. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است.

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

فعال‌سازی پخش زنده برای خروجی بلادرنگ

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

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

قطعیات شبکه را به‌صورت ایمن مدیریت کنید. اگر پخش قطع شود، دوباره متصل شوید. API uncensored از پخش پایدار پشتیبانی می‌کند. وضعیت اتصال را پایش کنید. این را برای رابط‌های چت یا تولید متن طولانی استفاده کنید.

استفاده از ابزارها و Function Calling

ابزارها را در بدنه درخواست خود تعریف کنید. فهرستی از طرحواره‌های تابع را ارسال کنید. مدل می‌تواند این توابع را بر اساس قصد کاربر فراخوانی کند. این قابلیت رفتار شبیه به عامل (agent) را ممکن می‌سازد.

مشخص کنید tool_choice برای کنترل انتخاب تابع. استفاده auto برای تشخیص خودکار. API تعاریف ابزار استاندارد را پشتیبانی می‌کند. استدلال‌های فراخوانی تابع را از پاسخ تجزیه کنید.

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

مدیریت پاسخ‌های حالت JSON

تنظیم response_format: {"type": "json_object"}. این موضوع مدل را مجبور می‌کند تا JSON معتبر خروجی دهد. این را برای استخراج داده‌های ساختاریافته استفاده کنید. از خطاهای پاسخ نامعتبر جلوگیری می‌کند.

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

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

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

به محدودیت‌های نرخ احترام بگذارید. شما 300 درخواست در دقیقه به ازای هر کلید دارید. حداکثر 8 درخواست همزمان. اندازه بدنه درخواست به 8 مگابایت محدود است.

کدهای وضعیت HTTP را مانیتور کنید. 429 نشان‌دهنده تجاوز از محدودیت نرخ است. 400 نشان‌دهنده درخواست نامعتبر است. 500 نشان‌دهنده خطای سرور است. بازگشت با تأخیر نمایی را برای تلاش مجدد پیاده‌سازی کنید. این از غرق کردن API جلوگیری می‌کند.

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

محاسبه هزینه‌ها و مصرف توکن

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

شارژ فقط با ارز دیجیتال. USDT (TRC20) یا USDC (Base). مبالغ بین ۲۰ تا ۵۰۰ دلار است. اعتبار هدیه برای شارژهای بزرگ‌تر اعمال می‌شود. +۵٪ از ۵۰ دلار، +۱۰٪ از ۱۰۰ دلار، +۱۵٪ از ۲۰۰ دلار.

Calculate costs before heavy usage. Estimate token counts for your prompts. This helps budget effectively. Errors are free. Refunds are not issued, but mistakes are fixed. Use the dashboard to track spending.