اعتبار دلاری، خرید ریالی
حساب API شما یک اعتبار دلاری است. آن را به تومان می‌خرید (از کیف پول نِت اَرز یا درگاه بانکی) و به‌ازای مصرف، به دلار از آن کسر می‌شود. دلاری بودن اعتبار یعنی اعتباری که امروز خریده‌اید با نوسان نرخ ارز کوچک نمی‌شود و قیمت مدل‌ها (که ذاتاً دلاری‌اند) همیشه یکسان است.
- حداقل شارژ: ۵۰,۰۰۰ تومان و حداکثر ۲۰۰,۰۰۰,۰۰۰ تومان در هر نوبت.
- مالیات: ۹٪ مالیات بر ارزش افزوده به مبلغ پایه اضافه و به‌صورت ردیف جداگانه در فاکتور نشان داده می‌شود. اعتبار بر اساس مبلغ پایه (بدون مالیات) محاسبه می‌شود.
- نرخ تبدیل: نرخ روز نِت اَرز در لحظهٔ خرید (اکنون ۲۷۹,۱۰۰ تومان) که پیش از پرداخت به شما نشان داده می‌شود.
- روش پرداخت: کیف پول نِت اَرز (آنی) یا درگاه بانکی زرین‌پال. پس از پرداخت موفق، اعتبار بلافاصله به حساب اضافه می‌شود.
مبلغ پایه: ۱٬۰۰۰٬۰۰۰ تومان
مالیات بر ارزش افزوده: ۹۰٬۰۰۰ تومان (۹٪)
─────────────────────────────────────
قابل پرداخت: ۱٬۰۹۰٬۰۰۰ تومان
اعتبار دریافتی: ≈ $۵٫۰۰ (۱٬۰۰۰٬۰۰۰ ÷ نرخ روز)قیمت یک درخواست چطور محاسبه می‌شود
هر مدل قیمت‌های خودش را دارد (فهرست). هزینهٔ یک درخواست جمع اقلام زیر است، بر اساس مصرف واقعی که ارائه‌دهنده گزارش می‌کند:
| قلم | محاسبه |
|---|---|
| توکن‌های ورودی | تعداد × input_per_million ÷ ۱٬۰۰۰٬۰۰۰ |
| توکن‌های ورودی کش‌شده | تعداد × cached_input_per_million ÷ ۱٬۰۰۰٬۰۰۰ (این توکن‌ها از ورودی معمولی کسر می‌شوند) |
| توکن‌های خروجی | تعداد × output_per_million ÷ ۱٬۰۰۰٬۰۰۰ — توکن‌های استدلال (reasoning) هم خروجی‌اند |
| کانتکست بلند | اگر ورودی از long_context_threshold بیشتر شود، کل درخواست با نرخ‌های *_long حساب می‌شود |
| تصویر | مدل‌های تصویر فعلی (GPT Image و Nano Banana) توکنی‌اند و با ردیف‌های توکن بالا حساب می‌شوند (راهنما). per_image فقط برای مدلی است که به‌ازای هر تصویر قیمت بخورد. |
| صوت | ثانیه ÷ ۶۰ × per_minute |
| متن به گفتار | کاراکتر × per_million_characters ÷ ۱٬۰۰۰٬۰۰۰ برای مدل‌های OpenAI؛ Gemini TTS توکنی است (هر ثانیه گفتار حدود ۲۵ توکن صوتی) |
| ویدیو | ثانیه × per_second × ضریب قاب همان مدل (راهنما) |
| هزینهٔ ثابت | per_request برای مدل‌هایی که دارند (مثلاً هر قطعهٔ موسیقی Lyria یا جستجوی وب Perplexity) و هزینهٔ هر فراخوانی ابزار داخلی در Responses API |
مبلغ نهایی تا یک‌میلیونیم دلار (micro-dollar) به بالا گرد می‌شود.
مثال
مدلی با قیمت فرضی ۰٫۲۵ دلار ورودی، ۰٫۱۲۵ دلار ورودی کش‌شده و ۱ دلار خروجی به‌ازای هر یک میلیون توکن؛ درخواستی با ۱٬۲۰۰ توکن ورودی (۳۰۰ تای آن کش‌شده) و ۴۰۰ توکن خروجی:
- ۹۰۰ × ۰٫۲۵ ÷ ۱M = ۰٫۰۰۰۲۲۵ دلار
- ۳۰۰ × ۰٫۱۲۵ ÷ ۱M = ۰٫۰۰۰۰۳۷۵ دلار
- ۴۰۰ × ۱٫۰۰ ÷ ۱M = ۰٫۰۰۰۴ دلار
- جمع ≈ ۰٫۰۰۰۶۶۳ دلار — با نرخ امروز حدود ۱۸۶ تومان.
رزرو اعتبار پیش از درخواست (hold)
چون هزینهٔ دقیق فقط پس از پاسخ مشخص می‌شود، نِت اَرز پیش از فراخوانی ارائه‌دهنده مبلغی را به‌صورت موقت رزرو می‌کند و پس از پاسخ، دقیقاً مصرف واقعی را تسویه و مابقی را آزاد می‌کند. رزرو از یک برآورد محافظه‌کارانه ساخته می‌شود:
- ورودی: تخمین توکن‌های پیام‌ها/ابزارها (متن فارسی تقریباً هر ۲ کاراکتر یک توکن حساب می‌شود).
- خروجی: مقدار
max_tokens(یاmax_completion_tokens/max_output_tokens) در صورت ارسال (تا سقف ۱۶,۳۸۴)؛ در غیر این صورت کمترینِ حداکثر خروجی مدل و ۴,۰۹۶ توکن. - تصویر/صوت/متن‌به‌گفتار: بر اساس تعداد تصویر، حجم فایل و طول متن.
اگر خروجی کوتاهی می‌خواهید، max_tokens را بفرستید. بدون آن، رزرو با فرض ۴,۰۹۶ توکن خروجی محاسبه می‌شود و برای مدل‌های گران ممکن است با موجودی کم به خطای insufficient_credit بخورید — حتی اگر پاسخ واقعی چند توکن بیشتر نباشد.
اگر موجودی از مبلغ رزرو کمتر باشد، درخواست پیش از رسیدن به ارائه‌دهنده با خطای ۴۰۲ و کد insufficient_credit رد می‌شود (بدون هزینه). مقدار max_tokens روی مبلغ رزرو اثر دارد، اما همیشه فقط مصرف واقعی کسر می‌شود.
درخواست‌های ناموفق رایگان‌اند
اگر ارائه‌دهنده خطا بدهد، در دسترس نباشد یا پاسخ ندهد، مبلغ رزروشده بلافاصله آزاد می‌شود و هیچ هزینه‌ای ثبت نمی‌شود. همین قاعده برای خطاهای اعتبارسنجی پیش از فراخوانی (مدل نامعتبر، JSON خراب و…) هم برقرار است. فقط درخواست‌هایی که ارائه‌دهنده با موفقیت پاسخ داده هزینه دارند — از جمله وقتی خودتان استریم را نیمه‌کاره قطع می‌کنید (آنچه تا آن لحظه تولید شده محاسبه می‌شود).
وقتی ارائه‌دهنده usage گزارش نمی‌کند
برخی مدل‌ها/حالت‌ها (به‌ویژه بعضی استریم‌ها) تعداد توکن را گزارش نمی‌کنند. در این حالت نِت اَرز مصرف را از برآورد ورودی و طول متن خروجی تخمین می‌زند و برای اطمینان ۲۰٪ به آن اضافه می‌کند.
این درخواست‌ها در گزارش با usage_estimated: true مشخص می‌شوند. برای صورت‌حساب دقیق، مدل‌های مستقیم و حالت غیراستریم را ترجیح دهید.
موجودی منفی
چون رزرو یک برآورد است، در موارد نادر (مثلاً پاسخی بسیار بلندتر از برآورد) هزینهٔ واقعی می‌تواند کمی از رزرو بیشتر شود و موجودی حساب اندکی منفی شود. این مبلغ بدهی شماست و از شارژ بعدی کسر می‌شود؛ تا آن زمان درخواست‌های پولی جدید پذیرفته نمی‌شوند.
سقف‌ها و بودجه‌ها
- سقف هزینهٔ کلید: مجموع هزینه‌های یک کلید در کل عمر آن؛ با رسیدن به آن، خطای ۴۰۲
key_spend_limit_reached. - بودجهٔ ماهانهٔ پروژه: مجموع هزینه‌های پروژه در ماه میلادی جاری؛ خطای ۴۰۲
project_budget_exceeded. - سقف روزانهٔ حساب: در صورت تعیین توسط پشتیبانی؛ خطای ۴۰۲
daily_cap_reached.
بررسی این سقف‌ها با مبلغ رزرو انجام می‌شود، بنابراین درخواستی که بودجه را رد می‌کند اصلاً ارسال نمی‌شود.
دیدن مصرف و صورت‌حساب
- پنل کاربری ← API هوش مصنوعی: موجودی، دفتر کل اعتبار (شارژها و کسرها)، مصرف روزانه به تفکیک پروژه/کلید/مدل و فهرست درخواست‌ها (مدل، وضعیت، توکن‌ها، تأخیر).
GET /me: موجودی و محدودیت‌های مؤثر روی کلید.GET /usage: گزارش مصرف پروژه به تفکیک روز یا مدل، با هزینهٔ دلاری.GET /requests/{id}: وضعیت، توکن‌ها و هزینهٔ یک درخواست مشخص.usage.cost: در خود پاسخ هر درخواست (و آخرین رویداد استریم)، مبلغی که برای همان درخواست کم شده است، به دلار.
curl "https://netarz.ir/api/ai/v1/usage?from=2026-08-01&to=2026-08-30&group=model" \
-H "Authorization: Bearer $NETARZ_API_KEY"جزئیات این endpointها در حساب و مصرف.
نِت اَرز متن پیام‌ها و پاسخ‌ها را ذخیره نمی‌کند؛ فقط فراداده (مدل، تعداد توکن، وضعیت، زمان، IP) برای صورت‌حساب و گزارش نگه‌داری می‌شود.