API یکپارچه LLM
یک API برای همهٔ مدلها
درخواستهای شما بهصورت مداوم وارد IranRouter میشوند، به OpenAI، Anthropic، DeepSeek، Meta، Grok و Gemini مسیریابی میشوند و پاسخها مستقیم به شما برمیگردند.
قیمت ما همان قیمت خود مدلهاست و فقط موقع شارژ حساب ۱٪ کارمزد میگیریم.
نحوهٔ اتصال
در سه قدم به IranRouter وصل شوید
همان OpenAI SDK — فقط Base URL و کلید API را عوض کنید. برای Cursor، Claude Code و Antigravity پرامپت آماده کپی کنید.
-
1
ثبتنام و کلید API
ثبتنام کنید و از داشبورد یک کلید
ir-…بگیرید. -
2
Base URL را تنظیم کنید
بهجای
api.openai.comاین آدرس را بگذارید:https://iranrouter.net/api/v1 -
3
کد بزنید
همان
chat/completions— مدل را از کاتالوگ انتخاب کنید.
Cursor
برای تنظیم Cursor روی IranRouter — در Settings → Models، OpenAI Base URL را override کنید.
Connect this workspace to IranRouter (OpenAI-compatible LLM gateway). 1. In Cursor Settings → Models, enable "Override OpenAI Base URL". 2. Set Base URL to: https://iranrouter.net/api/v1 3. Set API Key to my IranRouter key (env: IRANROUTER_API_KEY). 4. Add to .env.example and .env: IRANROUTER_API_KEY=ir-your-key-here OPENAI_BASE_URL=https://iranrouter.net/api/v1 5. Keep your existing model names (e.g. deepseek-chat, gpt-4o-mini) — only base URL and API key change. 6. Verify with a quick test request to https://iranrouter.net/api/v1/chat/completions. Docs: https://iranrouter.net/docs
Claude Code
برای پروژهای که با Claude Code میسازید — کلاینت OpenAI را به IranRouter وصل کنید.
Wire this project to use IranRouter as the LLM backend (OpenAI-compatible API). Requirements: - Base URL: https://iranrouter.net/api/v1 - Auth: Authorization: Bearer $IRANROUTER_API_KEY - Models: keep provider-native names (deepseek-chat, gpt-4o-mini); prefixed slugs still work Tasks: 1. Add IRANROUTER_API_KEY to .env and .env.example. 2. Configure the OpenAI client (or fetch) to use base URL https://iranrouter.net/api/v1 instead of api.openai.com. 3. Do not rename models — only swap base URL and API key. 4. Add a small smoke test or script that sends one chat message and prints the reply. 5. Document the setup in README if one exists. IranRouter docs: https://iranrouter.net/docs
Antigravity
برای Google Antigravity — endpoint سفارشی OpenAI را به IranRouter اشاره دهید.
Configure this project to route all LLM calls through IranRouter (OpenAI-compatible gateway). Settings: - API base: https://iranrouter.net/api/v1 - API key env var: IRANROUTER_API_KEY - Example models: deepseek-chat, gpt-4o-mini (keep provider-native names) Please: 1. Add IRANROUTER_API_KEY to environment configuration. 2. Point the OpenAI-compatible client base URL to https://iranrouter.net/api/v1. 3. Keep existing model names; only swap base URL and API key. 4. Run a quick connectivity check (GET https://iranrouter.net/api/v1/models or one chat completion). 5. Keep existing app structure; only change the LLM provider wiring. Reference: https://iranrouter.net/docs
OpenAI SDK
برای هر ابزار یا SDK سازگار با OpenAI — همین تنظیمات کافی است.
Use IranRouter instead of OpenAI directly. IranRouter is a drop-in OpenAI-compatible API.
Configuration:
base_url = "https://iranrouter.net/api/v1"
api_key = process.env.IRANROUTER_API_KEY # Bearer ir-…
Example (Node):
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.IRANROUTER_API_KEY,
baseURL: "https://iranrouter.net/api/v1",
});
const res = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "Hello" }],
});
Example (Python):
from openai import OpenAI
client = OpenAI(
api_key=os.environ["IRANROUTER_API_KEY"],
base_url="https://iranrouter.net/api/v1",
)
List models: GET https://iranrouter.net/api/v1/models
Docs: https://iranrouter.net/docs
کپی نشد — متن را دستی انتخاب کنید.
جزئیات بیشتر در مستندات API · شروع رایگان
شروع همیشه رایگان
۲۰ فراخوانی رایگان روی deepseek-flash و GPT-4o-mini
با ایمیل ثبتنام کنید، کلید API بگیرید و OpenAI SDK را به IranRouter وصل کنید. وقتی سهمیه تمام شود، همان endpoint شما را به شارژ حساب هدایت میکند — کد اپلیکیشن عوض نمیشود.
- • مدلها مثل خود provider:
deepseek-flash،gpt-4o-mini - • یک کلید برای هر ایمیل · ۲۰ درخواست مشترک بین هر دو مدل
- • تمام شد؟ API کد
402وtopup_urlبرمیگرداند
در اپلیکیشن خود بگذارید
curl https://iranrouter.net/api/v1/chat/completions \
-H "Authorization: Bearer $IRANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"messages": [{"role":"user","content":"سلام"}]
}'
# or gpt-4o-mini — same key, same base URL
مدلها
2
ارائهدهندگان فعال
1
درخواست ۲۴ساعته
721
توکن ۲۴ساعته
1,331,591
Fallback ارائهدهنده
اگر اولین upstream خطا بدهد، endpoint بعدی همان مدل بهصورت خودکار امتحان میشود.
سازگار با OpenAI
هر OpenAI SDK را به /api/v1 بزنید و کد فعلی را نگه دارید.
سازمان و اعتبار
کیف پول شخصی، موجودی مشترک سازمان و کلیدهای API با اندازهگیری مصرف.
قیمتگذاری
قیمت IranRouter همان نرخ رسمی مدلهاست — کارمزد ما فقط ۱٪ هنگام شارژ حساب است.
| مدل | ارائهدهنده | IranRouter | اختلاف |
|---|
پرطرفدار (۷ روز)
رتبهبندی کامل ←- 1,728 درخواست
-
2 deepseek5 درخواست
- 2 درخواست
مدلهای موجود
-
deepseek-flashDeepseek
DeepSeek-V4.1-Flash
-
deepseek-v4-proDeepseek
DeepSeek-V4-Pro
نمونهٔ سریع curl
curl https://iranrouter.net/api/v1/chat/completions \
-H "Authorization: Bearer $IRANROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"iranrouter/demo-chat","messages":[{"role":"user","content":"سلام"}]}'