مستندات IranRouter
همه‌چیز دربارهٔ اتصال به IranRouter — از اولین تماس تا ایجنت‌های تولیدی.
IranRouter یک درگاه سازگار با API شرکت OpenAI است. هر SDK، کتابخانه یا ابزاری که با OpenAI کار می‌کند، با عوض کردن دو مقدار — نشانی سرویس و کلید — به اینجا وصل می‌شود. لازم نیست چیزی در کد شما بازنویسی شود.
client = OpenAI(
api_key="ir-...", # ← your IranRouter key
base_url="https://iranrouter.com/v1", # ← instead of api.openai.com
)پرداخت ریالی است، فاکتور رسمی صادر می‌شود و کارت خارجی لازم نیست. صورتحساب بر اساس توکن‌های واقعی مصرف‌شده است، نه اشتراک ماهانه.
از کجا شروع کنم
شروع سریعاولین پاسخ موفق، در کمتر از پنج دقیقه، با curl یا پایتون یا Node.احراز هویت و کلیدهاکلید `ir-`، هدر Authorization، چرخش کلید و اینکه هر کلید چه چیزی را محدود می‌کند.مهاجرت از OpenAIدو مقداری که عوض می‌شود، و فهرست دقیق تفاوت‌ها با API اصلی OpenAI.مدل‌ها و شناسه‌هاشناسهٔ مدل چه شکلی است، چطور فهرست را بگیرید، و چطور مدل درست را انتخاب کنید.قیمت‌گذاری و صورتحسابقیمت ریالی، رزرو پیش از تماس، تسویه پس از پاسخ، پلن در برابر کیف پول.محدودیت‌ها و سقف‌هاسقف نرخ، سقف روزانهٔ کلید، هدرهای پاسخ و اینکه هر سقف کِی بازنشانی می‌شود.
چه چیزی پشتیبانی می‌شود
| قابلیت | وضعیت |
|---|---|
POST /v1/chat/completions | پشتیبانی کامل، با و بدون stream |
POST /v1/responses | رابط Responses اوپن‌ای‌آی، با stream |
POST /v1/videos | ساخت ویدئو — تا پایان کار در همان درخواست |
POST /v1/async/{verb} | دوقلوی async هر مسیر: ۲۰۲ و poll |
WSS /v1/realtime | پروتکل Realtime اوپن‌ای‌آی، هر نشست یک رزرو |
POST /v1/ocr | OCR سند، هر صفحه یک قیمت |
POST /v1/files · /v1/batches | فایل JSONL از درخواست‌ها، اجرا در پس‌زمینه |
POST /v1/messages | سازگار با فرمت آنتروپیک |
| ابزارها (function calling) | روی هر دو مسیر |
| تصویر (vision) | روی مدل‌هایی که پشتیبانی می‌کنند |
| کش پرامپت | پشتیبانی و جداگانه قیمت‌گذاری می‌شود |
GET /v1/models · /v1/key · /v1/credits | پشتیبانی |
POST /v1/embeddings | پشتیبانی، بدون stream |
POST /v1/messages/count_tokens | پشتیبانی — تخمین، رایگان |
POST /v1/rerank · /v1/moderations · /v1/completions | پشتیبانی، بدون stream |
POST /v1/images/generations | پشتیبانی — هزینه به ازای هر تصویر، حداکثر ۱۰ در هر درخواست |
POST /v1/audio/speech | پشتیبانی — پاسخ فایل صوتی است؛ هزینه در هدر x-cost-rial |
POST /v1/audio/transcriptions · /translations | پشتیبانی — multipart، فایل دست‌نخورده ارسال می‌شود |
POST /genai/v1beta/models/… | سازگار با SDK گوگل (google-genai) |
| آدرس پایه به‌ازای هر SDK | همان سرویس زیر چهار پیشوند: /v1 (پیش‌فرض)، /openai، /anthropic و /genai |
SDK خودتان را دست نزنید و فقط آدرس پایه را عوض کنید: /anthropic برای SDK آنتروپیک (خودش /v1/messages را می‌سازد)، /genai برای SDK گوگل، و /openai یا /v1 برای SDK اوپن‌ای‌آی. هر چهار یک موتورند — پیشوند فقط برای این است که مهاجرت یک خط باشد، نه تغییر کد.
چیزهایی که هنوز نداریم
این‌ها را صریح می‌نویسیم تا کسی بر اساس فرض اشتباه خرید نکند:
/v1/batches,/v1/files— ارائه می‌شوند؛ batch تخفیف ندارد و بلافاصله شروع می‌شود./v1/responses— ارائه می‌شود، بدون previous_response_id و بدون ابزارهای داخلی (web_search و …).
اگر به یکی از این‌ها وابسته‌اید، پیش از خرید با ما تماس بگیرید — ترجیح می‌دهیم قبلش بدانید.