API هوش مصنوعی در ایران، با یک خط تغییر در کد
ایرانروتر یک API سازگار با OpenAI SDK است که از داخل ایران کار میکند و با یک کلید به مدلهای سازندههای مختلف میرسد. کد فعلیتان را نگه میدارید و فقط آدرس سرویس و کلید را عوض میکنید.
اتصال از ایران کجا گیر میکند؟
دو مانع اصلی وجود دارد: سرویسهای خارجی درخواستهایی را که از IP ایران میآیند رد میکنند، و پرداخت با کارت ایرانی ممکن نیست. نتیجهاش این است که هر تیمی باید خودش راهی برای سرور واسط و خرید اعتبار پیدا کند. ایرانروتر هر دو را برمیدارد: کلید ir- از داخل ایران کار میکند و هزینهاش به ریال از کیف پول شما کم میشود.
چه چیزی در کد عوض میشود؟
فقط دو مقدار: base_url و api_key. مدل را با شناسهاش انتخاب میکنید، مثل anthropic/claude-sonnet-5 یا google/gemini-3.8-flash، و همین کد برای مدل بعدی هم کار میکند. شناسهٔ دقیق هر مدل در صفحهٔ همان مدل نوشته شده است.
کدام SDK و کدام مسیرها پشتیبانی میشوند؟
- OpenAI SDK در پایتون و Node و هر کتابخانهٔ سازگار: مسیرهای /v1/chat/completions و /v1/responses.
- SDK آنتروپیک با آدرس پایهٔ /anthropic و قالب /v1/messages.
- SDK گوگل با آدرس پایهٔ /genai.
- stream، ابزارها (function calling)، تصویر ورودی روی مدلهایی که پشتیبانی میکنند و کش پرامپت.
- embeddings، تولید تصویر، تبدیل گفتار به متن و متن به گفتار، OCR و rerank.
کلید را کجا نگه دارید؟
کلید ir- اجازهٔ خرج کردن از کیف پول شما را دارد، پس آن را فقط سمت سرور نگه دارید و در کد مرورگر یا اپ موبایل نگذارید. برای هر برنامه یک کلید جدا بسازید تا اگر یکی لو رفت، فقط همان را باطل کنید. مصرف هر کلید در پنل جدا دیده میشود: مدل، تعداد توکن، زمان و هزینهٔ هر درخواست.
برای محیط واقعی
روی هر کلید میتوانید سقف ریالی و سقف توکن بگذارید و درخواستی که از سقف رد شود اصلاً اجرا نمیشود. وضعیت سرویس و سلامت مدلها در صفحهٔ وضعیت بهصورت عمومی منتشر میشود. فهرست دقیق تفاوتها با API اصلی و چیزهایی که هنوز نداریم هم در مستندات آمده است تا کسی بر اساس فرض اشتباه خرید نکند.
نمونهٔ اتصال
from openai import OpenAI client = OpenAI( api_key="ir-...", base_url="https://iranrouter.com/v1", )
پرسشهای پرتکرار
برای صدا زدن API به VPN نیاز دارم؟
نه. نشانی API از داخل ایران در دسترس است و سرور شما بدون VPN به آن وصل میشود.
باید کدم را بازنویسی کنم؟
نه. اگر با OpenAI SDK کار میکنید فقط base_url و کلید عوض میشود. برای SDK آنتروپیک و گوگل هم آدرس پایهٔ جدا داریم.
پاسخها stream میشوند؟
بله. پاسخ توکنبهتوکن و با همان قالب SSE به برنامهٔ شما میرسد.
چطور بفهمم کدام مدلها در دسترساند؟
فهرست زندهٔ مدلها با قیمت ریالی در صفحهٔ مدلها هست و از راه GET /v1/models هم میتوانید بگیریدش.