مستندات
مدلها و شناسهها
شناسهٔ مدل چه شکلی است، چطور فهرست را بگیرید، و چطور مدل درست را انتخاب کنید.
شکل شناسهٔ مدل
شناسهٔ کامل هر مدل به شکل «سازنده/نام» است — همان قراردادی که کاتالوگ ما با آن همگام میشود:
openai/gpt-4o-mini
anthropic/claude-sonnet-4.5
google/gemini-2.0-flashنامهای کوتاه هم پذیرفته میشوند اگر اپراتور برایشان نام مستعار تعریف کرده باشد. اگر بین یک نام مستعار و شناسهٔ کامل یک مدل دیگر تداخل باشد، همیشه شناسهٔ کامل برنده است — پس یک نام هرگز بین دو درخواست به دو مدل متفاوت اشاره نمیکند.
گرفتن فهرست
فهرست همیشه محدود است به چیزی که همان کلید واقعاً میتواند صدا بزند — پس آنچه میبینید و آنچه کار میکند هرگز با هم فرق نمیکنند.
curl https://iranrouter.com/v1/models -H "Authorization: Bearer ir-..."هر ردیف یک فیلد billed_from دارد: «plan» یعنی از سهمیهٔ پلن کم میشود و «credit» یعنی از کیف پول.
کاتالوگ عمومی با قیمت ریالی هم در صفحهٔ مدلها هست و برای هر مدل یک صفحهٔ اختصاصی دارد.
انتخاب مدل
- کارهای ساده (طبقهبندی، استخراج، تشخیص زبان) را به مدل کوچک بدهید. تفاوت قیمت بین ردهٔ کوچک و بزرگ اغلب یک مرتبهٔ بزرگی است.
- متن فارسی به توکنهای بیشتری شکسته میشود تا همان متن به انگلیسی، پس اثر انتخاب مدل برای شما بزرگتر از یک تیم انگلیسیزبان است.
- برای مقایسه، برای هر مدل یک کلید جدا بسازید و همان نمونهها را از هر دو بگذرانید — گزارش مصرف هزینهٔ هرکدام را جدا نشان میدهد.
دسترسی به مدلهای خارج از پلن
اگر پلن شما فقط چند مدل را شامل میشود و میخواهید یک مدل قویتر را امتحان کنید، لازم نیست پلن را عوض کنید و آنچه پرداختهاید را از دست بدهید. کافی است یک کلید بسازید و منبع پرداختش را «اعتباری» بگذارید: آن کلید به همهٔ مدلهای فعال دسترسی دارد و هزینهاش از کیف پول کم میشود، در حالی که سهمیهٔ پلن دستنخورده میماند.