مستندات
مستندات IranRouter
همهچیز دربارهٔ اتصال به IranRouter — از اولین تماس تا ایجنتهای تولیدی.
IranRouter یک درگاه سازگار با API شرکت OpenAI است. هر SDK، کتابخانه یا ابزاری که با OpenAI کار میکند، با عوض کردن دو مقدار — نشانی سرویس و کلید — به اینجا وصل میشود. لازم نیست چیزی در کد شما بازنویسی شود.
python
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/messages | سازگار با فرمت آنتروپیک |
| ابزارها (function calling) | روی هر دو مسیر |
| تصویر (vision) | روی مدلهایی که پشتیبانی میکنند |
| کش پرامپت | پشتیبانی و جداگانه قیمتگذاری میشود |
GET /v1/models · /v1/key · /v1/credits | پشتیبانی |
چیزهایی که هنوز نداریم
اینها را صریح مینویسیم تا کسی بر اساس فرض اشتباه خرید نکند:
/v1/embeddings,/v1/images,/v1/audio,/v1/responses— هنوز ارائه نمیشوند./v1/messages/count_tokens— پیادهسازی نشده.
اگر به یکی از اینها وابستهاید، پیش از خرید با ما تماس بگیرید — ترجیح میدهیم قبلش بدانید.