اولین درخواست با کد

فقط دو مقدار را عوض می‌کنید. آخر این درس یک جواب واقعی گرفته‌اید و آن را در لاگ پنل هم دیده‌اید.

۸ دقیقهدرس ۲ از ۸۰ از ۳ قدم

اگر با API شرکت OpenAI کار کرده باشید، تقریباً همه‌چیز را از قبل بلدید. ایران‌روتر با همان API کار می‌کند، پس فقط دو مقدار را عوض می‌کنید: نشانی و کلید.

Text
base_url: https://iranrouter.com/v1
api_key:  ir-...

هر SDK، کتابخانه یا ابزاری که با OpenAI کار می‌کند، با همین دو مقدار به همهٔ مدل‌ها می‌رسد.

با curl

سریع‌ترین راه امتحان، چون چیزی نصب نمی‌خواهد:

Shell
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

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

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);
شناسهٔ مدل را همیشه کامل بنویسید: سازنده، اسلش، نام. بعضی نام‌های کوتاه هم کار می‌کنند، ولی در کدی که قرار است بماند، شناسهٔ کامل مطمئن‌تر است.

یک درخواست واقعی بفرستید۰ از ۳ قدم

  1. یکی از سه نمونهٔ بالا را با کلید خودتان اجرا کنید.
  2. اگر خطای ۴۰۱ گرفتید، دنبال فاصله یا خط جدید اضافه در کلید بگردید.
  3. اگر خطای ۴۰۲ گرفتید، کیف پول را شارژ کنید یا یک مدل رایگان بردارید.

ببینید درخواست از ایران‌روتر رد شده یا نه

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

بدون باز کردن پنل هم می‌توانید موجودی را بپرسید:

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

اگر ابزارتان فقط متغیر محیطی می‌خواند

بیشتر ابزارها این دو متغیر را می‌شناسند، پس گاهی اصلاً لازم نیست کد را دست بزنید:

Shell
export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."
بعضی کتابخانه‌های قدیمی به جای OPENAI_BASE_URL دنبال OPENAI_API_BASE می‌گردند. اگر وصل نشد، هر دو را تنظیم کنید.

خلاصهٔ درس

  • فقط نشانی و کلید عوض می‌شود.
  • usage.cost_rial مبلغ همان درخواست را می‌گوید.
  • درس بعد یاد می‌گیریم مدل را با حساب و کتاب انتخاب کنیم.
انتخاب مدل مناسب برای هر کارگران‌ترین مدل همیشه بهترین انتخاب نیست؛ گاهی برای همان کار ده برابر پول می‌دهید.تمام کردم، درس بعد