اولین درخواست با کد
فقط دو مقدار را عوض میکنید. آخر این درس یک جواب واقعی گرفتهاید و آن را در لاگ پنل هم دیدهاید.
اگر با API شرکت OpenAI کار کرده باشید، تقریباً همهچیز را از قبل بلدید. ایرانروتر با همان API کار میکند، پس فقط دو مقدار را عوض میکنید: نشانی و کلید.
base_url: https://iranrouter.com/v1 api_key: ir-...
هر SDK، کتابخانه یا ابزاری که با OpenAI کار میکند، با همین دو مقدار به همهٔ مدلها میرسد.
با curl
سریعترین راه امتحان، چون چیزی نصب نمیخواهد:
curl https://iranrouter.com/v1/chat/completions \ -H "Authorization: Bearer ir-..." \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek/deepseek-v4-flash", "messages": [{"role": "user", "content": "سلام! خودت را در یک جمله معرفی کن."}], "max_tokens": 100 }'
در جوابی که میآید، متن پاسخ در choices[0].message.content است. قسمت usage هم تعداد توکنها و cost_rial را دارد که مبلغ نهایی همین درخواست است.
با Python
from openai import OpenAI client = OpenAI( api_key="ir-...", base_url="https://iranrouter.com/v1", ) resp = client.chat.completions.create( model="deepseek/deepseek-v4-flash", messages=[{"role": "user", "content": "سلام!"}], max_tokens=100, ) print(resp.choices[0].message.content)
با Node.js
import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.IRANROUTER_KEY, baseURL: "https://iranrouter.com/v1", }); const resp = await client.chat.completions.create({ model: "deepseek/deepseek-v4-flash", messages: [{ role: "user", content: "سلام!" }], }); console.log(resp.choices[0].message.content);
یک درخواست واقعی بفرستید۰ از ۳ قدم
- یکی از سه نمونهٔ بالا را با کلید خودتان اجرا کنید.
- اگر خطای ۴۰۱ گرفتید، دنبال فاصله یا خط جدید اضافه در کلید بگردید.
- اگر خطای ۴۰۲ گرفتید، کیف پول را شارژ کنید یا یک مدل رایگان بردارید.
ببینید درخواست از ایرانروتر رد شده یا نه
به «مصرف و لاگها» بروید. همان درخواست باید با نام مدل، توکن و هزینه آنجا باشد. اگر نبود، درخواست از اینجا رد نشده و احتمالاً base_url عوض نشده است.
بدون باز کردن پنل هم میتوانید موجودی را بپرسید:
curl https://iranrouter.com/v1/credits -H "Authorization: Bearer ir-..."
اگر ابزارتان فقط متغیر محیطی میخواند
بیشتر ابزارها این دو متغیر را میشناسند، پس گاهی اصلاً لازم نیست کد را دست بزنید:
export OPENAI_BASE_URL="https://iranrouter.com/v1" export OPENAI_API_KEY="ir-..."
OPENAI_BASE_URL دنبال OPENAI_API_BASE میگردند. اگر وصل نشد، هر دو را تنظیم کنید.خلاصهٔ درس
- فقط نشانی و کلید عوض میشود.
usage.cost_rialمبلغ همان درخواست را میگوید.- درس بعد یاد میگیریم مدل را با حساب و کتاب انتخاب کنیم.
وارد شوید تا پیشرفتتان بماند
اگر وارد پنل شوید، مسیرتان و جایی که در هر درس بودید ذخیره میشود و روی هر دستگاهی از همانجا ادامه میدهید.