نِت اَرز · مستندات API هوش مصنوعی
همهٔ مستندات
مدل‌ها و قیمت‌ها مرجع تعاملی دریافت کلید

پرسش‌های متداول

پاسخ کوتاه به پرسش‌های رایج دربارهٔ API هوش مصنوعی نِت اَرز: تغییر کد، مدل‌ها، قیمت و حداقل شارژ، هزینهٔ درخواست ناموفق، محدودیت‌ها و ذخیره‌نشدن پیام‌ها.

base_url: https://netarz.ir/api/ai/v1 به‌روزرسانی: 1405/07/14

نه. رابط نِت اَرز همان رابط OpenAI است. در SDK رسمی OpenAI (یا هر ابزار سازگار) فقط base_url را https://netarz.ir/api/ai/v1 بگذارید و کلید نِت اَرز را جای کلید OpenAI. جزئیات در مهاجرت از OpenAI.

مدل‌های OpenAI (GPT-5، GPT-4.1، GPT-4o و سری o)، Google Gemini و DeepSeek را مستقیم وصل کرده‌ایم. Claude (Opus، Sonnet، Haiku)، Grok، Mistral، Llama، Qwen، Perplexity Sonar و صدها مدل دیگر از راه OpenRouter می‌آیند. فهرست زنده: مدل‌ها و قیمت‌ها.

برای هر یک میلیون توکن ورودی و خروجی (و تصویر، صوت و متن‌به‌گفتار به واحد خودشان)، به دلار و معادل تومانی‌اش با نرخ روز. قیمت‌ها در صفحهٔ مدل‌ها و در GET /models هست. همین قیمت از اعتبارتان کم می‌شود؛ مالیات فقط یک بار، هنگام خرید اعتبار، جدا حساب می‌شود.

۵۰,۰۰۰ تومان، به‌علاوهٔ ۹٪ مالیات بر ارزش افزوده که پیش از پرداخت جدا نشان داده می‌شود. اعتبار به دلار در حساب شما می‌نشیند و تاریخ انقضا ندارد.

چون قیمت همهٔ مدل‌ها دلاری است. اگر اعتبار تومانی بود، با هر افزایش نرخ ارز اعتبار شما عملاً کوچک می‌شد. با اعتبار دلاری، آنچه خریده‌اید ثابت می‌ماند و نرخ فقط در لحظهٔ خرید اعمال می‌شود.

نه. خطای اعتبارسنجی، خطای سرویس‌دهنده، قطعی و timeout هزینه ندارند و مبلغی که موقتاً کنار گذاشته شده، همان لحظه آزاد می‌شود. فقط پاسخ موفق حساب می‌شود.

پیش از هر درخواست، مبلغی برای بدترین حالت (ورودی + بیشترین خروجی ممکن) کنار گذاشته می‌شود. اگر max_tokens نفرستید، ۴٬۰۹۶ توکن خروجی فرض می‌شود که برای مدل‌های گران مبلغ کمی نیست. max_tokens را به اندازهٔ نیازتان بگذارید. بیشتر

بله. با stream: true پاسخ همهٔ مدل‌ها تکه‌به‌تکه و در قالب OpenAI می‌آید؛ Claude و Gemini هم. usage در آخرین رویداد است. استریم

نه. از ۱۶ شهریور ۱۴۰۵ مدل‌های رایگان را برداشتیم، چون روی ظرفیت مشترک سرویس‌دهنده اجرا می‌شدند و در ساعت‌های شلوغ وسط کار خطا می‌دادند. برای آزمایش، اعتبار بخرید (حداقل ۵۰,۰۰۰ تومان) و از ارزان‌ترین مدل‌های فهرست مدل‌ها شروع کنید.

به‌طور پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید و چند درخواست همزمان برای هر حساب. مقدار واقعی حساب خودتان را در GET /me ببینید. اگر بیشتر لازم دارید، با تیکت و شرح کارتان درخواست بدهید. محدودیت‌ها

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

نه. هر کسی که کد را ببیند، می‌تواند با اعتبار شما درخواست بفرستد. همیشه از سرور خودتان به نِت اَرز وصل شوید و کاربرانتان را همان‌جا احراز هویت و محدود کنید.

تا ۵۰ پروژه و در هر پروژه تا ۵۰ کلید. برای هر محیط و هر سرویس کلید جدا بسازید تا مصرف را جدا ببینید و اگر کلیدی لو رفت، فقط همان را باطل کنید.

Realtime بله: گفت‌وگوی صوتی زنده روی WebSocket، سازگار با OpenAI Realtime API (اتصال زنده). Assistants و Fine-tuning فعلاً نه. Chat Completions، Responses (با ابزارهای داخلی)، Completions، Embeddings، Images و Audio را هم داریم. مسیر Moderations هم هست، ولی مدلی برای پایش محتوا وصل نیست و ۴۰۴ برمی‌گرداند. اگر بقیه را لازم دارید، به پشتیبانی بگویید.

فعلاً نه؛ صدور فاکتور رسمی هنوز فعال نشده. مبلغ و مالیات هر شارژ جدا در «تراکنش‌ها»ی پنل ثبت می‌شود. برای خرید سازمانی، فرم خدمات سازمانی را پر کنید.

از پنل کاربری تیکت بزنید و شناسهٔ درخواست (X-Request-Id) و کد خطا را بنویسید؛ اولین پاسخ تیکت حداکثر ظرف ۲۴ ساعت کاری می‌رسد. برای سؤال کوتاه، چت سایت سریع‌تر است. تماس تلفنی نداریم.