مستندات
مهاجرت از OpenAI
دو مقداری که عوض میشود، و فهرست دقیق تفاوتها با API اصلی OpenAI.
اگر امروز مستقیم با OpenAI کار میکنید، مهاجرت در حد دو خط است. این صفحه دقیقاً میگوید چه چیزی یکسان است و کجا فرق داریم — تا غافلگیر نشوید.
آنچه عوض میشود
diff
- base_url="https://api.openai.com/v1"
+ base_url="https://iranrouter.com/v1"
- api_key="sk-..."
+ api_key="ir-..."همین. بقیهٔ کدتان دستنخورده میماند.
آنچه دقیقاً یکسان است
- شکل درخواست و پاسخ chat completions، با و بدون stream.
- ابزارها، خروجی ساختاریافته، تصویر، و پارامترهای رایج نمونهبرداری.
- شکل پاسخ خطا (`error.type`, `error.message`, `error.code`).
- هدرهای محدودیت نرخ به سبک OpenAI.
تفاوتهای واقعی
| موضوع | OpenAI | IranRouter |
|---|---|---|
| نام مدل | gpt-4o-mini | هم gpt-4o-mini و هم شناسهٔ کامل openai/gpt-4o-mini — مدلها |
| واحد پول | USD | ریال، با نرخ روز ارز |
| پیشپرداخت | کارت اعتباری | کیف پول پیشپرداخت + فاکتور رسمی |
| مدلهای سایر شرکتها | ندارد | همان کلید، همان نشانی — Claude و Gemini و بقیه |
| endpointهای دیگر | embeddings, images, audio, responses | هنوز ارائه نمیشوند |
متغیرهای محیطی
بیشتر ابزارها همین دو متغیر استاندارد را میخوانند، پس اغلب اصلاً لازم نیست کد را دست بزنید:
bash
export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."بعضی کتابخانههای قدیمی بهجای
OPENAI_BASE_URL دنبال OPENAI_API_BASE میگردند. اگر ابزارتان وصل نشد، هر دو را ست کنید.نشانی پایه بدون /v1 هم گاهی لازم میشود: https://iranrouter.com