OpenRouter Heretic: راهنمای کامل یکپارچه‌سازی

چرا OpenRouter Heretic را انتخاب کنیم؟

یک مدل قدرتمند و بدون سانسور یکپارچه ارائه می‌دهد که پیچیدگی‌های مسیریابی چندمدلی را ندارد. توسعه‌دهندگان اغلب با اکوسیستم‌های API پراکنده‌ای دست‌وپنجه نرم می‌کنند که برای مدل‌های مختلف نرخ‌های متفاوتی دریافت می‌کنند. این پیکربندی یک نقطه پایانی یکپارچه برای تولید متن خام فراهم می‌کند. شما در تمام درخواست‌ها رفتار یکسانی دریافت می‌کنید. این مدل برای محتوای بزرگسالان قانونی و موضوعات جنجالی بدون رد شدن‌های غیرضروری بهینه‌سازی شده است. این مدل GPT، Claude یا Gemini نیست. یک مدل با وزن باز است که روی سرورهای اختصاصی اجرا می‌شود. این یعنی تأخیر قابل پیش‌بینی و قیمت‌گذاری شفاف. شما فقط بابت توکن‌های مصرفی پرداخت می‌کنید. خطاها اعتبار شما را مصرف نمی‌کنند. مدل پیش‌پرداخت تضمین می‌کند که در میانه پروژه دسترسی خود را از دست نمی‌دهید. هزینه ماهانه‌ای شما را درگیر نمی‌کند. اعتبار شما برای همیشه باقی می‌ماند. این سادگی زمان مهندسی را صرفه‌جویی می‌کند. شما بر روی ساخت ویژگی‌ها تمرکز می‌کنید. نه بر روی مدیریت ویژگی‌های خاص ارائه‌دهندگان. پنجره زمینه ۱۰۰ هزار توکنی اسناد بزرگ را به‌طور کارآمد مدیریت می‌کند. سیستم‌های RAG از این ظرفیت بسیار بهره‌مند می‌شوند. نمایه‌سازی پرونده اپستین یا تحلیل اسناد حقوقی به خوبی کار می‌کند. مدل ظرافت‌ها را درک می‌کند. پاسخ‌ها را به دلایل سلیقه‌ای پاک‌سازی نمی‌کند. داده‌های مورد نیاز شما را مستقیماً به شما می‌دهد. بدون واسطه و بدون اضافه‌بار. فقط متن ورودی، متن خروجی. قابل اعتماد. سریع. بدون سانسور.

پیش‌نیازها: راه‌اندازی حساب

برای شارژ حساب به یک آدرس ایمیل و یک کیف پول دیجیتال نیاز دارید. ثبت‌نام از طریق گوگل یا ایمیل آنی انجام می‌شود. احراز هویت با شماره تلفن مانع پیشرفت شما نمی‌شود. کلید API بلافاصله دریافت می‌کنید. کلید برای ۳۰۰ درخواست در دقیقه فعال است. می‌توانید ۸ درخواست همزمان اجرا کنید. محدودیت حجم بدنه درخواست ۸ مگابایت است. این حجم برای بیشتر کارهای استاندارد LLM کافی است. ۰.۵۰ دلار اعتبار آزمایشی برای ۷ روز دریافت می‌کنید. این به شما اجازه می‌دهد نقطه پایانی را تست کنید. از آن برای بررسی استریمینگ استفاده کنید. فراخوانی ابزارها را بررسی کنید. حالت JSON را اعتبارسنجی کنید. پس از اطمینان، حساب خود را با ارز دیجیتال شارژ کنید. USDT روی شبکه TRC20 یا USDC روی شبکه Base پذیرفته می‌شود. حداقل شارژ ۲۰ دلار و حداکثر ۵۰۰ دلار است. در سطوح بالاتر اعتبار پاداش دریافت می‌کنید. با ۵۰ دلار ۵٪ پاداش، با ۱۰۰ دلار ۱۰٪، و با ۲۰۰ دلار ۱۵٪ اعتبار پاداش دریافت می‌کنید. اعتبارها منقضی نمی‌شوند. می‌توانید مصرف را برای ماه‌ها متوقف کنید و سپس از سر بگیرید. موجودی شما دست‌نخورده باقی می‌ماند. هزینه پنهانی وجود ندارد. برای استفاده‌های استاندارد بازگشت وجه صادر نمی‌شود. خطاها از طریق پشتیبانی مدیریت می‌شوند. حریم خصوصی ساده است. پرامپت‌ها برای آموزش استفاده نمی‌شوند. داده‌های شما متعلق به خودتان است. این پیکربندی مناسب توسعه‌دهندگانی است که کنترل کامل می‌خواهند. بدون قفل‌شدگی با ارائه‌دهنده. فقط یک API تمیز.

مرحله 1: تولید کلید API

به داشبورد بروید و 'Get API Key' را کلیک کنید. رابط کاربری مینیمال است. ایمیل خود را وارد کنید یا از ورود گوگل استفاده کنید. سیستم یک کلید منحصر‌به‌فرد تولید می‌کند. شبیه به یک رشته طولانی از کاراکترها به نظر می‌رسد. آن را بلافاصله کپی کنید. آن را در متغیرهای محیطی خود ذخیره کنید. آن را در مخازن عمومی کامیت نکنید. کلید به حساب شما متصل است. شما می‌توانید فقط یک کلید فعال داشته باشید. اگر کلید جدیدی تولید کنید، کلید قدیمی از کار می‌افتد. این امنیت را ساده می‌کند. شما چندین کلید مدیریت نمی‌کنید. آن‌ها را هنگام نیاز بچرخانید. کلید دسترسی به نقطه پایانی chat-completions را فراهم می‌کند. همچنین اجازه می‌دهد متادیتای مدل را بخوانید. نمی‌توانید از آن برای جاسازی یا تولید تصویر استفاده کنید. دامنه واضح است. متن ورودی، متن خروجی. کلید درخواست‌های شما را احراز هویت می‌کند. سرور موجودی شما را بررسی می‌کند. توکن‌های مصرف شده را کسر می‌کند. خطاها رایگان هستند. اگر سرور خطای 500 برگرداند، اعتبار شما از دست نمی‌رود. این از بودجه شما محافظت می‌کند. می‌توانید کلیدها برای محیط‌های مختلف تولید کنید. Dev و Prod از کلیدهای جداگانه استفاده می‌کنند. این از هزینه‌های تصادفی جلوگیری می‌کند. رابط کاربری موجودی فعلی شما را نشان می‌دهد. به صورت بلادرنگ به‌روز می‌شود. می‌توانید مصرف توکن را ببینید. به پیش‌بینی هزینه‌ها کمک می‌کند. سیستم شفاف است. تعجبی نیست. فقط صورتحساب دقیق. اعتماد از طریق وضوح ساخته می‌شود.

مرحله 2: پیکربندی کلاینت خود

SDK خود را به URL پایه پوینت کنید: HTTPS://api.llmheretic.com/v1. این URL با کتابخانه‌های رسمی OpenAI سازگار است. URL پایه را در پیکربندی خود تغییر دهید. سپس هدر API key را تنظیم کنید. شناسه مدل 'uncensored' است. این تنها مدل موجود است. شما بین GPT-4 یا Llama انتخاب نمی‌کنید. از این مدل استفاده می‌کنید. این مدل برای خروجی‌های بدون سانسور بهینه‌سازی شده است. دمای خود را پیکربندی کنید. top_p را تنظیم کنید. توالی‌های توقف را تعریف کنید. این پارامترها خلاقیت را کنترل می‌کنند. دمای پایین خروجی‌ها را قطعی می‌کند. دمای بالا تصادفی بودن را افزایش می‌دهد. بر اساس مورد استفاده خود تنظیم کنید. برای تولید کد، از مقادیر پایین استفاده کنید. برای نوشتن خلاقانه، آن‌ها را افزایش دهید. گزینه استریم در دسترس است. stream را روی true تنظیم کنید تا تحویل توکن به صورت بلادرنگ انجام شود. این تجربه کاربری را بهبود می‌بخشد. کاربران متن را همان‌طور که تولید می‌شود می‌بینند. این امر تأخیر ادراک‌شده را کاهش می‌دهد. حالت JSON برای داده‌های ساختاریافته مفید است. response_format را روی json_object تنظیم کنید. مدل JSON معتبر برمی‌گرداند. این موضوع با برنامه‌های فرانت‌اند به خوبی یکپارچه می‌شود. ابزارها و فراخوانی توابع پشتیبانی می‌شوند. طرحواره تابع خود را تعریف کنید. مدل توابع را به درستی فراخوانی می‌کند. این امر جریان‌های کاری عامل‌محور را امکان‌پذیر می‌سازد. می‌توانید سیستم‌های پیچیده بسازید. پیکربندی استاندارد است. ویژگی‌های اختصاصی خاصی ندارد. کد موجود را بازنویسی می‌کنید. مهاجرت بی‌درنگ است. SDK سریال‌سازی را مدیریت می‌کند. شما بر منطق تمرکز می‌کنید. نه جزئیات پروتکل.

مرحله ۳: اولین درخواست خود را ارسال کنید

یک درخواست POST به /v1/chat/completions بسازید. کلید API خود را در هدر قرار دهید. مدل را روی 'uncensored' تنظیم کنید. یک آرایه messages را ارسال کنید. هر پیام دارای نقش و محتواست. از 'user' برای ورودی استفاده کنید. 'assistant' برای نوبت‌های قبلی. 'system' برای دستورالعمل‌ها. پرامپت سیستم رفتار را هدایت می‌کند. آن را برای تعریف لحن تنظیم کنید. یا فرمت خروجی را محدود کنید. بدنه درخواست شامل پرامپت است. توکن‌ها به صورت خودکار شمارش می‌شوند. ورودی‌ها $0.15 به ازای هر میلیون توکن هزینه دارند. خروجی‌ها $0.50 به ازای هر میلیون توکن هزینه دارند. این نرخ‌ها شفاف هستند. تعداد توکن را در پاسخ مشاهده می‌کنید. آخرین قطعه شامل داده‌های استفاده است. این به شما کمک می‌کند هزینه‌ها را ردیابی کنید. خطاها رایگان هستند. اگر مدل شکست بخورد، چیزی پرداخت نمی‌کنید. این ریسک را کاهش می‌دهد. می‌توانید آزادانه آزمایش کنید. پنجره زمینه 100k اجازه ورودی‌های بزرگ را می‌دهد. اسناد کامل را بچسبانید. تاریخچه مکالمه را شامل کنید. مدل زمینه را حفظ می‌کند. آن به دقت پاسخ می‌دهد. استریم اختیاری است. اگر آن را غیرفعال کنید، منتظر پاسخ کامل می‌مانید. این برای وظایف دسته‌ای ساده‌تر است. بر اساس نیازهای خود انتخاب کنید. محدودیت اندازه درخواست 8 مگابایت است. این بیشتر موارد استفاده را پوشش می‌دهد. بارهای کاری بزرگ‌تر ممکن است نیاز به تکه‌تکه کردن داشته باشند. API اعتبارسنجی را مدیریت می‌کند. پیام‌های خطای واضح برمی‌گرداند. می‌توانید سریع اشکال‌زدایی کنید. فرآیند ساده است. مراحل راه‌اندازی پیچیده‌ای وجود ندارد. فقط درخواست را ارسال کنید. نتیجه را دریافت کنید. برنامه خود را بسازید.

مرحله ۴: مدیریت پاسخ‌های استریمینگ

با تنظیم stream به true، پخش زنده را فعال کنید. سرور مجموعه‌ای از قطعات ارسال می‌کند. هر قطعه حاوی یک توکن ناقص است. این توکن‌ها را انباشته کنید. آن‌ها را به‌صورت بلادرنگ به کاربر نمایش دهید. این کار اثر تایپ ایجاد می‌کند. کاربران عملکرد سریع‌تری را درک می‌کنند. قطعه آخر شامل داده‌های usage است. شامل شمارش توکن‌ها می‌باشد. می‌توانید این‌ها را برای صورت‌حساب‌دهی ثبت کنید. جریان با یک نشانگر پایان (done) پایان می‌یابد. خطاها را به‌خوبی مدیریت کنید. وقفه‌های شبکه ممکن است جریان را قطع کنند. منطق تلاش مجدد توصیه می‌شود. فرمت SSE استاندارد است. فیلد data را تجزیه کنید. متن را استخراج کنید. قطعات متا را نادیده بگیرید. بر محتوا تمرکز کنید. این روش با هر کلاینت HTTP کار می‌کند. Node.js، Python، Go و Rust همه از آن پشتیبانی می‌کنند. SDK تجزیه را به‌طور خودکار انجام می‌دهد. شما یک شیء stream دریافت می‌کنید. روی آن پیمایش می‌کنید. توکن‌ها را به رابط کاربری خود می‌فرستید. این روش برای رابط‌های چت ایده‌آل است. کاربران پاسخ‌ها را همان‌طور که تولید می‌شوند می‌بینند. زمان انتظار را کاهش می‌دهد. محدودیت حداکثر 16k خروجی اعمال می‌شود. اگر به خروجی طولانی‌تر نیاز دارید، درخواست‌های متعدد ارسال کنید. نتایج را به هم بچسبانید. مدل انسجام خود را حفظ می‌کند. زمینه را درک می‌کند. پخش زنده بر کیفیت تأثیری ندارد. تنها سرعت تحویل را تغییر می‌دهد. آن را برای برنامه‌های تعاملی استفاده کنید. آن را برای پردازش دسته‌ای غیرفعال کنید. چرخ‌های CPU را صرفه‌جویی می‌کنید. انتخاب با خود شماست. انعطاف‌پذیری کلید موفقیت است. چیزی را بسازید که برای کاربران شما بهترین کارایی را دارد.

مرحله ۵: پایش مصرف و هزینه‌ها

موجودی خود را در داشبورد بررسی کنید. به صورت بلادرنگ به‌روز می‌شود. مصرف توکن در هر درخواست را می‌بینید. آخرین قطعه استریم، مصرف را نشان می‌دهد. این داده‌ها را در سیستم خود ثبت کنید. توکن‌های ورودی را با خروجی مقایسه کنید. خروجی گران‌تر است. پرامپت‌های خود را بهینه کنید تا طول ورودی کاهش یابد. از پرامپت‌های سیستمی به طور کارآمد استفاده کنید. از تکرار زمینه خودداری کنید. مدل پیش‌پرداخت یعنی شما کنترل هزینه‌ها را در دست دارید. وقتی موجودی کم است شارژ کنید. شارژهای کریپتویی فوری هستند. USDT و USDC پشتیبانی می‌شوند. اعتبارات بونوس ارزش افزوده ایجاد می‌کنند. $100 معادل 10٪ اعتبار اضافی است. این هزینه مؤثر شما را کاهش می‌دهد. اعتبارات منقضی نمی‌شوند. می‌توانید برای اوج مصرف ذخیره کنید. بدون هزینه ماهانه. بدون تله‌های تمدید خودکار. اگر دو بار شارژ شدید، با پشتیبانی تماس بگیرید. آن‌ها به صورت دستی مشکل را حل می‌کنند. بازپرداخت‌ها استاندارد نیستند. اعتبارات قطعی هستند. این را تشویق می‌کند که با دقت هزینه کنید. مصرف کلید API خود را نظارت کنید. 300 درخواست در دقیقه محدودیت است. 8 درخواست همزمان حداکثر مجاز است. عبور از محدودیت‌ها خطای 429 برمی‌گرداند. کلاینت خود را محدود نرخ کنید. بازگشت نمایی پیاده‌سازی کنید. این از محدود شدن جلوگیری می‌کند. داشبورد داده‌های تاریخی را نشان می‌دهد. روندها را تحلیل کنید. قله‌ها را شناسایی کنید. معماری خود را تنظیم کنید. بهینه‌سازی هزینه مداوم است. تغییرات کوچک جمع می‌شوند. کارایی مهم است. هر توکن اهمیت دارد. بودجه شما برای مدیریت شماست.

مرحله ۶: تنظیمات پیشرفته (ابزارها، JSON)

از فراخوانی تابع برای جریان‌های کاری عاملی استفاده کنید. ابزارها را در درخواست تعریف کنید. نام، توضیحات و پارامترها را مشخص کنید. مدل تصمیم می‌گیرد کدام ابزار را فراخوانی کند. آرگومان‌ها را برمی‌گرداند. شما تابع را اجرا می‌کنید. نتایج را به مدل بازگردانید. او پاسخ نهایی را تولید می‌کند. این منطق پیچیده را امکان‌پذیر می‌کند. جستجوی وب. پرس‌وجوهای پایگاه داده. اجرای کد. حالت JSON خروجی ساختاریافته را تضمین می‌کند. response_format را روی json_object تنظیم کنید. مدل JSON معتبر برمی‌گرداند. آن را در کد خود تجزیه کنید. این برای APIها حیاتی است. از خطاهای تجزیه جلوگیری کنید. طرحواره انعطاف‌پذیر است. شما ساختار را تعریف می‌کنید. مدل از آن پیروی می‌کند. دما بر انتخاب ابزار تأثیر می‌گذارد. مقادیر پایین‌تر تصمیم‌گیری را قطعی می‌کنند. مقادیر بالاتر تنوع ایجاد می‌کنند. برای قابلیت اطمینان از دمای پایین استفاده کنید. top_p نمونه‌گیری هسته را فیلتر می‌کند. برای تنوع تنظیم کنید. دنباله‌های توقف تولید را متوقف می‌کنند. برای متن ساختاریافته مفید هستند. seed قابلیت تکرارپذیری را تضمین می‌کند. برای اشکال‌زدایی یک seed تنظیم کنید. نتایج یکسان هستند. این ویژگی‌ها API را گسترش می‌دهند. شما عامل‌های قدرتمند می‌سازید. مدل دستورالعمل‌ها را درک می‌کند. آن‌ها وظایف را با دقت اجرا می‌کنند. نام ابزارها را توهم‌زده نمی‌کند. به طرحواره شما پایبند است. این قابلیت اطمینان کلیدی است. برای سیستم‌های تولید. به پیش‌بینی‌پذیری نیاز دارید. این تنظیمات آن را فراهم می‌کنند. آن‌ها را برای حداکثر کارایی ترکیب کنید. برنامه‌های هوشمند بسازید. مشکلات واقعی را حل کنید. مدل uncensored دستورات پیچیده را مدیریت می‌کند. ابزارهای معتبر را رد نمی‌کند. آن‌ها را به‌طور کامل اجرا می‌کند. پروژه بعدی خود را توانمند کنید.

عیب‌یابی خطاهای رایج

خطاهای 429 به معنای تجاوز از محدودیت نرخ هستند. شما درخواست‌های زیادی ارسال کرده‌اید. صبر کنید و با بازگشت مجدد تلاش کنید. خطاهای 401 نشان‌دهنده کلید API نامعتبر هستند. کلید خود را بررسی کنید. اطمینان حاصل کنید که فعال است. اگر گم شده، مجدداً ایجاد کنید. خطاهای 400 درخواست‌های بد هستند. سینتکس JSON را بررسی کنید. شناسه مدل را 'uncensored' بررسی کنید. اطمینان حاصل کنید که آرایه messages صحیح است. نقش باید 'user'، 'assistant' یا 'system' باشد. محتوا باید موجود باشد. خطاهای 500 مشکلات سرور هستند. یک بار تلاش مجدد کنید. اگر ادامه داشت، با پشتیبانی تماس بگیرید. خطاها رایگان هستند. شما اعتبار از دست نمی‌دهید. این برای تست ایمن است. موجودی خود را بررسی کنید. اگر صفر است، شارژ کنید. پرداخت‌های ارز دیجیتال فوری هستند. USDT روی TRC20. USDC روی Base. شبکه را بررسی کنید. اتصالات کند ممکن است منقضی شوند. مقادیر زمان انتظار را افزایش دهید. خروجی‌های بزرگ ممکن است به محدودیت 16k برسند. درخواست خود را تقسیم کنید. یا خروجی جزئی را بپذیرید. استریمینگ این موضوع را به خوبی مدیریت می‌کند. آنچه دریافت می‌کنید را نمایش دهید. مدل ادامه می‌دهد. پنجره زمینه 100k توکن است. اگر آن را تجاوز کنید، مدل خلاصه می‌کند. پیام‌های قدیمی را حذف کنید. زمینه اخیر را حفظ کنید. این مرتبطی را بهبود می‌بخشد. به طور سیستماتیک عیب‌یابی کنید. ورودی‌ها و خروجی‌ها را لاگ کنید. با نتایج مورد انتظار مقایسه کنید. مشکل را ایزوله کنید. API مقاوم است. خطاها نادر هستند. وقتی رخ می‌دهند، واضح هستند. آن‌ها را سریعاً رفع کنید. به ساختن ادامه دهید.