باز مسیریاب یکپارچه‌سازی اشتباهاتی که باید از آن‌ها پرهیز کرد

با استفاده از base_url اشتباه

استفاده از URL پایه استاندارد OpenAI باعث شکست درخواست‌ها یا مسیریابی به یک مدل کاملاً متفاوت می‌شود. API ما نیاز دارد که base_url به https://api.whatisopenrouterai.com/v1. این خط واحد پیکربندی تضمین می‌کند که SDK شما به سرورهای ما متصل می‌شود، نه به زیرساخت جهانی OpenAI.

بسیاری از توسعه‌دهندگان کد موجود خود را کپی-پیست می‌کنند بدون اینکه این متغیر را به‌روزرسانی کنند. اگر URL پیش‌فرض را رها کنید، یا خطای 404 دریافت می‌کنید یا به مدلی برخورد می‌کنید که بدون سانسور نیست. همیشه اتصال را با بررسی /v1/models نقطه پایانی. باید شناسه مدل خاص ما را در آنجا مشاهده کنید. این تأیید می‌کند که مسیریابی صحیح است قبل از ارسال اولین درخواست تکمیل.

فراموش کردن تنظیم شناسه مدل

حتی با URL پایه صحیح، حذف شناسه مدل به مدل پیش‌فرض یا قدیمی‌تر منجر می‌شود. شما باید به صراحت model پارامتر روی "uncensored" در هر درخواست. این به لایه مسیریابی ما می‌گوید که مدل وزن‌باز خاصی که برای محتوای بدون محدودیت بهینه‌سازی شده است را ارائه دهد.

بدون این دستور صریح، ممکن است مدل متفاوتی با قوانین هم‌راستایی متفاوت دریافت کنید. برخی از مدل‌ها به طور پیش‌فرض موضوعات بزرگسالان قانونی را رد می‌کنند. با مجبور کردن uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.

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

عبور از پنجره زمینه ۱۰۰,۰۰۰ توکنی یا محدودیت خروجی ۱۶,۰۰۰ توکنی منجر به شکست فوری درخواست می‌شود. API ما حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست را اعمال می‌کند. اگر تنظیم نکنید max_tokens, پیش‌فرض فقط ۲,۰۴۸ توکن است. این اغلب برای وظایف استدلال پیچیده کوتاه است.

خطاها و رد شدن‌ها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند. با این حال، درخواست‌های نامعتبر که به محدودیت نرخ برخورد می‌کنند یا از اندازه بدنه (۸ مگابایت) فراتر می‌روند، همچنان از سهمیه شما کسر می‌شوند. برای استفاده از توکن‌ها به هدرهای پاسخ خود نگاه کنید. مهندسی پرامپت خود را برای تناسب با پنجره زمینه تنظیم کنید. این از تلاش‌های پرهزینه مجدد جلوگیری کرده و جریان داده‌های روان را تضمین می‌کند.

سوءتفاهم در مورد صورتحساب پیش‌پرداخت

موجودی حساب شما به اعتبار پیش‌پرداخت مرتبط است، نه یک اشتراک ماهانه. ما $0.15 به ازای هر 1M توکن ورودی و $0.50 به ازای هر 1M توکن خروجی هزینه دریافت می‌کنیم. خطاها رایگان هستند، اما تکمیل‌های موفق اعتبار مصرف می‌کنند. شما باید برای حفظ دسترسی به سرویس، از طریق ارز دیجیتال شارژ کنید.

ما برای شارژها، USDT (TRC20) یا USDC (Base) می‌پذیریم. حداقل واریز $20 است. پاداش‌ها در سطوح بالاتر اعمال می‌شوند: +5% از $50، +10% از $100 و +15% از $200. اعتبار هرگز منقضی نمی‌شود. قبل از اجرای دسته‌های بزرگ، مطمئن شوید موجودی شما مثبت است. برای بررسی موجودی فعلی و تراکنش‌های اخیر، داشبورد را بررسی کنید.

streaming را با پاسخ‌های استاندارد اشتباه گرفتن

استریمینگ از طریق SSE نحوه پارس کردن استریم پاسخ را تغییر می‌دهد. پاسخ‌های استاندارد یک شیء JSON واحد برمی‌گردانند. استریمینگ چندین قطعه برمی‌گرداند. باید قطعه نهایی را مدیریت کنید تا آمار دقیق مصرف توکن را دریافت کنید.

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

خطاهای پیکربندی tool_choice

نادرست tool_choice تنظیمات می‌توانند باعث شوند فراخوانی تابع به درستی کار نکند. می‌توانید یک ابزار خاص را مجبور کنید یا بگذارید مدل تصمیم بگیرد. پیکربندی نادرست اغلب منجر به نادیده گرفتن توابع موجود توسط مدل می‌شود.

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

حالت json_object از دست رفته

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

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

غافلگیری‌های نرخ محدود

API ما اجازه ۳۰۰ درخواست در دقیقه به ازای هر کلید را می‌دهد. تجاوز از این محدودی منجر به پاسخ 429 Too Many Errors می‌شود. درخواست‌های همزمان به ۸ درخواست به ازای هر کلید محدود است. تنظیمات همزمانی خود را بر این اساس برنامه‌ریزی کنید.

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

تأخیرهای شارژ ارز دیجیتال

تراکنش‌های کریپتو ممکن است زمان‌بر باشند تا در بلاک‌چین تأیید شوند. اعتبار شما ممکن است بلافاصله پس از ارسال وجه ظاهر نشود. از شبکه صحیح استفاده کنید: TRC20 برای USDT یا Base برای USDC. ارسال به شبکه اشتباه باعث از دست رفتن وجه می‌شود.

شارژها بین ۲۰ تا ۵۰۰ دلار هستند. اطمینان حاصل کنید که مبلغ دقیق را ارسال می‌کنید یا هزینه‌های شبکه را در نظر بگیرید. هش تراکنش را در اکسپلورر بلاکچین بررسی کنید. اگر اعتبار با تأخیر واریز شد، با شناسه تراکنش با پشتیبانی تماس بگیرید. بلافاصله فرض نکنید که پرداخت ناموفق بوده است. صبر در زمان ازدحام شبکه کلید عملیات روان است.