مستندات
شروع سریع
اولین پاسخ موفق، در کمتر از پنج دقیقه، با curl یا پایتون یا Node.
۱. کلید بگیرید
- با شمارهٔ موبایل ایرانی وارد شوید (ورود با کد پیامکی است؛ کارت خارجی لازم نیست).
- در بخش «کلیدها» یک کلید بسازید. کلید با
ir-شروع میشود. - کیف پول را شارژ کنید، یا از پلن رایگان شروع کنید.
کلید فقط یک بار بهطور کامل نمایش داده میشود. ما فقط اثر انگشتش را نگه میداریم و امکان نمایش دوباره وجود ندارد — همانجا کپی و ذخیرهاش کنید.
۲. اولین تماس
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-..."