IranRouter
فهرست مستندات

مستندات

شروع سریع

اولین پاسخ موفق، در کمتر از پنج دقیقه، با curl یا پایتون یا Node.

۱. کلید بگیرید

  1. با شمارهٔ موبایل ایرانی وارد شوید (ورود با کد پیامکی است؛ کارت خارجی لازم نیست).
  2. در بخش «کلیدها» یک کلید بسازید. کلید با ir- شروع می‌شود.
  3. کیف پول را شارژ کنید، یا از پلن رایگان شروع کنید.
کلید فقط یک بار به‌طور کامل نمایش داده می‌شود. ما فقط اثر انگشتش را نگه می‌داریم و امکان نمایش دوباره وجود ندارد — همان‌جا کپی و ذخیره‌اش کنید.

۲. اولین تماس

cURL

bash
curl https://iranrouter.com/v1/chat/completions \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "سلام! خودت را معرفی کن."}]
  }'

Python

python
from openai import OpenAI

client = OpenAI(
    api_key="ir-...",
    base_url="https://iranrouter.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "سلام! خودت را معرفی کن."}],
)
print(resp.choices[0].message.content)

Node.js

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ir-...",
  baseURL: "https://iranrouter.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "سلام! خودت را معرفی کن." }],
});
console.log(resp.choices[0].message.content);

۳. تأیید کنید که واقعاً از ما رد شد

پس از اولین تماس موفق، در پنل کاربری به «مصرف» بروید. باید همان درخواست را با نام مدل، تعداد توکن و هزینه ببینید. اگر آنجا چیزی نیست، درخواست از IranRouter عبور نکرده و احتمالاً base_url هنوز عوض نشده است.

یا بدون باز کردن پنل:

bash
curl https://iranrouter.com/v1/credits -H "Authorization: Bearer ir-..."

بعدش