iranRouter شما OpenAI Anthropic DeepSeek Meta Grok Gemini request response

API یکپارچه LLM

یک API برای همهٔ مدل‌ها

درخواست‌های شما به‌صورت مداوم وارد IranRouter می‌شوند، به OpenAI، Anthropic، DeepSeek، Meta، Grok و Gemini مسیریابی می‌شوند و پاسخ‌ها مستقیم به شما برمی‌گردند.

قیمت ما همان قیمت خود مدل‌هاست و فقط موقع شارژ حساب ۱٪ کارمزد می‌گیریم.

نحوهٔ اتصال

در سه قدم به IranRouter وصل شوید

همان OpenAI SDK — فقط Base URL و کلید API را عوض کنید. برای Cursor، Claude Code و Antigravity پرامپت آماده کپی کنید.

  1. 1

    ثبت‌نام و کلید API

    ثبت‌نام کنید و از داشبورد یک کلید ir-… بگیرید.

  2. 2

    Base URL را تنظیم کنید

    به‌جای api.openai.com این آدرس را بگذارید:

    https://iranrouter.net/api/v1
  3. 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 اختلاف

پرطرفدار (۷ روز)

رتبه‌بندی کامل ←

مدل‌های موجود

نمونهٔ سریع 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":"سلام"}]}'