fa ▾

API OpenRouter: افسانه‌ها در برابر واقعیت‌ها

معماری پراکسی OpenRouter محدودیت‌های نرخ غیرقابل پیش‌بینی را معرفی می‌کند که کارهای خودکار را مختل می‌کند و توسعه‌دهندگان را مجبور می‌کند بین سطوح پرداختی گران‌قیمت یا سطوح رایگان غیرقابل اعتماد انتخاب کنند. این راهنما توضیح می‌دهد که میزبانی مستقیم چگونه این گلوگاه‌های بالادستی را حذف می‌کند و در عین حال یک API سازگار با OpenAI برای استفاده از مدل بدون سانسور را فراهم می‌کند.

آخرین به‌روزرسانی

خلاصه

  1. مسیریابی مبتنی بر پروکسی باعث خطاهای تصادفی محدودیت نرخ می‌شود، صرف‌نظر از سطح اشتراک شما.
  2. میزبانی مستقیم از طریق ثابت را با حذف وابستگی‌های شخص ثالث تضمین می‌کند.
  3. اعتبارات پیش‌پرداخت هرگز منقضی نمی‌شوند و اصطکاک اشتراک ماهانه را برای اسکریپت‌های بلندمدت حذف می‌کنند.
  4. API دارای پنجره زمینه 100k و سازگاری کامل با SDK OpenAI برای یکپارچه‌سازی آسان است.

افسانه: برای مدل‌های بدون سانسور به پروکسی نیاز دارید

برای دسترسی به مدل‌های زبانی بزرگ uncensored نیازی به خدمات پروکسی نیست. بسیاری از توسعه‌دهندگان فرض می‌کنند که باید ترافیک را از طریق OpenRouter مسیریابی کنند تا به نسخه‌های خاص uncensored دسترسی پیدا کنند، اما این لایه اضافی انتزاعی غیرضروری ایجاد می‌کند. یک پروکسی بین کد شما و ارائه‌دهنده مدل قرار می‌گیرد و تأخیر و یک نقطه شکست واحد ایجاد می‌کند. وقتی پروکسی تحت بار زیاد قرار می‌گیرد، درخواست‌های شما صف‌بندی شده یا با خطای 429 شکست می‌خورند. میزبانی مستقیم این واسطه را کاملاً دور می‌زند. شما مستقیماً به سرور استنتاج متصل می‌شوید. این کار تأخیر را به طور قابل توجهی کاهش می‌دهد. همچنین محدودیت‌های نرخ پروکسی را از معادله حذف می‌کند. اسکریپت‌های شما مستقیماً زیرساخت مدل را فراخوانی می‌کنند. نتیجه این است که زمان‌بندی قابل‌پیش‌بینی‌تر و وقفه‌های غیرمنتظره کمتر در وظایف تولید حیاتی رخ می‌دهد.

واقعیت: میزبانی مستقیم محدودیت‌های نرخ واسط را حذف می‌کند

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

افسانه: درخواست‌های نامحدود رایگان هستند

پلن‌های رایگان تقریباً همیشه دارای محدودیت‌های پنهان نرخ هستند که اتوماسیون را مختل می‌کنند. پلن رایگان OpenRouter محدودیت‌های سخت‌گیرانه‌ای را که بسته به مدل و زمان روز متغیر است، اعمال می‌کند. این محدودیت‌ها به وضوح در مستندات API ذکر نشده‌اند. کاربران اغلب بدون اینکه بدانند چرا درخواست‌هایشان ناموفق است، به این محدودیت‌ها برخورد می‌کنند. پروکسی محدودیت‌های اضافی خود را به محدودیت‌های ارائه‌دهنده مدل اضافه می‌کند. این لایه‌بندی دوگانه تضمین پایداری سرویس را تقریباً غیرممکن می‌سازد. APIهای مستقیم معمولاً محدودیت‌های قابل پیش‌بینی بر اساس موجودی اعتبار شما ارائه می‌دهند. شما بابت آنچه استفاده می‌کنید پرداخت می‌کنید و نگران سقف‌های سلیقه‌ای نیستید. این شفافیت به توسعه‌دهندگان اجازه می‌دهد هزینه دقیق هر درخواست را محاسبه کنند. همچنین از اختلالات ناگهانی سرویس در عملیات حیاتی جلوگیری می‌کند.

واقعیت: اعتبارات پیش‌پرداخت از صورت‌حساب‌های غیرمنتظره جلوگیری می‌کنند

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

چرا مدل‌های «Unhinged» به زیرساخت پایدار نیاز دارند

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

مقایسه محدودیت‌های OpenRouter با API مستقیم ما

ویژگیپروکسی OpenRouterAPI مستقیم ما
محدودیت‌های نرخمتغیر، وابسته به بالا‌دستزیرساخت اختصاصی و پیش‌بینی‌پذیر
پنجره زمینهمتغیر بر اساس مدل۱۰۰,۰۰۰ توکن
مدل قیمت‌گذاریبه ازای هر توکن + حاشیه سود پروکسی۰.۱۵M ورودی، ۰.۵۰M خروجی
انقضای اعتبارمعمولاً ماهانههرگز منقضی نمی‌شود

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

حقیقت درباره دسترسی به مدل‌های 'Abliterated'

مدل‌های ابلیتراتد اغلب تحت تأثیر تغییرات ناگهانی در دسترس‌بودن روی سرویس‌های پروکسی قرار دارند. وقتی چندین پروکسی برای یک نمونه مدل خاص رقابت می‌کنند، دسترس‌پذیری غیرقابل پیش‌بینی می‌شود. ممکن است مدلی را ساعت ۲ صبح در دسترس پیدا کنید، اما ساعت ۲ بعدازظهر محدود به نرخ (Rate-limited) شوید. این نوسانات بر سیستم‌های خودکاری که به دسترسی پایدار تکیه دارند تأثیر می‌گذارد. میزبانی مستقیم تضمین می‌کند که مدل همیشه روی اندپوینت اختصاصی شما در دسترس باشد. شما به سهمیه پروکسی برای آن مدل خاص وابسته نیستید. این قابلیت اطمینان برای برنامه‌هایی که به uptime ۲۴/۷ نیاز دارند حیاتی است. مدل صرف‌نظر از ترافیک پروکسی‌های خارجی در دسترس باقی می‌ماند. این ثبات به توسعه‌دهندگان اجازه می‌دهد تا برنامه‌های مستحکمی بسازند بدون اینکه نگران افزایش ناگهانی در دسترس‌بودن مدل باشند.

خطاهای رایج OpenRouter توضیح داده شده

خطای 429 Too Many Requests رایج‌ترین خطا در سرویس‌های پروکسی است. زمانی رخ می‌دهد که محدودیت بالادستی پروکسی به دست آید. این محدودیت اغلب کمتر از محدودیت واقعی ارائه‌دهنده مدل است. خطاهای دیگر شامل 502 Bad Gateway است که زمانی رخ می‌دهد که پروکسی نمی‌تواند به مدل متصل شود. 504 Gateway Timeout زمانی رخ می‌دهد که پروکسی برای دریافت پاسخ بیش از حد انتظار می‌کشد. این خطاها اغلب مرتبط با محدودیت‌های مصرف خود شما نیستند. آن‌ها سلامت داخلی پروکسی را منعکس می‌کنند. میزبانی مستقیم این خطاهای خاص پروکسی را حذف می‌کند. شما فقط با خطاهای مرتبط با محدودیت‌های حساب خود یا درخواست‌های نامعتبر مواجه می‌شوید. این عیب‌یابی را به طور قابل توجهی ساده‌تر می‌کند. شما دقیقاً می‌دانید کجا شکست رخ داده است.

هنگام تغییر از OpenRouter به یک API اختصاصی

تغییر زمانی مفید است که به پهنای باند پایدار برای اسکریپت‌های خودکار نیاز دارید. اگر ۵۰,۰۰۰ استخراج سند را اجرا می‌کنید، محدودیت‌های نرخ پراکسی سرعت شما را کاهش می‌دهند. APIهای مستقیم محدودیت‌های همزمانی بالاتری ارائه می‌دهند. API ما اجازه ۳۰۰ درخواست در دقیقه به ازای هر کلید را می‌دهد. این مقدار برای بیشتر وظایف خودکارسازی کافی است. تغییر همچنین زمانی عاقلانه است که از اشتراک‌های ماهانه خوشتان نمی‌آید. اعتبارات پیش‌پرداخت انعطاف‌پذیری ارائه می‌دهند. می‌توانید هر زمان API را بدون جریمه متوقف کنید. انتقال آسان است زیرا API سازگار با OpenAI است. تنها نیاز است URL پایه و کلید API را تغییر دهید. کد موجود شما بدون تغییر کار می‌کند. این زمان و ریسک توسعه را به حداقل می‌رساند.

سوالات متداول

چگونه بفهمم آیا OpenRouter مرا محدود به نرخ کرده است؟

در ساعات اوج، خطاهای HTTP 429 دریافت می‌کنید یا تأخیر قابل توجهی تجربه می‌کنید. سرویس‌های پروکسی اغلب محدودیت‌هایی را اعمال می‌کنند که کمتر از محدودیت‌های ارائه‌دهنده مدل زیرین است. برای مقادیر retry-after به هدرهای پاسخ خود نگاه کنید یا لاگ‌های خطای خود را برای افزایش ناگهانی کدهای وضعیت 429 نظارت کنید.

آیا مدل بدون سانسور در این API همانند OpenRouter است؟

بله، همان مدل با وزن باز است، اما مستقیماً روی سرورهای ما میزبانی می‌شود. این لایه پراکسی که باعث محدودیت نرخ در OpenRouter می‌شود را حذف می‌کند. شما همان رفتار مدل را با زیرساخت پایدارتر و ظرفیت عبوری قابل پیش‌بینی دریافت می‌کنید.

آیا می‌توانم از کد کلاینت موجود OpenRouter خود با این API استفاده کنم؟

بله، زیرا این API سازگار با OpenAI است. شما فقط نیاز دارید URL پایه خود را به HTTPS://api.openrouterratelimit.com/v1 به‌روزرسانی کنید و از کلید API جدید خود استفاده کنید. تمام پارامترهای استاندارد مانند temperature، top_p و streaming دقیقاً همان‌طور که با OpenAI یا OpenRouter کار می‌کنند، کار می‌کنند.

آیا اعتبارات اگر استفاده از API را متوقف کنم منقضی می‌شوند؟

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

کلید API خود را در یک مرحله دریافت کنید

ثبت‌نام، کلید را کپی کنید، آدرس پایه را به‌روز کنید. این کل پیکربندی است.

همین حالا شروع کنید