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 اصلی و چیزهایی که هنوز نداریم هم در مستندات آمده است تا کسی بر اساس فرض اشتباه خرید نکند.

نمونهٔ اتصال

Python
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 هم می‌توانید بگیریدش.

همین امروز متصل شوید

حساب بسازید، کیف پول را شارژ کنید و اولین درخواست را در چند دقیقه بزنید — بدون قرارداد، بدون کارت ارزی.

ساخت حساب رایگانhttps://iranrouter.com/v1