یک API سازگار با OpenAI. هر مدل مرزی. ارزان‌تر.

Q: تفاوت بین APIsRouter و OpenRouter چیست؟

OpenRouter pass-through است — حدود ۵٪ حاشیه سود روی قیمتهای upstream اضافه میکند. هر دو API های سازگار با OpenAI ارائه میدهند. مدلهای قیمتگذاری متفاوت. مدلهای جهانی با 20% تخفیف نسبت به قیمت رسمی، مدلهای چینی پایینتر از قیمت رسمی. بدون اشتراک، بر اساس مصرف پرداخت میکنید. اولین شارژ +50% موجودی اضافه میدهد.

Q: آیا middleware سفارشی SDK من خراب میشود؟

نباید — middleware روی معناشناسی درخواست/پاسخ عمل میکند که ما آن را دقیقاً حفظ میکنیم. اگر تفاوت رفتاری میبینید، یک issue ثبت کنید و ما با upstream مطابقت میدهیم.

Q: سربار proxy چقدر سریع است؟

APIsRouter معمولاً حدود ۳۰ تا ۸۰ میلیثانیه تأخیر مسیردهی به ازای هر درخواست اضافه میکند (بسته به منطقه شما در مقابل edge ما). برای streaming، time-to-first-token نزدیک به upstream را دنبال میکند. ما mid-stream را buffer یا تبدیل نمیکنیم.

Updated 2026-07-15

APIsRouter یک endpoint /v1 واحد ارائه می‌دهد که به OpenAI SDK روان صحبت می‌کند — همان بدنه درخواست، همان شکل پاسخ، همان فرمت tool-call — برای Claude، GPT، Gemini، DeepSeek و بیش از ۲۰ مدل دیگر.

"سازگار با OpenAI" در vendor های مختلف معنای متفاوتی دارد.

احتمالاً چند API "سازگار با OpenAI" را امتحان کرده‌اید و دریافته‌اید که فقط در نام سازگار هستند. برخی فرمت را می‌پذیرند اما فقط یک مدل برمی‌گردانند. برخی از tool call ها پشتیبانی نمی‌کنند. برخی وقتی context از ۱۰۰ هزار token بیشتر می‌شود هنگام streaming خراب می‌شوند. برخی یک پیشوند نام مدل خاص می‌طلبند که پیکربندی SDK موجود شما را خراب می‌کند. APIsRouter برای اینکه یک جایگزین مستقیم واقعی باشد ساخته شده است. OpenAI Python SDK بدون تغییر کار می‌کند. Anthropic SDK در مقابل /v1/messages کار می‌کند. Streaming، tool call ها، vision، JSON mode، structured output ها — همه به طور یکسان با مستقیم کار می‌کنند. دقیقاً یک خط تغییر می‌دهید — base_url — و ارسال می‌کنید.

همان SDK، همان کد، هاست متفاوت.

OpenAI Python (رایج‌ترین مسیر):

from openai import OpenAI

client = OpenAI(
    api_key="sk-APIsRouter-...",
    base_url="https://api.apisrouter.com/v1",  # <-- تنها تغییر
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
    tools=[...],  # فرمت استاندارد ابزار کار می‌کند
)

چه چیزی پشتیبانی می‌شود (و چه چیزی هنوز نه).

از SDK رسمی Anthropic با base_url ما استفاده کنید و مدل‌های Claude به صورت بومی کار می‌کنند. از SDK رسمی OpenAI استفاده کنید و مدل‌های GPT به صورت بومی کار می‌کنند. آن‌ها را در یک پروژه ترکیب کنید — همان کلید، هر دو SDK، بدون تغییر context.

به طور یکسان کار می‌کند: /v1/chat/completions (فرمت OpenAI)، /v1/messages (فرمت Anthropic)، /v1/images/generations، /v1/embeddings.
فراخوانی ابزار / تابع — هم فرمت OpenAI و هم Anthropic.
Streaming (SSE)، Vision / multimodal، JSON mode + structured output ها.
prompt caching از Anthropic (cache_control header ها).
نقشه راه (Q3 2026): /v1/audio/* (TTS / Whisper). هنوز نه: Fine-tuning API ها، Assistants API.

وقتی "یک کلید سازگار با OpenAI" واقعاً اهمیت دارد.

زنجیره‌های agent چند مدلی — GPT برای برنامه‌ریزی، Claude Opus برای استدلال، Gemini برای vision. یک کلید، سه مدل، یک صورت‌حساب.
codebase های agnostic نسبت به provider — بر اساس OpenAI SDK بسازید، با تغییر رشته `model` مدل‌ها را تعویض کنید.
مهاجرت مستقیم — ماه‌ها پیش بر اساس OpenAI نوشته‌اید؟ نیازی به refactor ندارید. base_url را به APIsRouter هدایت کنید، `claude-sonnet-4-6` را به عنوان نام مدل استفاده کنید.
fallback هزینه‌آگاه — کارهای premium ← Claude Opus. کارهای کم‌اهمیت ← Haiku یا DeepSeek V4. همه از همان client.
agent های محلی + ابری یک سطح صورت‌حساب مشترک دارند — Codex CLI، Hermes، OpenClaw — همه از طریق یک کلید.

پرسش‌های پرتکرار

تفاوت بین APIsRouter و OpenRouter چیست؟

OpenRouter pass-through است — حدود ۵٪ حاشیه سود روی قیمت‌های upstream اضافه می‌کند. هر دو API های سازگار با OpenAI ارائه می‌دهند. مدل‌های قیمت‌گذاری متفاوت. مدل‌های جهانی با 20% تخفیف نسبت به قیمت رسمی، مدل‌های چینی پایین‌تر از قیمت رسمی. بدون اشتراک، بر اساس مصرف پرداخت می‌کنید. اولین شارژ +50% موجودی اضافه می‌دهد.

آیا شکل پاسخ دقیقاً یکسان با OpenAI است؟

بله — id، آرایه choices، شیء usage، همه فیلدها موجود و با نوع صحیح هستند. ما مشخصه OpenAI را دقیقاً پیاده‌سازی می‌کنیم. همین برای /v1/messages که با مشخصه Anthropic مطابقت دارد صدق می‌کند.

چطور با تداخل نام مدل (مثلاً gpt-5.5 در مقابل claude-sonnet) کنار می‌آیید؟

قرارداد استاندارد — هر مدل یک ID کانونی دارد. برای نگاشت کامل به صفحه /models ما مراجعه کنید. ما alias یا تغییر نام نمی‌دهیم — آنچه ارسال می‌کنید همان چیزی است که به آن مسیردهی می‌کنیم.

آیا middleware سفارشی SDK من خراب می‌شود؟

نباید — middleware روی معناشناسی درخواست/پاسخ عمل می‌کند که ما آن را دقیقاً حفظ می‌کنیم. اگر تفاوت رفتاری می‌بینید، یک issue ثبت کنید و ما با upstream مطابقت می‌دهیم.

سربار proxy چقدر سریع است؟

APIsRouter معمولاً حدود ۳۰ تا ۸۰ میلی‌ثانیه تأخیر مسیردهی به ازای هر درخواست اضافه می‌کند (بسته به منطقه شما در مقابل edge ما). برای streaming، time-to-first-token نزدیک به upstream را دنبال می‌کند. ما mid-stream را buffer یا تبدیل نمی‌کنیم.

آیا می‌توانم self-host کنم یا یک instance خصوصی اجرا کنم؟

در حال حاضر نه — APIsRouter یک اگریگیتور hosted است. برای self-hosted، به LiteLLM یا one-api (open source) نگاه کنید. آن‌ها کانال‌های تخفیف ندارند اما اجرایشان رایگان است.