API هوش مصنوعی با پرداخت ریالی؛ راهنمای کامل برای توسعه‌دهنده و کسب‌وکار ایرانی

چند سال است که سؤال تکراری توسعه‌دهنده‌های ایرانی در گروه‌های برنامه‌نویسی یکی است: «کلید API چت‌جی‌پی‌تی را از کجا بگیرم؟» پشت این سؤال ساده، یک زنجیرهٔ خسته‌کننده پنهان است: کارت ارزی، شمارهٔ خارجی، حساب واسطه، ترس از بسته شدن اکانت و در نهایت پرداختی که هر ماه باید دوباره از همان مسیر پرپیچ‌وخم عبور کند. API هوش مصنوعی با پرداخت ریالی دقیقاً برای حذف همین زنجیره ساخته شده است: یک حساب ایرانی، شارژ با تومان و یک کلید که به‌جای یک شرکت، به همهٔ مدل‌های مطرح بازار وصل می‌شود. در این راهنما توضیح می‌دهیم این سرویس چیست، برای چه کسانی ساخته شده، چطور کار می‌کند و کجاها باید حواستان جمع باشد.

API هوش مصنوعی با پرداخت ریالی یعنی چه؟

در حالت عادی برای استفادهٔ برنامه‌نویسی از هر مدل باید با شرکت سازنده‌اش قرارداد ببندید: حساب OpenAI برای GPT، حساب Anthropic برای Claude، حساب Google Cloud برای Gemini و همین‌طور تا آخر. هر کدام پرداخت جداگانه، کلید جداگانه و پنل جداگانه دارند و هیچ‌کدام کارت بانکی ایرانی را قبول نمی‌کنند. API هوش مصنوعی نِت اَرز یک درگاه است که این قراردادها را یک‌جا جمع می‌کند: شما با نِت اَرز به تومان تسویه می‌کنید، نِت اَرز درخواست شما را به ارائه‌دهندهٔ اصلی می‌رساند و پاسخ را عیناً برمی‌گرداند.

نکتهٔ کلیدی این است که این درگاه با استاندارد OpenAI سازگار است. یعنی همان کتابخانه‌های رسمی OpenAI در Python، Node.js، PHP یا هر زبان دیگر بدون تغییر کار می‌کنند؛ فقط دو مقدار عوض می‌شود: آدرس پایه به https://netarz.ir/api/ai/v1 و کلید به کلیدی که با پیشوند sk-ntz-v1- از پنل می‌گیرید. اگر قبلاً کدی برای OpenAI نوشته‌اید، مهاجرت معمولاً کمتر از پنج دقیقه طول می‌کشد.

چه مدل‌هایی پشت این یک کلید هستند؟

فهرست دقیق و همیشه به‌روز در صفحهٔ مدل‌ها است، اما تصویر کلی به این شکل است:

مدل‌های OpenRouter با همان شناسه‌ای که در خود OpenRouter دارند صدا زده می‌شوند، فقط با پیشوند openrouter/؛ مثلاً openrouter/meta-llama/llama-3.3-70b-instruct یا openrouter/anthropic/claude-sonnet-4.5. کلود، گراک، میسترال و Sonar فقط از همین مسیر در دسترس‌اند، پس شناسه‌شان حتماً با openrouter/ شروع می‌شود. مدل‌های رایگان آن مجموعه (با پسوند :free) از این درگاه در دسترس نیستند؛ از ۱۶ شهریور ۱۴۰۵ کنار گذاشته شده‌اند، چون روی ظرفیت مشترک ارائه‌دهنده بودند و وسط کار خطا می‌دادند. دلیل کامل و جایگزین‌هایش در راهنمای مدل رایگان OpenRouter آمده است.

این سرویس برای چه کسانی ساخته شده؟

• توسعه‌دهنده و استارتاپ: کسی که محصول می‌سازد و باید مدل را داخل کد بنشاند؛ از چت‌بات پشتیبانی تا خلاصه‌سازی خودکار و جستجوی معنایی.
• آژانس و فریلنسر: برای هر مشتری یک پروژه و یک کلید جدا می‌سازید و مصرف هر کدام را جداگانه گزارش می‌گیرید؛ بدون اینکه چند حساب خارجی بگردانید.
• تیم مارکتینگ و عملیات: با ابزارهای بدون کد مثل n8n و Make، بدون یک خط برنامه‌نویسی به مدل وصل می‌شوید؛ راهنمایش را در اتصال n8n و Make نوشته‌ایم.
• دانشجو و پژوهشگر: برای پروژهٔ دانشگاهی یا آزمایش چند مدل کنار هم، یک شارژ کوچک روی کم‌هزینه‌ترین مدل‌های فهرست کافی است.
• کاربر حرفه‌ای ابزارها: ادیتورهایی مثل Cursor، Continue یا Open WebUI که کلید و base_url دلخواه می‌پذیرند؛ Cursor شناخته‌شده‌ترین نمونه است.

و یک گروه که این سرویس برایشان مناسب نیست: کسی که فقط می‌خواهد خودش با یک رابط چت گفتگو کند. برای او اشتراک ChatGPT Plus یا Claude Pro هم ارزان‌تر است و هم راحت‌تر؛ فرقش را در تفاوت API و اشتراک با عدد و رقم توضیح داده‌ایم و هر دو اشتراک در دستهٔ اکانت هوش مصنوعی موجود است.

چطور کار می‌کند؛ از شارژ تا اولین پاسخ

1. ورود به پنل: با همان حساب نِت اَرز وارد پنل API می‌شوید؛ حساب جداگانه‌ای لازم نیست.
2. خرید اعتبار: اعتبار به دلار نگه‌داری و به تومان خریده می‌شود. حداقل شارژ ۱۰۰ هزار تومان است و ۹ درصد مالیات بر ارزش افزوده هنگام خرید جداگانه نشان داده و اضافه می‌شود. پرداخت از موجودی کیف پول نِت اَرز یا درگاه زرین‌پال انجام می‌شود؛ اگر کارت‌به‌کارت را ترجیح می‌دهید، اول کیف پول را با ثبت رسید شارژ کنید و بعد از کیف پول بخرید. نرخ تبدیل و مقدار دقیق اعتبار دلاری، پیش از تأیید پرداخت نمایش داده می‌شود.
3. ساخت پروژه و کلید: برای هر محصول یا مشتری یک پروژه بسازید و داخل آن یک یا چند کلید. هر کلید می‌تواند سقف هزینه، فهرست مدل‌های مجاز و فهرست IP مجاز داشته باشد. کلید کامل فقط یک بار نمایش داده می‌شود؛ همان لحظه در جای امنی ذخیره‌اش کنید.
4. اتصال کد: آدرس پایه و کلید را در SDK قرار دهید و اولین درخواست را بفرستید.

from openai import OpenAI

client = OpenAI(
    base_url="https://netarz.ir/api/ai/v1",
    api_key="sk-ntz-v1-...",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[
        {"role": "system", "content": "You are a helpful assistant. Answer in Persian."},
        {"role": "user", "content": "سه ایده برای نام یک کافه در تهران بده."},
    ],
)

print(response.choices[0].message.content)

برای عوض کردن مدل کافی است مقدار model را تغییر دهید: openrouter/anthropic/claude-sonnet-4.5، openrouter/google/gemini-2.5-flash یا deepseek-flash. بقیهٔ کد همان می‌ماند. خروجی استریم (کلمه‌به‌کلمه) هم با پارامتر استاندارد stream=True فعال می‌شود و علاوه بر چت، مسیرهای Embedding، تولید تصویر، تبدیل گفتار به متن و متن به گفتار هم با همان قالب OpenAI در دسترس است. جزئیات هر مسیر در مستندات فنی آمده است.

هزینه چطور حساب می‌شود؟

پرداخت به‌ازای مصرف است، نه ماهانه. هر مدل قیمتی برای هر یک میلیون توکن ورودی و هر یک میلیون توکن خروجی دارد و بعد از هر درخواست، هزینهٔ همان درخواست از اعتبار دلاری کم می‌شود. قیمت‌ها به تومان و دلار در صفحهٔ مدل‌ها لحظه‌ای به‌روز می‌شوند و ما در مقالات عدد ثابتی نمی‌نویسیم، چون هم نرخ ارز و هم قیمت ارائه‌دهنده‌ها تغییر می‌کند. برای اینکه حسی از مقیاس داشته باشید: نرخ رسمی مدل‌های سبک مثل GPT-5 mini در زمان نگارش حدود ۰٫۲۵ دلار برای هر میلیون توکن ورودی است؛ یعنی یک چت‌بات پشتیبانی کوچک با چند هزار گفتگو در ماه، معمولاً با چند دلار اعتبار اداره می‌شود. روش محاسبه را با مثال ریالی در توکن چیست و هزینهٔ API چطور حساب می‌شود قدم‌به‌قدم آورده‌ایم.

دو قاعدهٔ مهم: اول، درخواست ناموفق هزینه ندارد؛ اگر ارائه‌دهنده خطا بدهد یا اتصال قطع شود، چیزی از اعتبار کم نمی‌شود. دوم، هزینهٔ هر درخواست همان لحظه محاسبه می‌شود و در گزارش مصرف به تفکیک روز، پروژه، کلید و مدل قابل مشاهده است؛ بنابراین صورت‌حساب غافلگیرکننده در کار نیست.

کنترل مصرف و امنیت

• پروژه‌ها و کلیدهای متعدد: برای هر محیط (توسعه، تست، عملیاتی) یا هر مشتری یک کلید جدا بسازید تا لو رفتن یک کلید، بقیه را به خطر نیندازد.
• سقف هزینه: برای هر کلید سقف مصرف تعیین کنید و برای هر پروژه بودجهٔ ماهانه. یک حلقهٔ بی‌پایان در کد یا یک کاربر بدجنس نمی‌تواند کل اعتبار را بسوزاند.
• محدودیت IP: کلید عملیاتی را فقط به IP سرور خودتان محدود کنید؛ حتی اگر کلید لو برود، از جای دیگری کار نمی‌کند.
• محدودیت مدل: اگر کلیدی فقط باید با مدل‌های ارزان کار کند، فهرست مدل‌های مجازش را کوتاه کنید تا اشتباه یک همکار، هزینهٔ یک مدل گران را روی دستتان نگذارد.
• حریم خصوصی: متن پرامپت‌ها و پاسخ‌ها در نِت اَرز ذخیره نمی‌شود؛ فقط فراداده‌ای مثل نام مدل، تعداد توکن، وضعیت و زمان پاسخ برای گزارش مصرف نگه داشته می‌شود.

محدودیت‌هایی که باید از قبل بدانید

هیچ سرویسی بی‌قید و شرط نیست و بهتر است این‌ها را پیش از طراحی محصول بدانید. هر حساب سقف تعداد درخواست در دقیقه و تعداد درخواست همزمان دارد که برای بیشتر پروژه‌ها کافی است، اما اگر ترافیک ناگهانی سنگین دارید، پیش از راه‌اندازی با پشتیبانی هماهنگ کنید. مدل رایگان هم نداریم؛ برای بار عملیاتی از همان ابتدا روی یک مدل پولی حساب کنید. حجم هر درخواست محدود است و برای پرونده‌های خیلی بزرگ باید متن را تکه‌تکه بفرستید. و در نهایت، در دسترس بودن هر مدل به ارائه‌دهندهٔ اصلی وابسته است؛ اگر OpenAI یا Google مدلی را بازنشسته کند، از فهرست ما هم حذف می‌شود. برای همین توصیه می‌کنیم نام مدل را در تنظیمات برنامه نگه دارید، نه در دل کد.

مقایسه با راه‌های دیگر

از کجا شروع کنیم؟

اگر کد آماده دارید، همین امروز base_url را عوض کنید و با یک شارژ کوچک تست بگیرید؛ چند دلار اعتبار برای سنجیدن چند مدل روی دادهٔ واقعی خودتان کافی است. اگر هنوز نمی‌دانید کدام مدل برای کارتان مناسب است، مقایسهٔ قیمت API مدل‌ها را بخوانید و بعد قیمت لحظه‌ای را ببینید. راهنماهای تخصصی هر ارائه‌دهنده هم در دانشنامه هست: خرید API چت‌جی‌پی‌تی، API کلود، API جمینای و API دیپ‌سیک. پرداخت ارزی نباید دلیل متوقف ماندن یک محصول خوب باشد؛ حالا دیگر نیست.