مستندات

ایجنت‌ها و ابزارهای آماده

OpenClaw، Hermes، Cursor، Continue، LangChain و هر چیزی که base_url می‌گیرد.

هر ابزاری که base_url و کلید می‌گیرد با IranRouter کار می‌کند — بدون افزونه، بدون آداپتور. این صفحه پیکربندی رایج‌ترین‌ها را می‌دهد.

متغیرهای محیطی (بیشتر ابزارها)

bash

export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."

برای دائمی‌شدن، همین دو خط را در ~/.zshrc یا ~/.bashrc بگذارید. بعضی کتابخانه‌های قدیمی به‌جای OPENAI_BASE_URL دنبال OPENAI_API_BASE می‌گردند؛ اگر وصل نشد هر دو را ست کنید.

OpenClaw

bash

export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."
openclaw

Hermes

yaml

provider:
  type: openai
  base_url: https://iranrouter.com/v1
  api_key: ir-...
  model: anthropic/claude-sonnet-4.5

ابزارهایی که فرمت آنتروپیک دارند

bash

export ANTHROPIC_BASE_URL="https://iranrouter.com/v1"
export ANTHROPIC_API_KEY="ir-..."

جزئیات مسیر /v1/messages ←

LangChain

python

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="openai/gpt-4o-mini",
    api_key="ir-...",
    base_url="https://iranrouter.com/v1",
)

پیش از رهاکردن یک ایجنت

یک ایجنت خودگردان می‌تواند در چند دقیقه صدها درخواست بزند. دو کار پیش از اجرای شبانه:

برای هر ایجنت یک کلید جدا بسازید. اگر لازم شد یکی را ببندید بقیه از کار نمی‌افتند، و در گزارش مصرف می‌دانید کدام ایجنت چقدر خرج کرده.
روی همان کلید سقف روزانه بگذارید. سقف یعنی حتی اگر کد اشتباه کند، خرج از عدد شما بالاتر نمی‌رود.

ایجنت می‌تواند پیش از کار سنگین ظرفیت باقی‌مانده را هم بخواند: GET /v1/key