The OpenRouter API توضیح داده شد

API سازگار با OpenAI چیست؟

یک API REST است که از رابط chat-completions OpenAI پیروی می‌کند. شما پرامپت‌ها را ارسال می‌کنید و خروجی‌های متنی را با استفاده از پیکربندی‌های JSON استاندارد دریافت می‌کنید. این سازگاری به این معنی است که کد کلاینت موجود شما بدون تغییرات عمیمی کار می‌کند.

نقطه پایانی اصلی POST /v1/chat/completions است. این نقطه پایانی پیام‌ها را به صورت آرایه‌ای از اشیاء نقش و محتوا می‌پذیرد. همچنین می‌توانید مدل‌های موجود را از طریق GET /v1/models لیست کنید. این استانداردسازی زمان یکپارچه‌سازی را به طور قابل توجهی کاهش می‌دهد.

سرویس ما دقیقاً همین رابط را ارائه می‌دهد. ما یک مدل بدون سانسور را تحت شناسه "uncensored" سرویس می‌دهیم. این مدل روی سرورهای خود ما اجرا می‌شود. این مدل به سایر فروشندگان مسیریابی نمی‌کند. شما دسترسی مستقیم به مدلی که نیاز دارید، دریافت می‌کنید.

پنجره‌های زمینه در مجموع تا 100,000 توکن را پشتیبانی می‌کنند. محدودیت‌های خروجی 16,000 توکن در هر درخواست است. جریان‌دار کردن از طریق رویدادهای ارسال‌شده توسط سرور (SSE) در دسترس است. فراخوانی تابع و حالت JSON به طور کامل پشتیبانی می‌شوند.

درک URLهای پایه و کلیدهای API

URL پایه به سروری اشاره می‌کند که درخواست‌های شما را مدیریت می‌کند. URL پیش‌فرض OpenAI را با نقطه پایان خاص ما جایگزین کنید. URL پایه ما HTTPS://api.openrouterabliterated.com/v1 است. این تغییر ترافیک را به زیرساخت uncensored ما هدایت می‌کند.

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

محدودیت نرخ‌ها بر اساس کلید اعمال می‌شود. می‌توانید ۳۰۰ درخواست در دقیقه ارسال کنید. تا ۸ درخواست می‌توانند به صورت همزمان اجرا شوند. حجم بدنه درخواست‌ها به ۸ مگابایت محدود است. این محدودیت‌ها برای کاربردهای با حجم بالا به خوبی عمل می‌کنند.

ثبت‌نام تنها نیازمند یک ایمیل یا حساب گوگل است. نیازی به شماره تلفن نیست. کلید بلافاصله ظاهر می‌شود. شما می‌توانید بلافاصله شروع به ارسال درخواست کنید. حریم خصوصی حفظ می‌شود؛ پرامپت‌ها برای آموزش استفاده نمی‌شوند.

چرا یک مدل بدون سانسور برای مورد استفاده خود انتخاب کنیم؟

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

مدل ما برای پاسخ مستقیم تنظیم شده است. محتوای NSFW را بدون مقاومت مدیریت می‌کند. برای فلسفه سیاسی یا ژانرهای خاص خوب کار می‌کند. رفتار ثابتی بدون پرامپت اضافی دریافت می‌کنید.

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

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

قیمت‌گذاری توکن: نحوه محاسبه هزینه‌ها

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

اعتبار پیش‌پرداخت است. شما فقط با ارز دیجیتال شارژ می‌کنید. USDT در TRC20 یا USDC در Base پذیرفته می‌شوند. هر مبلغ صحیح از $20 تا $500 مجاز است. اعتبارها هرگز منقضی نمی‌شوند. این از قفل شدن در اشتراک جلوگیری می‌کند.

اعتبار پاداش روی شارژها موجود است. از ۵۰ دلار ۵٪، از ۱۰۰ دلار ۱۰٪ و از ۲۰۰ دلار ۱۵٪ پاداش دریافت می‌کنید. این موضوع هزینه مؤثر شما را کاهش می‌دهد. خطاها رایگان هستند. رد شدن‌ها رایگان هستند. شما فقط برای توکن‌های موفق پرداخت می‌کنید.

یک حساب آزمایشی $۰.۵۰ اعتبار دریافت می‌کند. این اعتبار به مدت ۷ روز معتبر است. این به شما امکان می‌دهد API را به‌طور کامل آزمایش کنید. می‌توانید یکپارچه‌سازی را قبل از تعهد مالی بررسی کنید.

پاسخ‌های استریم در مقابل غیر استریم

استریمینگ توکن‌ها را همان‌طور که تولید می‌شوند ارسال می‌کند. این تاخیر ادراک‌شده را کاهش می‌دهد. کاربران متن را به صورت بلادرنگ می‌بینند. این برای رابط‌های چت ضروری است. حالت غیر استریمینگ منتظر پاسخ کامل می‌ماند. این می‌تواند برای خروجی‌های طولانی کند به نظر برسد.

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

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

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

فراخوانی تابع و خروجی ساختاریافته

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

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

پارامترهایی مانند دما و top_p رفتار را کنترل می‌کنند. دنباله‌های توقف خروجی را محدود می‌کنند. seedها قابلیت بازتولید را تضمین می‌کنند. جریمه‌ها تکرار را کاهش می‌دهند. شما کنترل دقیقی دارید.

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

کتابخانه‌ها و SDKهای رایج مشتری

اکثر SDKها با تغییرات جزئی کار می‌کنند. شما فقط URL پایه را به‌روز می‌کنید. بقیه کد بدون تغییر باقی می‌ماند. این موضوع شامل Python، Node.js و سایرین می‌شود. یکپارچه‌سازی ساده است.

SDK OpenAI استاندارد است. احراز هویت و تلاش مجدد (retries) را مدیریت می‌کند. کلید API خود را ارسال می‌کنید. URL پایه به سرویس ما اشاره دارد. درخواست‌ها به صورت عادی ارسال می‌شوند.

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

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

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

محدودیت نرخ‌ها خطاهای 429 بازمی‌گردانند. می‌توانید ۳۰۰ درخواست در دقیقه ارسال کنید. عبور از این حد باعث ایجاد انتظار می‌شود. بازگشت نمایی را پیاده‌سازی کنید. این کار از بار بیش از حد سرور جلوگیری می‌کند.

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

خطاهای JSON در حالت JSON رخ می‌دهند. مطمئن شوید طرحواره شما معتبر است. مدل باید JSON معتبر بازگرداند. در صورت شکست، دوباره تلاش کنید. دما را برای پایداری بهتر تنظیم کنید.

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

مراحل بعدی: دریافت اولین کلید API

به صفحه ثبت‌نام بروید. از گوگل یا ایمیل استفاده کنید. شماره تلفن لازم نیست. فرآیند سریع است. دسترسی فوری دریافت می‌کنید.

کلید API شما نمایش داده شده است. آن را به صورت امن کپی کنید. در SDK خود استفاده کنید. URL پایه را به نقطه پایانی ما تنظیم کنید. شروع به ارسال درخواست‌ها کنید.

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

با اعتبار آزمایشی تست کنید. 7 روز دوام می‌آورد. استریمینگ و فراخوانی تابع را بررسی کنید. قابلیت‌های مدل را کاوش کنید. آن را در برنامه خود ادغام کنید. API برای تولید آماده است.