API OpenRouter چیست؟
API OpenRouter به عنوان یک دروازه یکپارچه به چندین مدل زبانی بزرگ عمل می‌کند. به جای مدیریت کلیدهای API جداگانه برای ارائه‌دهندگان مختلف، درخواست‌ها را به یک endpoint واحد ارسال می‌کنید. سرویس، پرامپت شما را به مدل انتخاب‌شده هدایت کرده و تکمیل (completion) را برمی‌گرداند. این انتزاع، ادغام را برای توسعه‌دهندگانی که می‌خواهند با معماری‌های مختلف آزمایش کنند، ساده می‌سازد.
با این حال، این راحتی با محدودیت‌هایی در پلن‌های رایگان همراه است. کاربران اغلب با سقف‌های روزانه مواجه می‌شوند که پس از ۲۴ ساعت بازنشانی می‌شوند. اگر برنامه شما درخواست‌های بیشتری نسبت به مجاز ارسال کند، خطای ۴۲۹ دریافت می‌کنید. این رفتار برای مدیریت بار سرور برای کاربران رایگان طراحی شده است.
سرویس ما رویکرد متفاوتی ارائه می‌دهد. ما یک نقطه پایانی مستقیم و سازگار با OpenAI برای یک مدل بدون سانسور ارائه می‌دهیم. نیازی به نگرانی درباره سهمیه‌های روزانه ندارید. کد شما بدون برخورد با محدودیت‌های ناگهانی به کار خود ادامه می‌دهد. ما بر یکپارچه‌سازی توسعه‌دهنده با صورت‌حساب‌دهی ارز دیجیتال پیش‌پرداخت تمرکز داریم. این امر تضمین می‌کند که زیرساخت شما در حین وظایف با حجم بالا پایدار بماند.
درک محدودیت‌های OpenRouter
محدودیت‌های روزانه درخواست، محدودیت اصلی برای کاربران رایگان OpenRouter است. این محدودیت‌ها بسته به مدل متفاوت است، با برخی مدل‌ها محدود به تنها ۵۰ درخواست در روز. این محدودیت کاربران را مجبور به ایجاد حساب‌های متعدد برای مقیاس‌دهی استفاده می‌کند. همچنین اسکریپت‌های طولانی‌مدت که از سهم روزانه فراتر می‌روند را مختل می‌کند.
API ما این سقف‌های روزانه را کاملاً حذف می‌کند. در عوض، ما محدودیت نرخ را بر اساس دقیقه اعمال می‌کنیم. شما ۳۰۰ درخواست در دقیقه به ازای هر کلید دریافت می‌کنید. این امر اجازه می‌دهد تا ترافیک‌های ناگهانی بدون انتظار برای روز بعد پردازش شوند. همزمانی به ۸ درخواست همزمان به ازای هر کلید محدود شده است. حجم بدنه درخواست‌ها به ۸ مگابایت محدود است. این محدودیت‌ها برای جلوگیری از سوءاستفاده و در عین حال امکان توسعه جدی طراحی شده‌اند.
پنجره زمینه تا ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. این شامل هم ورودی و هم خروجی است. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. اگر max_tokens را تنظیم نکنید، محدودیت پیش‌فرض ۲,۰۴۸ توکن است. این ظرفیت برای بیشتر وظایف تولید متن طولانی کافی است.
مقایسه هزینه: OpenRouter با ما
OpenRouter برای هر مدل بر اساس توکن هزینه دریافت می‌کند. قیمت‌ها بسته به ارائه‌دهنده به شدت متفاوت است. طرح‌های رایگان اجازه استفاده محدود را می‌دهند اما به خوبی مقیاس‌پذیر نیستند. طرح‌های پولی نیاز به اشتراک یا اعتبار ماهانه دارند. اگر از محدودیت روزانه خود فراتر بروید، باید منتظر بمانید یا برای طرح بالاتر هزینه پرداخت کنید.
قیمت‌گذاری ما ساده و شفاف است. ما برای هر ۱ میلیون توکن ورودی ۰.۱۵ دلار و برای هر ۱ میلیون توکن خروجی ۰.۵۰ دلار دریافت می‌کنیم. شما بابت مصرف واقعی توکن پرداخت می‌کنید. خطاها و رد شدن درخواست‌ها رایگان هستند. هزینه ماهانه‌ای وجود ندارد. نیاز به اشتراک نیست. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود.
این مدل برای توسعه‌دهندگانی که هزینه‌های قابل پیش‌بینی می‌خواهند ایده‌آل است. حساب خود را با ارز دیجیتال شارژ می‌کنید. قیمت هر توکن ثابت است. نیازی نیست نگران تغییر نرخ‌های خاص مدل باشید. کد شما بدون برخورد با خطاهای 429 ناگهانی به کار خود ادامه می‌دهد. سیستم اعتبار پیش‌پرداخت تضمین می‌کند که شما فقط بابت آنچه استفاده می‌کنید پرداخت می‌کنید.
دسترسی مدل: مدل‌های ابلیتریت شده
OpenRouter طیف گسترده‌ای از مدل‌ها را از ارائه‌دهندگان مختلف ارائه می‌دهد. کاربران می‌توانند از Llama، Mistral و سایر معماری‌های محبوب انتخاب کنند. برخی از مدل‌ها برای محدودیت کمتر اصلاح شده‌اند. این‌ها اغلب به عنوان مدل‌های حذف‌سانسور (abliterated) شناخته می‌شوند. آن‌ها رد شدن‌های رایج را حذف می‌کنند در حالی که هوش عمومی را حفظ می‌کنند.
ما روی یک مدل خاص بدون سانسور تمرکز می‌کنیم. شناسه مدل 'uncensored' است. این یک مدل وزن‌باز است که روی سرورهای اختصاصی ما اجرا می‌شود. برای پاسخ دادن بدون رد محتوای بزرگسالان قانونی تنظیم شده است. این GPT، Claude، Gemini، Grok، DeepSeek، Qwen، Llama یا هیچ مدل دیگری از سایر فروشندگان نیست.
این مدل از طریق SSE از استریم پشتیبانی می‌کند. می‌توانید از فراخوانی تابع با ابزارها استفاده کنید. حالت JSON با response_format json_object در دسترس است. پارامترهایی مانند temperature, top_p, stop, seed, presence_penalty و frequency_penalty به طور کامل پشتیبانی می‌شوند. این به شما کنترل دقیقی بر فرآیند تولید می‌دهد.
محدودیت‌های نرخ و همزمانی
محدودیت‌های نرخ تعیین می‌کنند که چند درخواست در یک بازه زمانی مشخص می‌توانید ارسال کنید. سطح رایگان OpenRouter برخی مدل‌ها را به ۵۰ درخواست در روز محدود می‌کند. این یک سقف سخت است که روزانه بازنشانی می‌شود. اگر تمام شود، باید منتظر بمانید.
API ما اجازه ۳۰۰ درخواست در دقیقه را می‌دهد. این یک پنجره لغزنده است. به صورت پیوسته بازنشانی می‌شود. می‌توانید ۳۰۰ درخواست در یک دقیقه ارسال کنید، سپس یک دقیقه صبر کنید و ۳۰۰ درخواست دیگر ارسال کنید. این بسیار انعطاف‌پذیرتر از سقف روزانه است.
همزمانی به 8 درخواست در یک زمان برای هر کلید محدود می‌شود. این موضوع از غرق شدن سرور توسط یک کلاینت خاص جلوگیری می‌کند. اگر به همزمانی بیشتری نیاز دارید، می‌توانید کلیدهای بیشتری تولید کنید. هر حساب کاربری از یک کلید فعال پشتیبانی می‌کند. یک کلید جدید جایگزین کلید قبلی می‌شود. این طراحی باعث ثبات برنامه شما می‌شود.
لایه‌های قیمت‌گذاری و پاداش‌ها
ما یک سیستم اعتبار پیش‌پرداخت ساده ارائه می‌دهیم. شما فقط با ارز دیجیتال شارژ می‌کنید. USDT روی TRC20 یا USDC روی Base پذیرفته می‌شود. هر مبلغ صحیح بین ۲۰ تا ۵۰۰ دلار مجاز است. هیچ هزینه ماهانه‌ای وجود ندارد. نیازی به اشتراک نیست. اعتبار شما هرگز منقضی نمی‌شود.
اعتبار پاداش به حساب شما اضافه می‌شود. از ۵۰ دلار ۵٪ پاداش دریافت می‌کنید. از ۱۰۰ دلار ۱۰٪ پاداش و از ۲۰۰ دلار ۱۵٪ پاداش دریافت می‌کنید. این پاداش به موجودی پیش‌پرداخت شما اضافه می‌شود. عمر اعتبار شما را افزایش می‌دهد. برای دریافت ارزش بیشتر نیازی به پرداخت بیشتر نیست.
حساب‌های جدید ۰٫۵۰ دلار اعتبار آزمایشی دریافت می‌کنند. این اعتبار ۷ روز اعتبار دارد. یک‌بار مصرف برای هر شخص. با گوگل یا ایمیل و رمز عبور ثبت‌نام کنید. کلید فوراً نمایش داده می‌شود. نیازی به شماره تلفن نیست. خطاهایی مانند شارژ‌های دوبرابر از طریق صفحه پشتیبانی اصلاح می‌شوند. اعتبار مسترد نمی‌شود، اما هرگز منقضی نمی‌شود.
سازگاری SDK
API ما کاملاً با OpenAI سازگار است. می‌توانید از SDKهای رسمی OpenAI استفاده کنید. URL پایه را به HTTPS://api.openrouterlimits.com/v1 تغییر دهید. کلید API را به کلید خود تغییر دهید. بقیه کد شما همان‌طور که هست باقی می‌ماند.
این سازگاری به هر کلاینت سازگار با OpenAI گسترش می‌یابد. می‌توانید از کتابخانه‌هایی مانند LangChain، LlamaIndex یا کلاینت‌های HTTP سفارشی استفاده کنید. نقطه پایانی POST /v1/chat/completions است. همچنین می‌توانید مدل‌ها را با GET /v1/models فهرست کنید. بدون توپولوژی، بدون تولید تصویر، صوت یا ویدیو. بدون fine-tuning. فقط متن ورودی، متن خروجی.
پشتیبانی از استریم از طریق SSE امکان‌پذیر است. استفاده از توکن در قطعه آخر گنجانده شده است. این امکان ردگیری هزینه‌ها را به صورت بلادرنگ فراهم می‌کند. فراخوانی تابع و حالت JSON نیز پشتیبانی می‌شوند. پارامترها با API OpenAI یکسان هستند. این کار مهاجرت را بدون زحمت می‌کند.
سوالات متداول
چگونه با API بدون سانسور شما ادغام کنم؟ SDK مورد علاقه OpenAI خود را نصب کنید. base_url را روی HTTPS://api.openrouterlimits.com/v1 تنظیم کنید. کلید API را روی کلید خود تنظیم کنید. تابع chat.completions.create را با مدل 'uncensored' فراخوانی کنید. بقیه پارامترها استاندارد هستند. استریم، حالت JSON و فراخوانی تابع به صورت مورد انتظار کار می‌کنند. هیچ تغییر کدی فراتر از base URL نیاز نیست.
آیا اعتبار آزمایشی برای تست API کافی است؟ بله، هر حساب‌کاربری جدید $0.50 اعتبار آزمایشی دریافت می‌کند. این اعتبار به مدت 7 days معتبر است. می‌توانید پخش زنده، فراخوانی تابع و حالت JSON را آزمایش کنید. هزینه به اندازه‌ای کم است که سازگاری را تأیید کند. اگر به مقدار بیشتری نیاز دارید، می‌توانید با ارز دیجیتال شارژ کنید. آزمایش برای هر شخص یک بار است.
آیا از مدل‌های Abliterated پشتیبانی می‌کنید؟ ما یک مدل بدون سانسور ارائه می‌دهیم. این مدل برای استفاده بزرگسالان قانونی تنظیم شده است. موضوعات جنجالی را رد نمی‌کند. این مدل متعلق به یک فروشنده خاص نیست. این یک مدل وزن‌باز است که روی سرورهای ما اجرا می‌شود. از تمام پارامترهای استاندارد پشتیبانی می‌کند. می‌توانید دما و top_p را برای کنترل بهتر تنظیم کنید.
اگر از محدودیت نرخ خود فراتر روم چه می‌شود؟ خطای ۴۲۹ دریافت می‌کنید. محدودیت ۳۰۰ درخواست در دقیقه است. همزمانی به ۸ درخواست محدود است. بدنه‌های درخواست به ۸ مگابایت محدود می‌شوند. می‌توانید صبر کنید تا پنجره بازنشانی شود. یا می‌توانید یک کلید جدید تولید کنید. هر حساب از یک کلید فعال پشتیبانی می‌کند. یک کلید جدید جایگزین کلید قبلی می‌شود. این به شما اجازه می‌دهد اگر نیاز است از محدودیت عبور کنید.
